MDM_WindowsLicensing 类

[一些信息与预发布产品相关，在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]

MDM_WindowsLicensing 类专为许可相关管理方案而设计。 目前，范围仅限于 Windows 10 桌面设备和移动设备的版本升级，例如 Windows 10 专业版升级到 Windows 10 企业版。 此外，此 CSP 还提供激活或更改 Windows 10 桌面设备产品密钥的功能。

下面的语法从 MOF 代码简化而来，包含所有继承属性。

语法

[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
  string InstanceID;
  string ParentID;
  sint32 Edition;
  sint32 Status;
  string LicenseKeyType;
};

成员

MDM_WindowsLicensing 类具有以下类型的成员：

• 方法
• 属性

方法

MDM_WindowsLicensing 类具有这些方法。

方法	说明
ChangeProductKeyMethod	为 Windows 10 桌面设备安装产品密钥。 无需重启。
CheckApplicabilityMethod	用于检查输入的产品密钥是否可用于版本升级、激活或更改 Windows 10 桌面设备产品密钥的方法。
UpgradeEditionWithLicenseMethod	为 Windows 10 移动设备的版本升级提供许可证。 注意：此升级过程不需要系统重启。 日期类型为 XML。 支持的操作为 Execute。 重要提示： XML 许可证文件内容必须正确转义（也就是说，它不应只是复制的 XML），否则 Windows 10 移动设备上的版本升级将失败。 有关正确转义 XML 许可证文件的详细信息，请参阅 W3C XML 规范的第 2.4 节。XML 许可证文件是从 Microsoft 批量许可服务中心获取的。 贵组织必须与 Microsoft 签订批量许可合同才能访问门户。 以下是通过 MDM 或预配包使用此节点时的有效版本升级路径： - Windows 10 移动版到 Windows 10 移动企业版
UpgradeEditionWithProductKeyMethod	触发设备获取产品密钥并升级客户端版本。 [！注意] 此升级过程需要系统重启。 支持的操作为 Execute。 当将产品密钥从 MDM 服务器推送到用户的设备时，changepk.exe 使用产品密钥运行。 完成后，会向用户显示一则通知，表明 Windows 10 有新版本可用。 然后，用户可以手动重启系统，或者在两小时后自动重启设备以完成升级。 用户将在自动重启前 10 分钟收到提醒通知。 设备重启后，版本升级过程完成。 用户将收到升级成功通知。 [!Important] 如果另一个策略要求在 changepk.exe 运行时重启系统，则版本升级将失败。 如果在预配包中输入了产品密钥，并且用户开始安装包，则会向用户显示一条通知，告知其系统将重启以完成包安装。 在用户明确同意继续后，包将继续安装，changepk.exe 会使用产品密钥运行。 用户将在自动重启前 30 秒收到提醒通知。 设备重启后，版本升级过程完成。 用户将收到升级成功通知。 此节点还可用于通过输入产品密钥来激活或更改特定版本的 Windows 10 桌面设备上的产品密钥。 激活或更改产品密钥不需要重启，对用户来说是一个静默过程。 [!Important] 输入的产品密钥必须为 29 个字符（即应包括短划线），否则 Windows 10 桌面设备上的激活、版本升级或产品密钥更改将失败。 产品密钥是从 Microsoft 批量许可服务中心获取的。 贵组织必须与 Microsoft 签订批量许可合同才能访问门户。 以下是通过 MDM 使用此节点时的有效版本升级路径： Windows 10 企业版到 Windows 10 教育版 Windows 10 家庭版到 Windows 10 教育版 Windows 10 专业版到 Windows 10 教育版 Windows 10 专业版到 Windows 10 企业版 可以在以下版本中激活或更改产品密钥： Windows 10 教育版 Windows 10 企业版 Windows 10 家庭版 Windows 10 专业版

属性

MDM_WindowsLicensing 类具有以下属性。

版本

数据类型：sint32

访问类型：读/写

InstanceID

数据类型：字符串

访问类型：只读

限定符：key

标识父节点的名称。

LicenseKeyType

数据类型：字符串

访问类型：读/写

ParentID

数据类型：字符串

访问类型：只读

限定符：key

描述父节点的完整路径。 对于此类，字符串为“./Vendor/MSFT/”

状态

数据类型：sint32

访问类型：读/写

要求

要求	值
最低受支持的客户端	Windows 10 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
命名空间	Root\CIMv2\MDM\DMMap
MOF	DMWmiBridgeProv.mof
DLL	DMWmiBridgeProv.dll

另请参阅

将 PowerShell 脚本与 WMI 桥提供程序配合使用