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