Propriétés 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, les distinguent des propriétés créées par des applications ou des fournisseurs qui ne doivent pas commencer par un trait de soulignement unique 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 sont extraits des propriétés système de la classe Win32_OptionalFeature, qui sont décrites en bas de cette rubrique.

__Class

Type de données : CIM_STRING

Type d’accès : 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 : 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, la suivante 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 de __Class sont identiques.

Exemple : CIM_ManagedSystemElement

__Genus

Type de données : CIM_SINT32

Type d’accès : lecture seule

Valeur utilisée pour distinguer 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 de l’instance.

Exemple : root\cimv2

__Path

Type de données : CIM_STRING

Type d’accès : lecture seule

Chemin complet de la classe ou de l’instance, y compris le serveur et l’espace de noms.

Exemple : \\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 non 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 de la classe ou de 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 les éléments suivants :

__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