Skip to main content

Connect-Windows365

SYNOPSIS​

Connect to Windows 365 via Powershell

SYNTAX​

Interactive (Default)​

Connect-Windows365 [-ProgressAction <ActionPreference>] [<CommonParameters>]

ClientCertificate​

Connect-Windows365 -TenantID <String> -ClientID <String> -ClientCertificate <X509Certificate2>
[-ProgressAction <ActionPreference>] [<CommonParameters>]

ClientSecret​

Connect-Windows365 -TenantID <String> -ClientID <String> -ClientSecret <String>
[-ProgressAction <ActionPreference>] [<CommonParameters>]

DeviceCode​

Connect-Windows365 [-DeviceCode] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Token​

Connect-Windows365 -Token <String> [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Connect to Windows 365 via Powershell via Interactive Browser, Device Code, Service Principal or Access Token.

EXAMPLES​

EXAMPLE 1​

Connect-Windows365

EXAMPLE 2​

Connect-Windows365 -DeviceCode

EXAMPLE 3​

Connect-Windows365 -TenantID contoso.onmicrosoft.com -ClientID 12345678-1234-1234-1234-123456789012 -ClientSecret 12345678-1234-1234-1234-123456789012

EXAMPLE 4​

Connect-Windows365 -TenantID contoso.onmicrosoft.com -ClientID 12345678-1234-1234-1234-123456789012 -ClientCertificate (Get-PfxCertificate -FilePath ./app.pfx)

EXAMPLE 5​

Connect-Windows365 -Token "YourAccessToken"

PARAMETERS​

-TenantID​

Tenant ID for all Authentication types

Type: String
Parameter Sets: ClientCertificate, ClientSecret
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClientID​

Client ID for Service Principal Authentication

Type: String
Parameter Sets: ClientCertificate, ClientSecret
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClientSecret​

Client Secret for Service Principal Authentication

Type: String
Parameter Sets: ClientSecret
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClientCertificate​

Client Certificate for Service Principal Authentication. This must be an X509Certificate2 object that includes its private key, not only the thumbprint. The app registration needs the Microsoft Graph application permissions granted with admin consent.

Type: X509Certificate2
Parameter Sets: ClientCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeviceCode​

Use Device Code Authentication (Switch to use Device Code Authentication)

Type: SwitchParameter
Parameter Sets: DeviceCode
Aliases:

Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Token​

Use a Token for Authentication, this must be a valid access token for the Microsoft Graph API with CloudPC permissions

Type: String
Parameter Sets: Token
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

NOTES​