WindowsLicensing 云解决方案提供商

重要提示

此云解决方案提供商包含一些正在开发中的设置，仅适用于 Windows Insider Preview 版本。 这些设置可能会发生更改，并且可能依赖于预览版中的其他功能或服务。

WindowsLicensing 配置服务提供程序专为许可相关管理方案而设计。

以下列表显示了 WindowsLicensing 配置服务提供程序节点：

• ./Vendor/MSFT/WindowsLicensing
  • ChangeProductKey
  • CheckApplicability
  • DeviceLicensingService
    • DeviceLicensingLastError
    • DeviceLicensingLastErrorDescription
    • DeviceLicensingStatus
    • LicenseType
  • 版次
  • LicenseKeyType
  • SMode
    • 状态
    • SwitchFromSMode
    • SwitchingPolicy
  • 状态
  • 订阅
    • {SubscriptionId}
      • 名称
      • 状态
    • DisableSubscription
    • RemoveSubscription
    • SubscriptionLastError
    • SubscriptionLastErrorDescription
    • SubscriptionStatus
    • SubscriptionType
  • UpgradeEditionWithLicense
  • UpgradeEditionWithProductKey

ChangeProductKey

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1703 [10.0.15063] 及更高版本

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

为 Windows 10 桌面设备安装产品密钥。 不重新启动。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	Exec

CheckApplicability

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/CheckApplicability

如果输入的产品密钥可用于 Windows 10 桌面设备的版本升级，则返回 TRUE。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	Exec

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
    <CmdID>$CmdID$</CmdID>
    <Item>
      <Target>
        <LocURI>./Device/Vendor/MSFT/WindowsLicensing/CheckApplicability</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</Data>
    </Item>
   </Exec>
   <Final/>
  </SyncBody>
</SyncML>

注意

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX 应将 替换为产品密钥。

DeviceLicensingService

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 11 版本 21H2，KB5018483 [10.0.22000.1165] 及更高版本 ✅ Windows 11 版本 22H2 [10.0.22621] 及更高版本

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

基于设备的订阅。

描述框架属性:

属性名	属性值
格式	node
访问类型	“获取”

DeviceLicensingService/DeviceLicensingLastError

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 11 版本 21H2，KB5018483 [10.0.22000.1165] 及更高版本 ✅ Windows 11 版本 22H2 [10.0.22621] 及更高版本

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

返回刷新/删除设备许可证操作的最后一个错误代码。 如果没有错误，值将为空 (0) 。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

DeviceLicensingService/DeviceLicensingLastErrorDescription

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 11 版本 21H2，KB5018483 [10.0.22000.1165] 及更高版本 ✅ Windows 11 版本 22H2 [10.0.22621] 及更高版本

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

返回设备许可中的最后一个错误说明。 如果无法计算错误解译，则值将为空。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	“获取”

DeviceLicensingService/DeviceLicensingStatus

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 11 版本 21H2，KB5018483 [10.0.22000.1165] 及更高版本 ✅ Windows 11 版本 22H2 [10.0.22621] 及更高版本

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

返回刷新/删除设备许可证操作的状态。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

DeviceLicensingService/LicenseType

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 11 版本 21H2，KB5018483 [10.0.22000.1165] 及更高版本 ✅ Windows 11 版本 22H2 [10.0.22621] 及更高版本

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

许可证类型：基于用户的订阅或基于设备的订阅。

描述框架属性:

属性名	属性值
格式	int
访问类型	获取、替换

允许的值:

值	说明
0	基于用户的订阅。
1	基于设备的订阅。

版次

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/Edition

返回一个值，该值映射到在桌面或移动设备上运行的 Windows 10 版本。 获取该值，将其转换为其十六进制等效项，并在 MSDN 上的 GetProductInfo 函数页中搜索版本信息。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/Edition</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

LicenseKeyType

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

返回 Windows 10 设备用于版本升级的参数类型。 Windows 10 桌面设备需要产品密钥进行版本升级。 Windows 10 移动设备需要许可证进行版本升级。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	“获取”

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/LicenseKeyType</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

SMode

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1809 [10.0.17763] 及更高版本

./Vendor/MSFT/WindowsLicensing/SMode

用于管理 S 模式的内部节点。

描述框架属性:

属性名	属性值
格式	node
访问类型	“获取”

SMode/Status

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1809 [10.0.17763] 及更高版本

./Vendor/MSFT/WindowsLicensing/SMode/Status

返回最新 SwitchFromSMode 或 SwitchPolicy 集请求的状态。

可能值：

• 请求失败，错误代码为 404：未发出 SwitchFromSMode 请求。
• 0：设备已成功退出 S 模式。
• 1：设备正在处理退出 S 模式的请求。
• 3：设备已退出 S 模式。
• 4：设备无法退出 S 模式。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>6</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/Status
          </LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

SMode/SwitchFromSMode

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1809 [10.0.17763] 及更高版本

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

如果可能，将设备切换出 S 模式。 不重新启动。

描述框架属性:

属性名	属性值
格式	null
访问类型	Exec

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
      <CmdID>5</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">null</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data></Data>
      </Item>
    </Exec>
    <Final/>
  </SyncBody>
</SyncML>

SMode/SwitchingPolicy

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1809 [10.0.17763] 及更高版本

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

用于确定使用者是否可以将设备切换出 S 模式的策略。

此设置仅适用于 S 模式下可用的设备。

描述框架属性:

属性名	属性值
格式	int
访问类型	添加、删除、获取、替换

允许的值:

值	说明
0	无限制：允许用户将设备切换为 S 模式。
1	用户已阻止：管理员已阻止用户将其设备切换出 S 模式。 只有管理员才能通过 SMode/SwitchFromSMode 节点将设备切换出 S 模式。

示例：

• 添加 S 模式切换策略

  <SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
      <Add>
        <CmdID>4</CmdID>
        <Item>
          <Target>
            <LocURI>
              ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
            </LocURI>
          </Target>
          <Meta>
            <Format xmlns="syncml:metinf">int</Format>
            <Type>text/plain</Type>
          </Meta>
          <Data>1</Data>
        </Item>
      </Add>
      <Final/>
    </SyncBody>
  </SyncML>
  

• 获取 S 模式切换策略

  <SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
      <Get>
        <CmdID>2</CmdID>
        <Item>
          <Target>
            <LocURI>
              ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
            </LocURI>
          </Target>
        </Item>
      </Get>
      <Final/>
    </SyncBody>
  </SyncML>
  

• 替换 S 模式 SwitchingPolicy

  <SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
      <Replace>
        <CmdID>1</CmdID>
        <Item>
          <Target>
            <LocURI>
              ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
            </LocURI>
          </Target>
          <Meta>
            <Format xmlns="syncml:metinf">int</Format>
            <Type>text/plain</Type>
          </Meta>
          <Data>1</Data>
        </Item>
      </Replace>
      <Final/>
    </SyncBody>
  </SyncML>
  

• 删除 S 模式 SwitchingPolicy

  <SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
      <Delete>
        <CmdID>3</CmdID>
        <Item>
          <Target>
            <LocURI>
              ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
            </LocURI>
          </Target>
        </Item>
      </Delete>
      <Final/>
    </SyncBody>
  </SyncML>
  

状态

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/Status

返回 Windows 10 桌面版和移动设备上版本升级的状态。 状态：0 = 失败，1 = 挂起，2 = 正在进行，3 = 已完成，4 = 未知。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/Status</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

订阅

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1607 [10.0.14393] 及更高版本

./Vendor/MSFT/WindowsLicensing/Subscriptions

订阅的节点。

描述框架属性:

属性名	属性值
格式	node
访问类型	“获取”

Subscriptions/{SubscriptionId}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1607 [10.0.14393] 及更高版本

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}

订阅 ID 的节点。

描述框架属性:

属性名	属性值
格式	node
访问类型	“获取”
动态节点命名	ClientInventory

Subscriptions/{SubscriptionId}/Name

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1607 [10.0.14393] 及更高版本

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}/Name

返回订阅的名称。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	“获取”

Subscriptions/{SubscriptionId}/Status

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1607 [10.0.14393] 及更高版本

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}/Status

返回订阅的状态。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

Subscriptions/DisableSubscription

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

在设备上禁用或启用订阅激活。

描述框架属性:

属性名	属性值
格式	int
访问类型	替换

允许的值:

值	说明
0	启用订阅。
1	禁用订阅。 它还会删除设备上的任何现有订阅。

Subscriptions/RemoveSubscription

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

删除订阅卸载订阅许可证。 它还会将订阅类型重置为“基于用户的订阅”。

描述框架属性:

属性名	属性值
格式	null
访问类型	Exec

Subscriptions/SubscriptionLastError

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

上次订阅操作的错误代码。 如果没有错误，值将为空 (0) 。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

Subscriptions/SubscriptionLastErrorDescription

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

上次订阅操作的错误说明。 如果无法计算错误说明，则值将为空。

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	“获取”

Subscriptions/SubscriptionStatus

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

上次订阅操作的状态。

描述框架属性:

属性名	属性值
格式	int
访问类型	“获取”

Subscriptions/SubscriptionType

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 预览体验成员预览版

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

将设备设置为“基于设备的订阅”或“基于用户的订阅”。 对于基于设备的订阅，此操作将自动获取设备上的订阅。 对于基于用户的订阅，需要用户登录的现有过程。

描述框架属性:

属性名	属性值
格式	int
访问类型	获取、替换

允许的值:

值	说明
0	基于用户的订阅。
1	基于设备的订阅。

UpgradeEditionWithLicense

注意

此策略已弃用，可能会在将来的版本中删除。

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

为 Windows 10 移动设备的版本升级提供许可证。 不需要重新启动。

描述框架属性:

属性名	属性值
格式	xml
访问类型	Exec

UpgradeEditionWithProductKey

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ❌ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅ Windows 10 版本 1511 [10.0.10586] 及更高版本

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

输入 Windows 10 桌面设备版本升级的产品密钥。 需要重新启动。

将产品密钥从 MDM 服务器推送到用户设备时， changepk.exe 使用产品密钥运行。 完成后，会向用户显示一条通知，指示有新版本的 Windows 可用。 然后，用户可以手动重启其系统，或者在两小时后，设备将自动重启以完成升级。 用户将在自动重启前 10 分钟收到提醒通知。

设备重启后，版本升级过程完成。 用户会收到成功升级的通知。

注意

如果另一个策略要求在运行时重新启动 changepk.exe 系统，则版本升级将失败。

如果在预配包中输入产品密钥，且用户开始安装包，系统会向用户显示通知，告知其系统将重启以完成包安装。 在用户明确同意继续操作后，包将继续安装并使用 changepk.exe 产品密钥运行。 用户在自动重启前 30 秒会收到提醒通知。

设备重启后，版本升级过程完成。 用户会收到成功升级的通知。

此节点还可用于通过输入产品密钥在特定版本的 Windows 10 桌面设备上激活或更改产品密钥。 激活或更改产品密钥不需要重新启动，对于用户来说，这是一个静默过程。

重要提示

输入的产品密钥必须为 29 个字符， (也就是说，它应包含短划线) ，否则 Windows 10 桌面设备上的激活、版本升级或产品密钥更改将失败。 产品密钥是从 Microsoft 批量许可服务中心获取的。 组织必须与 Microsoft 签订批量许可合同才能访问门户。

下面是通过 MDM 使用此节点时的有效版本升级路径：

• Windows 10/11 企业版到 Windows 10/11 教育版
• Windows 10/11 家庭版到 Windows 10/11 教育版
• Windows 10/11 专业版到 Windows 10/11 教育版
• Windows 10/11 专业版到 Windows 10/11 企业版

可以在以下版本上激活或更改产品密钥：

• Windows 10/11 教育版
• Windows 10/11 企业版
• Windows 10/11 家庭版
• Windows 10/11 专业版

描述框架属性:

属性名	属性值
格式	chr (字符串)
访问类型	Exec
重新启动行为	自动

示例：

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
    <CmdID>$CmdID$</CmdID>
    <Item>
      <Target>
        <LocURI>./Device/Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</Data>
    </Item>
   </Exec>
   <Final/>
  </SyncBody>
</SyncML>

注意

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX 应将 替换为产品密钥。

相关文章

配置服务提供程序参考