MDM_WindowsLicensing-Klasse
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Die MDM_WindowsLicensing-Klasse wurde für lizenzbezogene Verwaltungsszenarien konzipiert. Derzeit ist der Umfang auf Editionsupgrades von Windows 10-Desktop- und mobilen Geräten beschränkt, wie Windows 10 Pro auf Windows 10 Enterprise. Überdies bietet dieser CSP die Möglichkeit, den Product Key von Windows 10-Desktopgeräten zu aktivieren oder zu ändern.
Die folgende Syntax enthält vereinfachten MOF-Code und schließt alle geerbten Eigenschaften ein.
Syntax
[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
string InstanceID;
string ParentID;
sint32 Edition;
sint32 Status;
string LicenseKeyType;
};
Member
Die MDM_WindowsLicensing-Klasse weist folgende Typen von Membern auf:
Methoden
Die MDM_WindowsLicensing-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| ChangeProductKeyMethod | Installiert einen Product Key für Windows 10-Desktopgeräte. Führt keinen Neustart durch. |
| CheckApplicabilityMethod | Methode zum Überprüfen, ob der eingegebene Product Key für ein Editionsupgrade, eine Aktivierung oder eine Änderung des Product Keys von Windows 10 für Desktopgeräte verwendet werden kann. |
| UpgradeEditionWithLicenseMethod | Stellen Sie eine Lizenz für ein Editionsupgrade von mobilen Windows 10-Geräten bereit. Hinweis: Dieser Upgradevorgang erfordert keinen Systemneustart. Der Datumstyp ist XML. Der unterstützte Vorgang ist „Execute“. Wichtig: Der Inhalt der XML-Lizenzdatei muss ordnungsgemäß mit Escapezeichen versehen werden (d. h. es sollte nicht einfach kopierter XML-Code sein), andernfalls schlägt das Editionsupgrade auf mobilen Windows 10-Geräten fehl. Weitere Informationen zur ordnungsgemäßen Formatierung der XML-Lizenzdatei mit Escapezeichen finden Sie im Abschnitt 2.4 der W3C-XML-Spezifikation. Die XML-Lizenzdatei wird im Microsoft Volume Licensing Service Center abgerufen. Ihre Organisation muss über einen Volumenlizenzvertrag mit Microsoft verfügen, um auf das Portal zugreifen zu können. Nachfolgend sind gültige Editionsupgradepfade bei Verwendung dieses Knotens über ein MDM- oder Bereitstellungspaket aufgeführt: – Windows 10 Mobile auf Windows 10 Mobile Enterprise |
| UpgradeEditionWithProductKeyMethod | Bewirkt, dass das Gerät den Product Key übernimmt und die Edition des Clients aktualisiert.[!Hinweis] Der unterstützte Vorgang ist „Execute“. Wenn ein Product Key von einem MDM-Server auf das Gerät von Benutzer*innen übertragen wird, wird changepk.exe mit dem Product Key ausgeführt. Nach Abschluss des Vorgangs wird die Benachrichtigung angezeigt, dass eine neue Edition von Windows 10 verfügbar ist. Die Benutzer*innen können das System dann manuell neu starten. Andernfalls wird das Gerät nach zwei Stunden automatisch neu gestartet, um das Upgrade abzuschließen. Die Benutzer*innen erhalten 10 Minuten vor dem automatischen Neustart eine Benachrichtigung mit einer Erinnerung. Nach dem Neustart des Geräts wird der Editionsupgradevorgang abgeschlossen. Die Benutzer*innen erhalten eine Benachrichtigung über das erfolgreiche Upgrade. [Wichtig] Wenn ein Product Key in ein Bereitstellungspaket eingegeben wird und der bzw. die Benutzer*in mit der Installation des Pakets beginnt, wird eine Benachrichtigung angezeigt, die besagt, dass das System neu gestartet wird, um die Paketinstallation abzuschließen. Nachdem der bzw. die Benutzer*in ausdrücklich der Fortsetzung des Vorgangs zugestimmt hat, fährt das Paket mit der Installation fort, und changepk.exe wird mit dem Product Key ausgeführt. Die Benutzer*innen erhalten 30 Sekunden vor dem automatischen Neustart eine Benachrichtigung mit einer Erinnerung. Nach dem Neustart des Geräts wird der Editionsupgradevorgang abgeschlossen. Die Benutzer*innen erhalten eine Benachrichtigung über das erfolgreiche Upgrade. Dieser Knoten kann auch verwendet werden, um einen Product Key auf einem bestimmten Windows 10-Desktopgerät zu aktivieren oder zu ändern, indem der Product Key eingegeben wird. Die Aktivierung oder Änderung eines Product Keys erfordert keinen Neustart und ist für Benutzer*innen ein lautloser Prozess. [Wichtig] Nachfolgend sind gültige Editionsupgradepfade bei Verwendung dieses Knotens über ein MDM aufgeführt:
Ein Product Key kann in den folgenden Editionen aktiviert oder geändert werden:
|
Eigenschaften
Die MDM_WindowsLicensing-Klasse verfügt über diese Eigenschaften.
-
-
Datentyp: sint32
-
Zugriffstyp: Lesen/Schreiben
-
-
InstanceID
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: key
Der Name des übergeordneten Knotens.
-
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Lesen/Schreiben
-
-
ParentID
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: key
Beschreibt den vollständigen Pfad zum übergeordneten Knoten. Die Zeichenfolge für diese Klasse lautet "./Vendor/MSFT/"
-
-
-
Datentyp: sint32
-
Zugriffstyp: Lesen/Schreiben
-
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Namespace |
Root\CIMv2\MDM\DMMap |
| MOF |
|
| DLL |
|