Propriétés du système WMI

Windows Management Instrumentation (WMI) définit un ensemble de propriétés système associées à toutes les classes et instances de classes. Comme pour les classes système, les noms de propriétés système commencent par un trait de soulignement double, ce qui les distingue des propriétés créées par des applications ou des fournisseurs qui ne doivent pas commencer par un trait de soulignement simple ou double. Une autre façon d’identifier une propriété système consiste à utiliser la méthode IWbemClassObject::Get .

Les propriétés système sont disponibles à tout moment, mais les valeurs peuvent être NULL. NULL indique qu’une propriété ne s’applique pas à un objet spécifique. Toutefois, les propriétés système peuvent ne pas être disponibles tout le temps pour toutes les classes ou instances.

Propriétés système

La liste suivante décrit les propriétés système WMI. Les exemples donnés proviennent des propriétés système de la classe Win32_OptionalFeature, qui est décrite au bas de cette rubrique.

__Class

Type de données : CIM_STRING

Type d’accès : en lecture seule pour les instances ; lecture/écriture pour les classes

Nom de la classe.

Exemple : Win32_OptionalFeature

__Derivation

Type de données : tableau CIM_STRING

Type d’accès : en lecture seule pour les instances et les classes

Hiérarchie de classes de la classe ou de l’instance actuelle. Le premier élément est la classe parente immédiate, le suivant est son parent, et ainsi de suite ; le dernier élément est la classe de base.

Exemple : {CIM_LogicalElement, CIM_ManagedSystemElement}

__Dynasty

Type de données : CIM_STRING

Type d'accès : Lecture seule

Nom de la classe de niveau supérieur à partir de laquelle la classe ou l’instance est dérivée. Lorsque cette classe ou instance est la classe de niveau supérieur, les valeurs de __Dynasty et __Class sont les mêmes.

Exemple : CIM_ManagedSystemElement

__Genus

Type de données : CIM_SINT32

Type d'accès : Lecture seule

Valeur utilisée pour faire la distinction entre les classes et les instances. Cette valeur est WBEM_GENUS_CLASS (1) pour les classes et WBEM_GENUS_INSTANCE (2) pour les instances et les événements.

Exemple : 2

__Namespace

Type de données : CIM_STRING

Type d'accès : Lecture seule

Nom de l’espace de noms de la classe ou instance.

Exemple : root\cimv2

__Path

Type de données : CIM_STRING

Type d'accès : Lecture seule

Chemin d’accès complet à la classe ou instance, incluant le serveur et l’espace de noms.

Example : \\MyServer\root\cimv2:Win32_OptionalFeature.Name="TelnetClient"

__Property_Count

Type de données : CIM_SINT32

Type d'accès : Lecture seule

Nombre de propriétés étrangères au système définies pour la classe ou l’instance.

Exemple : 6

__Relpath

Type de données : CIM_STRING

Type d'accès : Lecture seule

Chemin relatif à la classe ou à l’instance.

Exemple : Win32_OptionalFeature.Name= « TelnetClient »

__Server

Type de données : CIM_STRING

Type d'accès : Lecture seule

Nom du serveur fournissant la classe ou l’instance.

Exemple : MyServer

__Superclass

Type de données : CIM_STRING

Type d'accès : Lecture seule

Nom de la classe parente immédiate de la classe ou de l’instance.

Exemple : CIM_LogicalElement

Le code PowerShell suivant récupère les propriétés de la classe Win32_OptionalFeature, qui inclut les propriétés système.

Get-WmiObject win32_OptionalFeature | Where-Object {$_.name -eq "TelnetClient"}

L’exemple de code précédent retourne ce qui suit :

__GENUS          : 2
__CLASS          : Win32_OptionalFeature
__SUPERCLASS     : CIM_LogicalElement
__DYNASTY        : CIM_ManagedSystemElement
__RELPATH        : Win32_OptionalFeature.Name="TelnetClient"
__PROPERTY_COUNT : 6
__DERIVATION     : {CIM_LogicalElement, CIM_ManagedSystemElement}
__SERVER         : myServer
__NAMESPACE      : root\cimv2
__PATH           : \\myServer\root\cimv2:Win32_OptionalFeature.Name="TelnetClient"
Caption          : Telnet Client
Description      : 
InstallDate      : 
InstallState     : 2
Name             : TelnetClient
Status           : 
PSComputerName   : myServer