New-CMWindows11EditionUpgrade
创建 Windows 11 版本升级策略。
语法
New-CMWindows11EditionUpgrade
[-Description <String>]
[-EditionUpgradeWithClient <Boolean>]
[-LicenseFile <String>]
-Name <String>
[-ProductKey <String>]
[-WindowsEdition <WindowsEditionType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
创建 Windows 11 版本升级策略。 指定产品密钥或许可证信息以将 Windows 11 升级到其他版本。 有关详细信息，请参阅 使用 Configuration Manager 将 Windows 设备升级到新版本。
示例
示例 1
New-CMWindows11EditionUpgrade -Name "NewEditionPolicyByKey" -WindowsEdition Windows11Enterprise -ProductKey "123ab-cd456-789ef-2j3k4-0ghi1"参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
为策略指定可选说明。
| 类型: | String |
| 别名: | LocalizedDescription |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EditionUpgradeWithClient
使用此参数指定要创建的版本升级类型：
-
$true：策略适用于使用 Configuration Manager 客户端管理的设备。 使用 ProductKey 参数指定许可证密钥。 -
$false：此策略适用于运行使用本地 MDM 管理的 Windows 11 移动版的设备。 使用 LicenseFile 参数提供 XML 许可证文件。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-LicenseFile
将 EditionUpgradeWithClient 参数设置为 $false时，使用此参数指定 XML 许可证文件的路径。 从 Microsoft 批量许可服务中心获取许可证文件， (VLSC) 。 此文件包含策略针对的所有设备上的新版本 Windows 的许可信息。 下载 适用于 Windows 11 移动企业版的 ISO 文件，其中包含许可 XML。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定此 Windows 11 版本升级策略的名称。
| 类型: | String |
| 别名: | LocalizedDisplayName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ProductKey
将 EditionUpgradeWithClient 参数设置为 $true时，使用此参数为新版本的 Windows 指定有效的产品密钥。 此产品密钥可以是 MAK) (多重激活密钥，也可以是 GVLK) (通用批量许可密钥。 GVLK 也称为密钥管理服务， (KMS) 客户端设置密钥。 有关详细信息，请参阅 规划批量激活。 有关 KMS 客户端设置密钥的列表，请参阅 Windows Server 激活指南的 附录 A 。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WindowsEdition
指定与 LicenseFile 或 ProductKey 对应的 Windows 11 目标版本。
| 类型: | WindowsEditionType |
| 接受的值: | Windows11Enterprise, Windows11Education, Windows11EnterpriseN, Windows11EducationN, WindowsPhone11, HolographicEnterprise |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject