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 桥提供程序配合使用