This CSP contains some settings that are under development and only applicable for Windows Insider Preview builds. These settings are subject to change and may have dependencies on other features or services in preview.
The WindowsLicensing configuration service provider is designed for licensing related management scenarios.
The following list shows the WindowsLicensing configuration service provider nodes:
License Type: User Based Subscription or Device Based Subscription.
Description framework properties:
Property name
Property value
Format
int
Access Type
Get, Replace
Allowed values:
Value
Description
0
User Based Subscription.
1
Device Based Subscription.
Edition
Scope
Editions
Applicable OS
✅ Device ❌ User
✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1511 [10.0.10586] and later
./Vendor/MSFT/WindowsLicensing/Edition
Returns a value that maps to the Windows 10 edition running on desktop or mobile devices. Take the value, convert it into its hexadecimal equivalent and search the GetProductInfo function page on MSDN for edition information.
✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1511 [10.0.10586] and later
./Vendor/MSFT/WindowsLicensing/LicenseKeyType
Returns the parameter type used by Windows 10 devices for an edition upgrade. Windows 10 desktop devices require a product key for an edition upgrade. Windows 10 mobile devices require a license for an edition upgrade.
Policy that determines whether a consumer can switch the device out of S mode.
This setting is only applicable to devices available in S mode.
Description framework properties:
Property name
Property value
Format
int
Access Type
Add, Delete, Get, Replace
Allowed values:
Value
Description
0
No Restriction: The user is allowed to switch the device out of S mode.
1
User Blocked: The admin has blocked the user from switching their device out of S mode. Only the admin can switch the device out of S mode through the SMode/SwitchFromSMode node.
✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1511 [10.0.10586] and later
./Vendor/MSFT/WindowsLicensing/Status
Returns the status of an edition upgrade on Windows 10 desktop and mobile devices. Status: 0 = Failed, 1 = Pending, 2 = In progress, 3 = Completed, 4 = Unknown.
Set device to Device Based Subscription or User Based Subscription. For Device Based Subscription this action will automatically acquire the subscription on the device. For User Based Subscription the existing process of user logon will be required.
Description framework properties:
Property name
Property value
Format
int
Access Type
Get, Replace
Allowed values:
Value
Description
0
User Based Subscription.
1
Device Based Subscription.
UpgradeEditionWithLicense
Note
This policy is deprecated and may be removed in a future release.
Scope
Editions
Applicable OS
✅ Device ❌ User
✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC
Enter a product key for an edition upgrade of Windows 10 desktop devices. Requires reboot.
When a product key is pushed from an MDM server to a user's device, changepk.exe runs using the product key. After it completes, a notification is shown to the user that a new edition of Windows is available. The user can then restart their system manually or after two hours, the device will restart automatically to complete the upgrade. The user will receive a reminder notification 10 minutes before the automatic restart.
After the device restarts, the edition upgrade process completes. The user will receive a notification of the successful upgrade.
Note
If another policy requires a system reboot that occurs when changepk.exe is running, the edition upgrade will fail.
If a product key is entered in a provisioning package and the user begins installation of the package, a notification is shown to the user that their system will restart to complete the package installation. Upon explicit consent from the user to proceed, the package continues installation and changepk.exe runs using the product key. The user will receive a reminder notification 30 seconds before the automatic restart.
After the device restarts, the edition upgrade process completes. The user will receive a notification of the successful upgrade.
This node can also be used to activate or change a product key on a particular edition of Windows 10 desktop device by entering a product key. Activation or changing a product key doesn't require a reboot and is a silent process for the user.
Important
The product key entered must be 29 characters (that is, it should include dashes), otherwise the activation, edition upgrade, or product key change on Windows 10 desktop devices will fail. The product key is acquired from Microsoft Volume Licensing Service Center. Your organization must have a Volume Licensing contract with Microsoft to access the portal.
The following are valid edition upgrade paths when using this node through an MDM:
Windows 10/11 Enterprise to Windows 10/11 Education
Windows 10/11 Home to Windows 10/11 Education
Windows 10/11 Pro to Windows 10/11 Education
Windows 10/11 Pro to Windows 10/11 Enterprise
Activation or changing a product key can be carried out on the following editions:
Plan and execute an endpoint deployment strategy, using essential elements of modern management, co-management approaches, and Microsoft Intune integration.