Fournisseur de services de configuration WindowsLicensing

Le tableau ci-dessous montre l’applicabilité de Windows :

Édition Windows 10 Windows 11
Accueil Oui Oui
Pro Oui Oui
Windows SE Non Oui
Entreprise Oui Oui
Enterprise Oui Oui
Éducation Oui Oui

Warning

Certaines informations concernent la version préliminaire de produits susceptibles d’être considérablement modifiés d’ici leur commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Le fournisseur de services de configuration WindowsLicensing est conçu pour les scénarios de gestion liés aux licences. Actuellement, l’étendue est limitée aux mises à niveau d’édition de Windows 10 appareils clients, telles que Windows 10 Professionnel à Windows 10 Entreprise. En outre, ce fournisseur de solutions Cloud offre la possibilité d’activer ou de modifier la clé de produit de Windows 10 appareils clients.

L’exemple suivant montre le fournisseur de services de configuration WindowsLicensing au format d’arborescence.

./Vendor/MSFT
WindowsLicensing
----UpgradeEditionWithProductKey
----ChangeProductKey
----Edition
----Status
----LicenseKeyType
----CheckApplicability
----ChangeProductKey (Added in Windows 10, version 1703)
----Subscriptions (Added in Windows 10, version 1607)
--------SubscriptionId (Added in Windows 10, version 1607)
------------Status (Added in Windows 10, version 1607)
------------Name (Added in Windows 10, version 1607)
----SMode (Added in Windows 10, version 1809)
--------SwitchingPolicy (Added in Windows 10, version 1809)
--------SwitchFromSMode (Added in Windows 10, version 1809)
--------Status (Added in Windows 10, version 1809)

./Device/Vendor/MSFT/WindowsLicensing Ce nœud est le nœud racine du fournisseur de services de configuration WindowsLicensing.

L’opération prise en charge est Get.

UpgradeEditionWithProductKey Entre une clé de produit pour une mise à niveau d’édition de Windows 10 appareils de bureau.

Remarque

Ce processus de mise à niveau nécessite un redémarrage du système.

Le type date est un chr.

L’opération prise en charge est Exec.

Lorsqu’une clé de produit est envoyée d’un serveur MDM à l’appareil d’un utilisateur, changepk.exe s’exécute à l’aide de la clé de produit. Une fois l’opération terminée, une notification s’affiche à l’utilisateur indiquant qu’une nouvelle édition de Windows 10 est disponible. L’utilisateur peut ensuite redémarrer son système manuellement ou après deux heures, l’appareil redémarre automatiquement pour terminer la mise à niveau. L’utilisateur reçoit une notification de rappel 10 minutes avant le redémarrage automatique.

Après le redémarrage du périphérique, le processus de mise à niveau de l'édition est effectué. L’utilisateur reçoit une notification une fois la mise à niveau réussie.

Important

Si une autre stratégie nécessite un redémarrage du système qui se produit lorsque changepk.exe est en cours d’exécution, la mise à niveau de l’édition échoue.

Si une clé de produit est entrée dans un package d’approvisionnement et que l’utilisateur commence l’installation du package, une notification informe l’utilisateur que le système va redémarrer pour terminer l’installation du package. Après le consentement explicite de l’utilisateur, le package continue l’installation et changepk.exes’exécute à l’aide de la clé de produit. L’utilisateur reçoit une notification de rappel 30 secondes avant le redémarrage automatique.

Après le redémarrage du périphérique, le processus de mise à niveau de l'édition est effectué. L’utilisateur reçoit une notification une fois la mise à niveau réussie.

Ce nœud peut également être utilisé pour activer ou modifier une clé de produit sur une édition particulière de Windows 10 appareil de bureau en entrant une clé de produit. L’activation ou la modification d’une clé de produit ne nécessite pas de redémarrage et est un processus silencieux pour l’utilisateur.

Important

La clé de produit entrée doit comporter 29 caractères (c’est-à-dire, elle doit inclure des tirets), sinon l’activation, la mise à niveau de l’édition ou la modification de la clé de produit sur Windows 10 appareils de bureau échoue. La clé de produit est acquise à partir de Microsoft Centre de gestion des licences en volume. Votre organisation doit disposer d’un contrat de licence en volume avec Microsoft pour accéder au portail.

Voici les chemins de mise à niveau d’édition valides lors de l’utilisation de ce nœud via un GPM :

  • Windows 10/Windows 11 Entreprise à Windows 10/Windows 11 Éducation
  • Windows 10/Windows 11 Famille à Windows 10/Windows 11 Éducation
  • Windows 10/Windows 11 Professionnel à Windows 10/Windows 11 Éducation
  • Windows 10/Windows 11 Professionnel à Windows 10/Windows 11 Entreprise

L’activation ou la modification d’une clé de produit peut être effectuée sur les éditions suivantes :

  • Windows 10/Windows 11 Éducation
  • Windows 10/Windows 11 Entreprise
  • Windows 10/Windows 11 Famille
  • Windows 10/Windows 11 Professionnel

Édition Retourne une valeur qui correspond à l’édition Windows 10 ou Windows 11. Prenez la valeur, convertissez-la en son équivalent hexadécimal et recherchez des informations d’édition dans la page de la fonction GetProductInfo sur MSDN.

Le type de données est Int.

L’opération prise en charge est Get.

Statut Retourne l’état d’une mise à niveau d’édition sur les appareils Windows. L’état correspond à l’une des valeurs suivantes :

  • 0 = Échec
  • 1 = En attente
  • 2 = En cours
  • 3 = Terminé
  • 4 = Inconnu

Le type de données est Int.

L’opération prise en charge est Get.

LicenseKeyType Retourne le type de paramètre utilisé par les appareils Windows 10 ou Windows 11 pour une mise à niveau d’édition, une activation ou une modification de clé de produit.

  • Windows 10 ou Windows 11 appareils clients nécessitent une clé de produit.

Le type de données est un chr.

L’opération prise en charge est Get.

CheckApplicability Retourne TRUE si la clé de produit entrée peut être utilisée pour une mise à niveau d’édition, une activation ou la modification d’une clé de produit de Windows 10 ou de Windows 11 pour les appareils de bureau.

Le type de données est un chr.

L’opération prise en charge est Exec.

ChangeProductKey Ajouté dans Windows 10, version 1703. Installe une clé de produit pour les appareils de bureau Windows. Ne redémarre pas.

Le type de données est un chr.

L’opération prise en charge est Execute.

Abonnements Ajout dans Windows 10, version 1607. Nœud pour les abonnements.

Subscriptions/SubscriptionId Ajout dans Windows 10, version 1607. Nœud pour les ID d’abonnement.

Abonnements/Id d’abonnement/État Ajout dans Windows 10, version 1607. Retourne l’état de l’abonnement.

Le type de données est Int.

L’opération prise en charge est Get.

Subscriptions/SubscriptionId/Name Ajout dans Windows 10, version 1607. Retourne le nom de l’abonnement.

Le type de données est un chr.

L’opération prise en charge est Get.

SMode Nœud intérieur pour la gestion du mode S.

SMode/SwitchingPolicy Ajouté dans Windows 10, version 1809. Détermine si un consommateur peut sortir l’appareil du mode S. Ce paramètre s’applique uniquement aux appareils disponibles en mode S. Pour obtenir des exemples, consultez Add S mode SwitchingPolicy, Get S mode SwitchingPolicy, Replace S mode SwitchingPolicy et Delete S mode SwitchingPolicy

La type de valeur est un entier.

Les opérations prises en charge sont Add, Get, Replace et Delete.

Valeurs prises en charge :

  • 0 - Aucune restriction : l’utilisateur est autorisé à sortir l’appareil du mode S.
  • 1 - Utilisateur bloqué : l’administrateur a empêché l’utilisateur de sortir son appareil du mode S. Seul l’administrateur peut sortir l’appareil du mode S via le nœud SMode/SwitchFromSMode.

SMode/SwitchFromSMode Ajouté dans Windows 10, version 1809. Si possible, un appareil quitte le mode S. Ne redémarre pas. Pour obtenir un exemple, consultez Execute SwitchFromSMode

L’opération prise en charge est Execute.

SMode/Status Ajouté dans Windows 10, version 1809. Retourne l’état de la dernière demande de jeu SwitchFromSMode. Pour obtenir un exemple, consultez Obtenir l’état du mode S

La type de valeur est un entier.

L’opération prise en charge est Obtenir.

Valeurs :

  • La demande échoue avec le code d’erreur 404 : aucune requête SwitchFromSMode n’a été effectuée.
  • 0 - L’appareil a réussi à sortir du mode S.
  • 1 - L’appareil traite la demande pour sortir du mode S.
  • 3 - L’appareil était déjà sorti du mode S.
  • 4 - L’appareil n’a pas pu sortir du mode S.

Exemples SyncML

CheckApplicability

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

Remarque

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX dans la balise Données doit être remplacée par votre clé de produit.

Édition

<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

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

Statut

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

UpgradeEditionWithProductKey

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

Remarque

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX dans la balise Données doit être remplacée par votre clé de produit.

Obtenir l’état du mode S

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

Exécuter SwitchFromSMode

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

Ajouter une stratégie de basculement en mode 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>

Obtenir la stratégie de basculement en mode 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>

Remplacer le mode 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>

Supprimer la stratégie de basculement en mode S

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

Informations de référence sur les fournisseurs de services de configuration