Classes WMI

  • Article

Cette section fournit des informations sur la classe WMI et la page de référence. Pour plus d’informations sur la récupération des données de classe ou d’instance, consultez Manipulation des informations sur les classes et les instances. La liste suivante répertorie, décrit et fournit des liens vers des informations de classe WMI spécifiques. Pour plus d’informations et pour obtenir des exemples de code de script sur l’utilisation de classes WMI pour obtenir diverses données matérielles et de système d’exploitation, consultez Tâches WMI pour les scripts et les applications. Pour obtenir des exemples en C++, consultez Exemples d’applications WMI C++. Connexion à WMI sur un ordinateur distant montre comment obtenir des données distantes. Vous pouvez également utiliser PowerShell pour accéder aux objets WMI ; pour obtenir la liste des classes WMI qui incluent des exemples de code PowerShell, cliquez ici.

Section Description
Classes système WMI Classes prédéfinies incluses dans chaque espace de noms dans le cœur de Windows Management Instrumentation (WMI). Vous pouvez reconnaître une classe système WMI, car le nom commence par un trait de soulignement double (__). Ces classes fournissent une grande partie des fonctionnalités de base pour WMI. L’objectif des classes système WMI est similaire à celui des tables système dans SQL Server.
Classes MSFT Autres classes Microsoft qui offrent le moyen de manipuler plusieurs fonctionnalités du système d’exploitation, telles que les événements distants et les extensions de stratégie. Les classes Résolution des problèmes WMI sont des classes MSFT qui fournissent des données sur les opérations WMI.
Classes CIM Classes de schéma Common Information Model (CIM). Si vous souhaitez écrire vos propres classes WMI, vous pouvez hériter d’une ou plusieurs de ces classes. Les classes Win32 WMI héritent des classes CIM.
Classes de consommateur standard Ensemble de consommateurs d’événements WMI qui déclenchent une action à la réception d’un événement arbitraire. Pour plus d’informations, consultez Surveillance des événements.

 

Exemples de code du centre de script de classe WMI

Les exemples de code suivants du centre de script affectent plusieurs classes WMI sur plusieurs espaces de noms.

Lien Description
Interface graphique Explorer WMI et générateur d’aide de méthode WMI Exemple de script qui fournit une interface graphique WMI Explorer et un générateur d’aide de méthode WMI.
Espace de noms WMI de recherche WMI Explorer Permet aux utilisateurs de rechercher des classes dans tous les espaces de noms disponibles sur les ordinateurs spécifiés. Cet exemple est la version de ligne de commande de l’exemple de WMI Explorer de l’interface utilisateur graphique et peut être considéré comme une extension de Get-WmiObject -List.
Outil d’administration système Windows Arposh AWSA a été créé avec l’administrateur système à l’esprit. La résolution des problèmes Windows nécessite un large éventail d’outils et de connaissances. AWSA regroupe ces outils dans un emplacement central et ajoute des fonctionnalités supplémentaires.

 

Conventions de nommage pour les classes et propriétés WMI

Les noms de propriétés doivent être conformes à la syntaxe MOF (Managed Object Format) définie par le Groupe de travail de gestion distribuée. Les caractères d’identificateur initiaux doivent provenir des lettres de a à z et du caractère de soulignement (_). Tous les caractères supplémentaires doivent provenir des lettres de a à z, du caractère de soulignement et des chiffres 0 à 9. Pour plus d’informations, consultez la section Utilisation d’Unicode de la spécification CIM version 2.2.

Les mots de réserve SQL ne doivent pas être utilisés dans les noms de classes et de propriétés. Pour obtenir la liste complète des mots de réserve SQL et pour plus d’informations, consultez la section Recommandations de la spécification CIM version 2.2.

Conventions de document pour une page de référence de classe WMI

Cette section identifie et décrit les conventions de document pour une page de référence de classe WMI.

Une page de référence classique contient un bloc de syntaxe, une table de méthodes et une liste de propriétés.

  • Bloc de syntaxe

    Version simplifiée du code MOF qui inclut le nom de la classe, la classe parente (le cas échéant) et les propriétés de classe, par ordre alphabétique, avec les types de données.

  • Table méthodes

    Si une classe a des méthodes, les méthodes sont répertoriées dans le tableau qui suit immédiatement le bloc de syntaxe. Chaque méthode implémentée est liée à une page de référence.

  • Liste Propriétés

    Chaque propriété de classe est répertoriée avec un type de données, un type d’accès (lecture seule ou lecture/écriture), des qualificateurs et une description de la propriété.

Bloc de syntaxe

class Win32_xyz : CIM_xyz 
{
  uint16 abc  ;
  string def  ;
};

Table méthodes

Méthodes Win32_xyz Description
SomeMethod Brève description de ce que fait la méthode.

 

Liste Propriétés

abc

Type de données : uint16

Type d’accès : indique si vous disposez d’un accès en lecture/écriture ou en lecture seule à cette propriété.

Qualificateurs : s’il est présent, affiche les qualificateurs de la propriété. Par exemple, Key, Override.

Décrit la propriété et fournit des informations d’héritage pour la propriété. Par exemple, cette propriété est héritée de CIM_xyz. Il existe un lien vers la classe parente si Microsoft fournit une implémentation de cette classe. Toutefois, les classes CIM ne sont pas disponibles.

def

Type de données : chaîne

Type d'accès : Lecture seule

Description de la propriété.

Notes

Fournit plus d’informations sur la classe, le cas échéant. Fournit également des informations de dérivation, le cas échéant.

Référence WMI