MDM_WindowsLicensing, classe

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

La classe MDM_WindowsLicensing est conçue pour les scénarios de gestion liés aux licences. Pour le moment, son étendue est limitée aux mises à niveau d’édition d’appareils de bureau et mobiles Windows 10, par exemple de Windows 10 Professionnel vers Windows 10 Entreprise. De plus, ce fournisseur de solutions cloud permet d’activer ou de modifier la clé de produit des appareils de bureau Windows 10.

La syntaxe suivante est simplifiée à partir du code MOF et inclut toutes les propriétés héritées.

Syntaxe

[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
  string InstanceID;
  string ParentID;
  sint32 Edition;
  sint32 Status;
  string LicenseKeyType;
};

Membres

La classe MDM_WindowsLicensing possède ces types de membres :

Méthodes

La classe MDM_WindowsLicensing possède ces méthodes.

Méthode Description
ChangeProductKeyMethod Installe une clé de produit (Product Key) pour les appareils de bureau Windows 10. Ne redémarre pas.
CheckApplicabilityMethod Méthode permettant de vérifier si la clé de produit entrée peut être utilisée pour la mise à niveau d’édition, l’activation ou la modification d’une clé de produit de Windows 10 pour des appareils de bureau.
UpgradeEditionWithLicenseMethod Méthode permettant de fournir une licence pour une mise à niveau d’édition d’appareils mobiles Windows 10.
Remarque : ce processus de mise à niveau ne nécessite pas de redémarrage du système.
Le type de date est XML.
L’opération prise en charge est Execute.
Important !
Le contenu du fichier de licence XML doit être correctement placé dans une séquence d’échappement (autrement dit, vous ne pouvez pas simplement copier le XML). Sinon, la mise à niveau d’édition sur des appareils mobiles Windows 10 échoue. Pour plus d’informations sur la séquence d’échappement appropriée pour le fichier de licence XML, consultez la section 2.4 de la spécification XML du W3C. Le fichier de licence XML est acquis à partir du Centre de gestion des licences en volume Microsoft. 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 par le biais d’un logiciel de gestion des appareils mobiles (MDM) ou d’un package de configuration :
- Windows 10 Mobile vers Windows 10 Mobile Entreprise
UpgradeEditionWithProductKeyMethod Signale à l’appareil de prendre la clé de produit et de mettre à niveau l’édition du client.
[!Remarque]
Ce processus de mise à niveau nécessite un redémarrage du système.


L’opération prise en charge est Execute.
Lorsqu’une clé de produit est envoyée (push) à partir d’un serveur MDM vers l’appareil d’un utilisateur, changepk.exe s’exécute avec la clé de produit. Une fois l’opération terminée, l’utilisateur reçoit une notification indiquant qu’une nouvelle édition de Windows 10 est disponible. L’utilisateur peut ensuite redémarrer son système manuellement. Sinon, 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.
Une fois l’appareil redémarré, le processus de mise à niveau d’édition est terminé. 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 d’édition échoue.


Si une clé de produit est entrée dans un package de configuration et que l’utilisateur lance l’installation du package, l’utilisateur reçoit une notification indiquant que son système va redémarrer pour terminer l’installation du package. Après le consentement explicite de l’utilisateur, le package poursuit l’installation et changepk.exe s’exécute avec la clé de produit. L’utilisateur reçoit une notification de rappel 30 secondes avant le redémarrage automatique.
Une fois l’appareil redémarré, le processus de mise à niveau d’édition est terminé. L’utilisateur reçoit une notification une fois la mise à niveau réussie.
Vous pouvez également utiliser ce nœud pour activer ou modifier une clé de produit sur une édition particulière d’un appareil de bureau Windows 10 en entrant une clé de produit. L’activation ou la modification d’une clé de produit ne nécessite pas de redémarrage et ce processus est silencieux pour l’utilisateur.
[!Important]
La clé de produit entrée doit comporter 29 caractères (elle doit donc inclure des tirets) ; sinon, l’activation, la mise à niveau d’édition ou la modification de la clé de produit sur des appareils de bureau Windows 10 échoue. La clé de produit est acquise auprès du Centre de gestion des licences en volume Microsoft. 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 par le biais d’un logiciel de gestion des appareils mobiles (MDM) :
  • Windows 10 Entreprise vers Windows 10 Éducation
  • Windows 10 Famille vers Windows 10 Éducation
  • Windows 10 Professionnel vers Windows 10 Éducation
  • Windows 10 Professionnel vers Windows 10 Entreprise

Vous pouvez activer ou modifier une clé de produit sur les éditions suivantes :
  • Windows 10 Éducation
  • Windows 10 Entreprise
  • Windows 10 Famille
  • Windows 10 Professionnel

Propriétés

La classe MDM_WindowsLicensing possède ces propriétés.

Édition

Type de données : sint32

Type d’accès : lecture/écriture

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Identifie le nom du nœud parent.

LicenseKeyType

Type de données : chaîne

Type d’accès : lecture/écriture

ParentID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Décrit le chemin complet vers le nœud parent. Pour cette classe, la chaîne est « ./Vendor/MSFT/ »

État

Type de données : sint32

Type d’accès : lecture/écriture

Spécifications

Condition requise Value
Client minimal pris en charge
Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge
Aucun pris en charge
Espace de noms
Root\CIMv2\MDM\DMMap
MOF
DMWmiBridgeProv.mof
DLL
DMWmiBridgeProv.dll

Voir aussi

Utilisation de scripts PowerShell avec le fournisseur de pont WMI