WindowsLicensing-Konfigurationsdienstanbieter

Artikel
08/08/2024

Logo von Windows Insider.

Wichtig

Dieser CSP enthält einige Einstellungen, die sich in der Entwicklung befinden und nur für Windows Insider Preview-Builds gelten. Diese Einstellungen können geändert werden und weisen möglicherweise Abhängigkeiten von anderen Vorschau-Features oder -Diensten auf.

Der WindowsLicensing-Konfigurationsdienstanbieter ist für lizenzierungsbezogene Verwaltungsszenarien konzipiert.

In der folgenden Liste sind die WindowsLicensing-Konfigurationsdienstanbieterknoten aufgeführt:

./Vendor/MSFT/WindowsLicensing

ChangeProductKey

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1703 [10.0.15063] und höher

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

Installiert einen Product Key für Windows 10-Desktopgeräte. Startet nicht neu.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	Exec

CheckApplicability

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/CheckApplicability

Gibt TRUE zurück, wenn der eingegebene Product Key für ein Editionsupgrade von Windows 10-Desktopgeräten verwendet werden kann.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	Exec

Beispiel:

<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>

Hinweis

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX im Tag Data sollte durch Ihren Product Key ersetzt werden.

DeviceLicensingService

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 11, Version 21H2 mit KB5018483 [10.0.22000.1165] und höher ✅ Windows 11, Version 22H2 [10.0.22621] und höher

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

Gerätebasiertes Abonnement.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`node`
Zugriffstyp	„Abrufen“

DeviceLicensingService/DeviceLicensingLastError

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 11, Version 21H2 mit KB5018483 [10.0.22000.1165] und höher ✅ Windows 11, Version 22H2 [10.0.22621] und höher

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

Gibt den letzten Fehlercode des Vorgangs "Gerätelizenz aktualisieren/entfernen" zurück. Ohne Fehler wäre der Wert leer(0).

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

DeviceLicensingService/DeviceLicensingLastErrorDescription

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 11, Version 21H2 mit KB5018483 [10.0.22000.1165] und höher ✅ Windows 11, Version 22H2 [10.0.22621] und höher

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

Gibt die letzte Fehlerbeschreibung aus der Gerätelizenzierung zurück. Der Wert wäre leer, wenn die Fehlerbeschriftung nicht ausgewertet werden kann.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	„Abrufen“

DeviceLicensingService/DeviceLicensingStatus

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 11, Version 21H2 mit KB5018483 [10.0.22000.1165] und höher ✅ Windows 11, Version 22H2 [10.0.22621] und höher

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

Gibt den Status des Vorgangs "Gerätelizenz aktualisieren/entfernen" zurück.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

DeviceLicensingService/LicenseType

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 11, Version 21H2 mit KB5018483 [10.0.22000.1165] und höher ✅ Windows 11, Version 22H2 [10.0.22621] und höher

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

Lizenztyp: Benutzerbasiertes Abonnement oder gerätebasiertes Abonnement.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	Abrufen, Ersetzen

Zulässige Werte:

Wert	Beschreibung
0	Benutzerbasiertes Abonnement.
1	Gerätebasiertes Abonnement.

Edition

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/Edition

Gibt einen Wert zurück, der der Windows 10 Edition zugeordnet ist, die auf Desktop- oder mobilen Geräten ausgeführt wird. Nehmen Sie den Wert, konvertieren Sie ihn in die hexadezimale Entsprechung, und suchen Sie auf der Funktionsseite GetProductInfo auf MSDN nach Editionsinformationen.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Beispiel:

<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

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

Gibt den Parametertyp zurück, der von Windows 10-Geräten für ein Editionsupgrade verwendet wird. Windows 10-Desktopgeräte erfordern einen Product Key für ein Editionsupgrade. Für mobile Windows 10-Geräte ist eine Lizenz für ein Editionsupgrade erforderlich.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	„Abrufen“

Beispiel:

<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

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1809 [10.0.17763] und höher

./Vendor/MSFT/WindowsLicensing/SMode

Innerer Knoten zum Verwalten des S-Modus.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`node`
Zugriffstyp	„Abrufen“

SMode/Status

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1809 [10.0.17763] und höher

./Vendor/MSFT/WindowsLicensing/SMode/Status

Gibt den Status der letzten SwitchFromSMode- oder SwitchingPolicy-Setanforderung zurück.

Mögliche Werte:

Die Anforderung schlägt mit dem Fehlercode 404 fehl: Es wurde keine SwitchFromSMode-Anforderung ausgeführt.
0: Das Gerät wurde erfolgreich aus dem S Modus gewechselt.
1: Das Gerät verarbeitet die Anforderung, aus dem S Modus zu wechseln.
3: Das Gerät wurde bereits aus dem S Modus gewechselt.
4: Das Gerät konnte nicht aus dem S Modus wechseln.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Beispiel:

<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

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1809 [10.0.17763] und höher

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

Schaltet ein Gerät nach Möglichkeit aus dem S Modus aus. Startet nicht neu.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`null`
Zugriffstyp	Exec

Beispiel:

<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

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1809 [10.0.17763] und höher

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

Richtlinie, die bestimmt, ob ein Consumer das Gerät aus dem S Modus wechseln kann.

Diese Einstellung gilt nur für Geräte, die im S Modus verfügbar sind.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	Hinzufügen, Löschen, Abrufen, Ersetzen

Zulässige Werte:

Wert	Beschreibung
0	Keine Einschränkung: Der Benutzer darf das Gerät aus dem S Modus wechseln.
1	Benutzer blockiert: Der Administrator hat verhindert, dass der Benutzer sein Gerät aus dem S Modus wechselt. Nur der Administrator kann das Gerät über den Knoten SMode/SwitchFromSMode aus dem S Modus wechseln.

Beispiele:

Hinzufügen von S Mode SwitchingPolicy

<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>

Abrufen der Richtlinie zum Wechseln des S-Modus

<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>

Ersetzen von SwitchingPolicy im S-Modus

<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>

Löschen von SwitchingPolicy im S-Modus

<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>

Status

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/Status

Gibt den Status eines Editionsupgrades auf Windows 10-Desktop- und mobilen Geräten zurück. Status: 0 = Fehler, 1 = Ausstehend, 2 = In Bearbeitung, 3 = Abgeschlossen, 4 = Unbekannt.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Beispiel:

<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>

Abonnements

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1607 [10.0.14393] und höher

./Vendor/MSFT/WindowsLicensing/Subscriptions

Knoten für Abonnements.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`node`
Zugriffstyp	„Abrufen“

Subscriptions/{SubscriptionId}

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1607 [10.0.14393] und höher

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

Knoten für Abonnement-IDs.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`node`
Zugriffstyp	„Abrufen“
Dynamische Knotenbenennung	ClientInventory

Subscriptions/{SubscriptionId}/Name

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1607 [10.0.14393] und höher

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

Gibt den Namen des Abonnements zurück.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	„Abrufen“

Subscriptions/{SubscriptionId}/Status

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1607 [10.0.14393] und höher

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

Gibt den Status des Abonnements zurück.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Abonnements/DisableSubscription

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

Deaktivieren oder Aktivieren der Abonnementaktivierung auf einem Gerät.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	Ersetzen

Zulässige Werte:

Wert	Beschreibung
0	Aktivieren Sie das Abonnement.
1	Abonnement deaktivieren. Außerdem werden alle auf dem Gerät vorhandenen Abonnements entfernt.

Abonnements/RemoveSubscription

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

Abonnementabonnementlizenz für die Deinstallation entfernen. Außerdem wird der Abonnementtyp auf benutzerbasiertes Abonnement zurückgesetzt.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`null`
Zugriffstyp	Exec

Subscriptions/SubscriptionLastError

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

Fehlercode des letzten Abonnementvorgangs. Ohne Fehler wäre der Wert leer(0).

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Subscriptions/SubscriptionLastErrorDescription

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

Fehlerbeschreibung des letzten Abonnementvorgangs. Der Wert wäre leer, wenn die Fehlerbeschreibung nicht ausgewertet werden kann.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	„Abrufen“

Subscriptions/SubscriptionStatus

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

Status des letzten Abonnementvorgangs.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	„Abrufen“

Subscriptions/SubscriptionType

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

Legen Sie das Gerät auf Gerätebasiertes Abonnement oder benutzerbasiertes Abonnement fest. Für gerätebasiertes Abonnement wird mit dieser Aktion automatisch das Abonnement auf dem Gerät abgerufen. Für ein benutzerbasiertes Abonnement ist der vorhandene Prozess der Benutzeranmeldung erforderlich.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`int`
Zugriffstyp	Abrufen, Ersetzen

Zulässige Werte:

Wert	Beschreibung
0	Benutzerbasiertes Abonnement.
1	Gerätebasiertes Abonnement.

UpgradeEditionWithLicense

Hinweis

Diese Richtlinie ist veraltet und kann in einer zukünftigen Version entfernt werden.

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

Stellen Sie eine Lizenz für ein Editionsupgrade von mobilen Windows 10-Geräten bereit. Erfordert keinen Neustart.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`xml`
Zugriffstyp	Exec

UpgradeEditionWithProductKey

Bereich	Editionen	Geeignetes Betriebssystem
✅ Gerät ❌ Benutzer	✅ Pro ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅ Windows 10, Version 1511 [10.0.10586] und höher

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

Geben Sie einen Product Key für ein Editionsupgrade von Windows 10-Desktopgeräten ein. Erfordert einen Neustart.

Wenn ein Product Key von einem MDM-Server auf das Gerät eines Benutzers gepusht wird, changepk.exe wird mit dem Product Key ausgeführt. Nach Abschluss des Vorgangs wird dem Benutzer eine Benachrichtigung angezeigt, dass eine neue Edition von Windows verfügbar ist. Der Benutzer kann dann sein System manuell oder nach zwei Stunden neu starten, das Gerät wird automatisch neu gestartet, um das Upgrade abzuschließen. Der Benutzer erhält 10 Minuten vor dem automatischen Neustart eine Erinnerungsbenachrichtigung.

Nach dem Neustart des Geräts wird der Editionsupgradevorgang abgeschlossen. Der Benutzer erhält eine Benachrichtigung über die erfolgreiche Aktualisierung.

Hinweis

Wenn eine andere Richtlinie einen Systemneustart erfordert, der bei changepk.exe der Ausführung erfolgt, tritt beim Editionsupgrade ein Fehler auf.

Wenn ein Product Key in einem Bereitstellungspaket eingegeben wird und der Benutzer mit der Installation des Pakets beginnt, wird eine Benachrichtigung für den Benutzer angezeigt, dass das System neu gestartet wird, um die Installation des Pakets abzuschließen. Nach der ausdrücklichen Zustimmung des Benutzers zum Fortfahren setzt das Paket die Installation fort und changepk.exe wird mit dem Product Key ausgeführt. Der Benutzer erhält 30 Sekunden vor dem automatischen Neustart eine Erinnerung.

Nach dem Neustart des Geräts wird der Editionsupgradevorgang abgeschlossen. Der Benutzer erhält eine Benachrichtigung über die erfolgreiche Aktualisierung.

Dieser Knoten kann auch verwendet werden, um einen Product Key auf einer bestimmten Edition von Windows 10-Desktopgeräten durch Eingabe eines Product Keys zu aktivieren oder zu ändern. Die Aktivierung oder Änderung eines Product Keys erfordert keinen Neustart und ist ein automatischer Prozess für den Benutzer.

Wichtig

Der eingegebene Product Key muss 29 Zeichen lang sein (d. h., er sollte Bindestriche enthalten), andernfalls schlägt die Aktivierung, das Editionsupgrade oder die Product Key-Änderung auf Windows 10-Desktopgeräten fehl. Der Product Key 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 eine MDM verwenden:

Windows 10/11 Enterprise auf Windows 10/11 Education
Windows 10/11 Home to Windows 10/11 Education
Windows 10/11 Pro auf Windows 10/11 Education
Windows 10/11 Pro auf Windows 10/11 Enterprise

Die Aktivierung oder Änderung eines Product Keys kann für die folgenden Editionen durchgeführt werden:

Windows 10/11 Education
Windows 10/11 Enterprise
Windows 10/11 Home
Windows 10/11 Pro

Beschreibungsframeworkeigenschaften:

Eigenschaftenname	Eigenschaftenwert
Format	`chr` (Zeichenfolge)
Zugriffstyp	Exec
Neustartverhalten	Automatisch

Beispiel:

<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>

Hinweis

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX im Tag Data sollte durch Ihren Product Key ersetzt werden.

Referenz zum Konfigurationsdienstanbieter

Freigeben über

WindowsLicensing-Konfigurationsdienstanbieter

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edition

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromsMode

SMode/SwitchingPolicy

Status

Abonnements

Subscriptions/{SubscriptionId}

Subscriptions/{SubscriptionId}/Name

Subscriptions/{SubscriptionId}/Status

Abonnements/DisableSubscription

Abonnements/RemoveSubscription

Subscriptions/SubscriptionLastError

Subscriptions/SubscriptionLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Feedback

Zusätzliche Ressourcen

Freigeben über

WindowsLicensing-Konfigurationsdienstanbieter

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edition

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromsMode

SMode/SwitchingPolicy

Status

Abonnements

Subscriptions/{SubscriptionId}

Subscriptions/{SubscriptionId}/Name

Subscriptions/{SubscriptionId}/Status

Abonnements/DisableSubscription

Abonnements/RemoveSubscription

Subscriptions/SubscriptionLastError

Subscriptions/SubscriptionLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Verwandte Artikel

Feedback

Zusätzliche Ressourcen