CIM_PhysicalElement classe

Les sous-classes CIM_PhysicalElement définissent n’importe quel composant d’un système qui a une identité physique distincte. Les instances de cette classe peuvent être définies en termes d’étiquettes qui peuvent être physiquement attachées à l’objet . Tous les processus, fichiers et périphériques logiques ne sont pas considérés comme des éléments physiques. Par exemple, il n’est pas possible d’attacher une étiquette à un modem ; il est uniquement possible d’attacher une étiquette au carte qui implémente le modem. Le même carte peut également implémenter un adaptateur LAN.

Les éléments système managés tangibles (généralement des éléments matériels) ont une manifestation physique. Un élément de système managé n’est pas nécessairement un composant discret. Par exemple, il est possible qu’un seul carte (un type d’élément physique) héberge plusieurs appareils logiques. Le carte serait représenté par un seul élément physique associé à plusieurs périphériques logiques.

Important

Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont créées. WMI prend actuellement uniquement en charge les schémas de version CIM 2.x.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes ses propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Abstract, UUID("{FAF76B61-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
class CIM_PhysicalElement : CIM_ManagedSystemElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   CreationClassName;
  string   Manufacturer;
  string   Model;
  string   OtherIdentifyingInfo;
  string   PartNumber;
  boolean  PoweredOn;
  string   SerialNumber;
  string   SKU;
  string   Tag;
  string   Version;
};

Membres

La classe CIM_PhysicalElement comporte les types de membres suivants :

• Propriétés

Propriétés

La classe CIM_PhysicalElement a ces propriétés.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key, MaxLen (256)

Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété permet à toutes les instances de la classe et à ses sous-classes d’être identifiées de manière unique.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

Fabricant

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Nom du organization responsable de la production de l’élément physique. Pour plus d’informations, consultez la propriété Vendor de CIM_Product.

Modèle

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Nom par lequel l’élément physique est généralement connu.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Name »)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé.

Cette propriété est héritée de CIM_ManagedSystemElement.

OtherIdentifyingInfo

Type de données : chaîne

Type d'accès : Lecture seule

Données supplémentaires, au-delà des informations de balise de ressource, qui peuvent être utilisées pour identifier un élément physique. Par exemple, les données de code-barres associées à un élément, qui a également une balise de ressource. Notez que si seules les données de code-barres sont disponibles et sont uniques et peuvent être utilisées comme clé d’élément, cette propriété est null et les données de code-barres sont utilisées comme clé de classe dans la propriété Tag .

PartNumber

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Numéro de référence attribué par le organization responsable de la production ou de la fabrication de l’élément physique.

PoweredOn

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est TRUE, l’élément physique est sous tension. Sinon, il est actuellement désactivé.

SerialNumber

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Numéro alloué par le fabricant utilisé pour identifier l’élément physique.

Référence SKU

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Numéro d’unité stock pour cet élément physique.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Les status opérationnelles et non opérationnelles peuvent être définies. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Tag

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key, MaxLen (256)

Identifie de manière unique l’élément physique et sert de clé de l’élément. Cette propriété peut contenir des informations, telles que des données d’étiquette de ressource ou de numéro de série. La clé pour CIM_PhysicalElement est placée très haut dans la hiérarchie des objets pour identifier indépendamment le matériel ou l’entité, indépendamment de l’emplacement physique dans (ou sur) les armoires, les adaptateurs, etc. Par exemple, un composant amovible qui peut être échangé à chaud peut être extrait de son package contenant (étendue) et être temporairement inutilisé. L’objet continue d’exister et peut même être inséré dans un autre conteneur d’étendue. La clé d’un élément physique est une chaîne arbitraire qui est définie indépendamment de la hiérarchie orientée emplacement ou de placement.

Version

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Indique la version de l’élément physique.

Notes

WMI n’implémente pas cette classe. Pour les classes WMI dérivées de CIM_PhysicalElement, consultez Classes Win32.

Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du Kit de développement logiciel (SDK) Microsoft ou fournir des informations supplémentaires.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

CIM_ManagedSystemElement