New-CPCProvisioningPolicy
SYNOPSIS
Adds a new Provisioning Policy
SYNTAX
AzureADJoin (Default)
New-CPCProvisioningPolicy -Name <String> [-Description <String>] [-ProvisioningType <String>]
[-NamingTemplate <String>] [-ManagedBy <String>] [-ImageType <String>] -ImageId <String>
-EnableSingleSignOn <Boolean> [-WindowsAutopatch <String>] [-WindowsAutopatchGroupId <String>]
[-UserExperience <String>] [-Language <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
AzureNetwork
New-CPCProvisioningPolicy -Name <String> [-Description <String>] [-ProvisioningType <String>]
[-NamingTemplate <String>] -DomainJoinType <String> -AzureNetworkConnection <Object> [-ManagedBy <String>]
[-ImageType <String>] -ImageId <String> -EnableSingleSignOn <Boolean> [-WindowsAutopatch <String>]
[-WindowsAutopatchGroupId <String>] [-UserExperience <String>] [-Language <String>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
MicrosoftHosted
New-CPCProvisioningPolicy -Name <String> [-Description <String>] [-ProvisioningType <String>]
[-NamingTemplate <String>] -DomainJoinType <String> -RegionName <String> -RegionGroup <String>
[-ManagedBy <String>] [-ImageType <String>] -ImageId <String> -EnableSingleSignOn <Boolean>
[-WindowsAutopatch <String>] [-WindowsAutopatchGroupId <String>] [-UserExperience <String>]
[-Language <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
The function will add a new Provisioning Policy
EXAMPLES
EXAMPLE 1
New-CPCProvisioningPolicy -Name "Test-AzureADJoin" -Description "Test-AzureADJoin" -imageType "Gallery" -ImageId "microsoftwindowsdesktop_windows-ent-cpc_win11-25h2-ent-cpc" -DomainJoinType "AzureADJoin" -EnableSingleSignOn $true -RegionName "westeurope" -RegionGroup "europeUnion" -Language "en-US"
EXAMPLE 2
New-CPCProvisioningPolicy -Name "Test-HybridADJoin" -Description "Test-HybridADJoin" -imageType "Gallery" -ImageId "microsoftwindowsdesktop_windows-ent-cpc_win11-25h2-ent-cpc" -DomainJoinType "hybridAzureADJoin" -EnableSingleSignOn $false -AzureNetworkConnection "Azure Network Connection" -Language "en-US"
EXAMPLE 3
New-CPCProvisioningPolicy -Name "Test-Autopatch" -Description "Test-Autopatch" -imageType "Gallery" -ImageId "microsoftwindowsdesktop_windows-ent-cpc_win11-25h2-ent-cpc" -WindowsAutopatch "starterManaged" -DomainJoinType "AzureADJoin" -RegionName "westeurope" -RegionGroup "europeUnion" -Language "en-US" -EnableSingleSignOn $true
EXAMPLE 4
New-CPCProvisioningPolicy -Name "Test-NamingTemplate" -Description "Test-NamingTemplate" -imageType "Gallery" -ImageId "microsoftwindowsdesktop_windows-ent-cpc_win11-25h2-ent-cpc" -WindowsAutopatch "starterManaged" -DomainJoinType "AzureADJoin" -RegionName "westeurope" -RegionGroup "europeUnion" -Language "en-US" -EnableSingleSignOn $true -NamingTemplate "%USERNAME:5%-%RAND:5%"
EXAMPLE 5
New-CPCProvisioningPolicy -Name "Test-CloudApps" -Description "Test-AzureADJoin" -imageType "Gallery" -ImageId "microsoftwindowsdesktop_windows-ent-cpc_win11-25h2-ent-cpc" -DomainJoinType "AzureADJoin" -EnableSingleSignOn $true -RegionName "northeurope" -RegionGroup "europeUnion" -Language "en-US" -ProvisioningType sharedByEntraGroup -userExperience cloudApp
PARAMETERS
-Name
Enter the name of the Provisioning Policy
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
Enter the description of the Provisioning Policy
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProvisioningType
Enter the Provisioning Type of the Provisioning Policy (dedicated, sharedByUser or sharedByEntraGroup) (Default: dedicated)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Dedicated
Accept pipeline input: False
Accept wildcard characters: False
-NamingTemplate
Apply device name template. Create unique names for your devices. Names must be between 5 and 15 characters, and can contain letters, numbers, hyphens, and underscores. Names cannot include a blank space. Use the %USERNAME:x% macro to add the first x letters of username. Use the %RAND:y% macro to add a random alphanumeric string of length y, y must be 5 or more. Names must contain a randomized string.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DomainJoinType
Enter the Domain Join Type for the Provisioning Policy (AzureADJoin or AzureADDomainJoin) (Default: AzureADJoin)
Type: String
Parameter Sets: AzureNetwork, MicrosoftHosted
Aliases:
Required: True
Position: Named
Default value: AzureADJoin
Accept pipeline input: False
Accept wildcard characters: False
-RegionName
Enter the Region Name for the Provisioning Policy
Type: String
Parameter Sets: MicrosoftHosted
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RegionGroup
Enter the Region Group for the Provisioning Policy
Type: String
Parameter Sets: MicrosoftHosted
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AzureNetworkConnection
Enter the Azure Network Connection Name for the Provisioning Policy
Type: Object
Parameter Sets: AzureNetwork
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManagedBy
Enter the Managed By of the Provisioning Policy (Windows365 or Microsoft) (Default: Windows365)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Windows365
Accept pipeline input: False
Accept wildcard characters: False
-ImageType
Enter the image type of the Provisioning Policy (Custom or Gallery)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Gallery
Accept pipeline input: False
Accept wildcard characters: False
-ImageId
Enter the Image Id of the Provisioning Policy (Info: Get-CPCGalleryImage or Get-CPCCustomImage)
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSingleSignOn
No description available.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WindowsAutopatch
Enter the Windows Autopatch for the Provisioning Policy (notManaged or starterManaged) (Default: notManaged)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: NotManaged
Accept pipeline input: False
Accept wildcard characters: False
-WindowsAutopatchGroupId
Enter the Windows Autopatch Group Id for the Provisioning Policy (Info: Get-CPCWindowsAutopatchGroup)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserExperience
Enter the User Experience for the Provisioning Policy (cloudPc or cloudApp) (Default: cloudPc)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: CloudPc
Accept pipeline input: False
Accept wildcard characters: False
-Language
Enter the Language for the Provisioning Policy (Default: en-US)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: En-US
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.