MDM _ WindowsLicensing-Klasse

[Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.]

Die MDM _ WindowsLicensing-Klasse ist für lizenzierungsbezogene Verwaltungsszenarien konzipiert. Derzeit ist der Bereich auf Editionsupgrades Windows 10 Desktop- und mobilen Geräten beschränkt, z. B. Windows 10 Pro auf Windows 10 Enterprise. Darüber hinaus bietet dieser CSP die Möglichkeit zum Aktivieren oder Ändern des Product Key Windows 10 Desktopgeräten.

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 verfügt über die folgenden Membertypen:

Methoden

Die MDM _ WindowsLicensing-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
ChangeProductKeyMethod Installiert einen Product Key für Windows 10 Desktopgeräte. Wird nicht neu gestartet.
CheckApplicabilityMethod Methode, um zu überprüfen, ob der eingegebene Product Key für ein Editionsupgrade, die Aktivierung oder das Ändern eines Product Key von Windows 10 Desktopgeräten verwendet werden kann.
UpgradeEditionWithLicenseMethod Stellen Sie eine Lizenz für ein Editionsupgrade Windows 10 mobilen Geräten zur Verfügung.
[!Note]
Für diesen Upgradeprozess ist kein Systemneustart erforderlich.


Der Datumstyp ist XML.
Der unterstützte Vorgang ist Execute.
[!Important]
Der Inhalt der XML-Lizenzdatei muss ordnungsgemäß mit Escapeinformationen geschützt werden (d. h. es sollte sich nicht einfach um eine kopierte XML-Datei handelt). Andernfalls wird das Editionsupgrade auf Windows 10 mobilen Geräten fehlschlagen. Weitere Informationen zum richtigen Verwenden von Caping für die XML-Lizenzdatei finden Sie in Abschnitt 2.4 der W3C-XML-Spezifikation. Die XML-Lizenzdatei wird aus dem Microsoft Volume Licensing Service Center erworben. Ihre Organisation muss über einen Volumenlizenzvertrag mit Microsoft verfügen, um auf das Portal zugreifen zu können.

Im Folgenden finden Sie gültige Editionsupgradepfade, wenn Sie diesen Knoten über ein MDM- oder Bereitstellungspaket verwenden:
  • Windows 10 Mobileto Windows 10 Mobile Enterprise

UpgradeEditionWithProductKeyMethod Löst das Gerät aus, um den Product Key zu übernehmen und die Edition des Clients zu aktualisieren.
[!Note]
Dieser Upgradevorgang erfordert einen Systemneustart.


Der unterstützte Vorgang ist Execute.
Wenn ein Product Key von einem MDM-Server auf das Gerät eines Benutzers übertragen wird, changepk.exemit dem Product Key ausgeführt. Nach Abschluss wird dem Benutzer eine Benachrichtigung angezeigt, dass eine neue Edition Windows 10 verfügbar ist. Der Benutzer kann sein System dann manuell neu starten, oder nach zwei Stunden wird das Gerät automatisch neu gestartet, um das Upgrade abschließen zu können. Der Benutzer erhält 10 Minuten vor dem automatischen Neustart eine Erinnerungsbenachrichtigung.
Nach dem Neustart des Geräts wird das Editionsupgrade abgeschlossen. Der Benutzer erhält eine Benachrichtigung über das erfolgreiche Upgrade.
[!Important]
Wenn eine andere Richtlinie einen Systemneustart erfordert, der beichangepk.exeausgeführt wird, tritt beim Editionsupgrade ein Fehler auf.


Wenn ein Product Key in ein Bereitstellungspaket eingegeben wird und der Benutzer mit der Installation des Pakets beginnt, wird dem Benutzer eine Benachrichtigung angezeigt, dass sein System neu gestartet wird, um die Paketinstallation abzuschließen. Nach der expliziten Zustimmung des Benutzers zum Fortfahren setzt das Paket die Installation fort undchangepk.exe mit dem Product Key ausgeführt werden. Der Benutzer erhält 30 Sekunden vor dem automatischen Neustart eine Erinnerungsbenachrichtigung.
Nach dem Neustart des Geräts wird das Editionsupgrade abgeschlossen. Der Benutzer erhält eine Benachrichtigung über das erfolgreiche Upgrade.
Dieser Knoten kann auch verwendet werden, um einen Product Key auf einer bestimmten Edition von Windows 10 Desktopgerät durch Eingabe eines Product Key zu aktivieren oder zu ändern. Die Aktivierung oder Änderung eines Product Key erfordert keinen Neustart und ist ein automatischer Prozess für den Benutzer.
[!Important]
Der eingegebene Product Key muss aus 29 Zeichen bestehen (d.h. er sollte Bindestriche enthalten), andernfalls kann die Aktivierung, das Editionsupgrade oder die Änderung des Product Key auf Windows 10 Desktopgeräten nicht ausgeführt werden. Der Product Key wird vom Microsoft Volume Licensing Service Center erworben. Ihre Organisation muss über einen Volumenlizenzvertrag mit Microsoft verfügen, um auf das Portal zugreifen zu können.

Im Folgenden finden Sie gültige Editionsupgradepfade, wenn Sie diesen Knoten über eine MDM verwenden:
  • Windows 10 Enterprise, um Windows 10 Education
  • Windows 10 Home sie Windows 10 Education
  • Windows 10 Pro sie Windows 10 Education
  • Windows 10 Pro sie Windows 10 Enterprise

Die Aktivierung oder Änderung eines Product Key kann in den folgenden Editionen durchgeführt werden:
  • Windows 10 Education
  • Windows 10 Enterprise
  • Windows 10 Home
  • Windows 10 Pro

Eigenschaften

Die MDM _ WindowsLicensing-Klasse verfügt über diese Eigenschaften.

Edition

Datentyp: sint32

Zugriffstyp: Lesen/Schreiben

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert den Namen des übergeordneten Knotens.

LicenseKeyType

Datentyp: Zeichenfolge

Zugriffstyp: Lesen/Schreiben

Parentid

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Beschreibt den vollständigen Pfad zum übergeordneten Knoten. Für diese Klasse ist die Zeichenfolge "./Vendor/MSFT/".

Status

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
\Stamm-CIMv2 \ MDM \ DMMap
MOF
DMWmiBridgeProv.mof
DLL
DMWmiBridgeProv.dll

Weitere Informationen

Verwenden von PowerShell-Skripts mit dem WMI-Bridge-Anbieter