Edit

New-CMWindows10EditionUpgrade

  • Reference
Module:
ConfigurationManager

Create a Windows 10 edition upgrade policy.

Syntax

New-CMWindows10EditionUpgrade
   [-Description <String>]
   [-EditionUpgradeWithClient <Boolean>]
   [-LicenseFile <String>]
   -Name <String>
   [-ProductKey <String>]
   [-WindowsEdition <WindowsEditionType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a Windows 10 edition upgrade policy. Specify a product key or license information to upgrade Windows 10 to a different edition. For more information, see Upgrade Windows devices to a new edition with Configuration Manager.

Examples

Example 1

New-CMWindows10EditionUpgrade -Name "NewEditionPolicyByKey" -WindowsEdition Windows10Enterprise -ProductKey "123ab-cd456-789ef-2j3k4-0ghi1"

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specify an optional description for the policy.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-EditionUpgradeWithClient

Use this parameter to specify the type of edition upgrade to create:

  • $true: The policy is for devices managed with the Configuration Manager client. Use the ProductKey parameter to specify the license key.
  • $false: This policy is for devices running Windows 10 Mobile that you manage with on-premises MDM. Use the LicenseFile parameter to provide the XML license file.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-LicenseFile

When you set the EditionUpgradeWithClient parameter to $false, use this parameter to specify the path to the XML license file. Get the license file from the Microsoft Volume Licensing Service Center (VLSC). This file contains the licensing information for the new version of Windows on all devices you target with the policy. Download the ISO file for Windows 10 Mobile Enterprise, which includes the licensing XML.

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

-Name

Specify a name for this Windows 10 edition upgrade policy.

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

When you set the EditionUpgradeWithClient parameter to $true, use this parameter to specify a valid product key for the new version of Windows. This product key can be a multiple activation key (MAK), or a generic volume licensing key (GVLK). A GVLK is also referred to as a key management service (KMS) client setup key. For more information, see Plan for volume activation. For a list of KMS client setup keys, see Appendix A of the Windows Server activation guide.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowsEdition

Specify the target edition of Windows 10 that corresponds with the LicenseFile or ProductKey.

Type:WindowsEditionType
Accepted values:Windows10Enterprise, Windows10Education, Windows10EnterpriseN, Windows10EducationN, WindowsPhone10, HolographicEnterprise
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

IResultObject