Partager via

Classe CIM_ManagedSystemElement

  • Article

Classe de base pour la hiérarchie d’élément système. Tout composant distinctif du système est candidat à l’inclusion dans cette classe. Il s’agit par exemple de composants logiciels, comme les fichiers, d’appareils, comme les lecteurs de disques et les contrôleurs, et de composants physiques, comme les circuits et les cartes.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

[UMLPackagePath("CIM::Core::CoreElements"), Abstract, Version("2.22.0"), AMENDMENT]
class CIM_ManagedSystemElement : CIM_ManagedElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
};

Membres

La classe CIM_ManagedSystemElement a ces types de membres :

Propriétés

La classe CIM_ManagedSystemElement a ces propriétés.

Caption

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : MaxLen (64)

Contient une brève description textuelle de l’objet.

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

CommunicationStatus

Type de données : uint16

Type d’accès : Lecture seule

Indique la capacité de l’instrumentation à communiquer avec cet élément. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

Valeurs Signification
Unknown
0
 Indique que l’instrumentation ne peut pas signaler la propriété CommunicationStatus pour l’instant.
Non disponible
1
 Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne le fait pas intentionnellement pour cet élément.
Communication OK
2
 Indique uniquement que la communication est établie avec l’élément.
Perte de communication
3
 Indique que l’élément a été contacté dans le passé, mais qu’il est actuellement injoignable.
Aucun contact
4
 Indique que l’instrumentation possède des coordonnées pour cet élément, mais n’a jamais pu communiquer avec ces derniers.
DMTF réservé
5 32767
 Réservé.
Vendeur réservé
32768 = valeur
Réservé.

Description

Type de données : chaîne

Type d’accès : Lecture seule

Fournit une description textuelle de l’objet.

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

DetailedStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_EnabledLogicalElement.PrimaryStatus », « CIM_ManagedSystemElement.HealthState »)

Indique des détails d’état supplémentaires qui complètent la propriété PrimaryStatus. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

Valeurs Signification
Non disponible
0
 Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne la signale pas intentionnellement pour cet élément.
Aucune information supplémentaire
1
 Indique qu’aucun détail ne doit être ajouté à la propriété PrimaryStatus, par exemple lorsque PrimaryStatus est défini sur OK.
Sous pression
2
 Indique que l’élément fonctionne, mais nécessite une attention particulière. La surcharge et la surchauffe sont des exemples d’états Sous pression.
Prévention d’erreur
3
 Indique si un élément fonctionne nominalement, mais prédit une défaillance dans un avenir proche.
Erreur non récupérable
4
 Indique que cet élément est dans une condition d’erreur qui nécessite une intervention humaine.
Entité de prise en charge liée à l’erreur
5
 Indique qu’un élément sur lequel dépend cet élément est en erreur. Cet élément peut être OK, mais ne peut pas fonctionner en raison de l’état d’un élément dépendant. Par exemple, un service réseau ou un point de terminaison qui ne peut pas fonctionner en raison de problèmes de mise en réseau de couche inférieure.
DMTF réservé
6 32767
 Réservé.
Vendeur réservé
32768 = valeur
Réservé.

ElementName

Type de données : chaîne

Type d’accès : Lecture seule

Contient un nom convivial pour l’objet. Cette propriété permet à chaque instance de définir un nom convivial en plus de ses propriétés clés, ses données d’identité et ses informations de description.

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

HealthState

Type de données : uint16

Type d’accès : Lecture seule

Indique l’intégrité actuelle de l’élément. Cet attribut exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants.

Valeurs Signification
Unknown
0
 L’implémentation ne peut rien signaler sur HealthState pour l’instant.
OK
5
 L’élément est entièrement fonctionnel et fonctionne dans des paramètres opérationnels normaux et sans erreur.
Détérioré/Avertissement
10
 L’élément est dans l’ordre de travail et toutes les fonctionnalités sont fournies. Toutefois, l’élément ne fonctionne pas au meilleur de ses capacités. Par exemple, l’élément peut ne pas fonctionner de manière optimale ou signaler des erreurs récupérables
Échec mineur
15
 Toutes les fonctionnalités sont disponibles, mais certaines peuvent être dégradées.
Échec majeur
20
 L’élément échoue. Il est possible que certaines ou toutes les fonctionnalités de ce composant soient dégradées ou ne fonctionnent pas.
Échecs critiques
25
 L’élément n’est pas fonctionnel et la récupération peut ne pas être possible.
Erreur non récupérable
30
 L’élément a échoué complètement et la récupération n’est pas possible. Toutes les fonctionnalités fournies par cet élément ont été perdues.
DMTF réservé
31 = valeur
DMTF a réservé la partie inutilisée du continuum pour des valeurs HealthStates supplémentaires à l’avenir.

InstallDate

Type de données : DateHeure

Type d’accès : Lecture seule

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

InstanceID

Type de données : chaîne

Type d’accès : Lecture seule

Identifie de manière opaque et unique une instance de cette classe dans le cadre de l’espace de noms contenant.

[!Important]Pour garantir l’unicité dans l’espace de noms, la valeur d’InstanceID doit être construite selon le modèle suivant :

OrgID:LocalID

OrgID doit inclure un nom protégé par droit d’auteur, une marque ou un nom unique appartenant à l’entité commerciale définissant InstanceID, ou être un ID inscrit attribué par une autorité globale reconnue. Il s’agit d’une structure similaire à la structure des noms de classe Schema. De plus, pour garantir l’unicité, le premier signe deux-points dans InstanceID doit être compris entre OrgID et LocalID. Pour cela, OrgID ne doit pas contenir de signe deux-points (’:’).

LocalID est choisi par l’entité commerciale et ne doit pas être réutilisé pour identifier différents éléments sous-jacents du monde réel.

Si le modèle ci-dessus n’est pas utilisé, l’entité de définition doit garantir que l’InstanceID résultant n’est pas réutilisé dans les InstanceID produits par ce fournisseur ou par d’autres pour cet espace de noms.

Pour les instances définies par la DMTF (Distributed Management Task Force), le modèle doit être utilisé avec OrgID défini sur CIM.

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

Nom

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : MaxLen (1024)

Indique le nom convivial de cette instance d’un projet. De plus, le nom convivial peut être utilisé comme propriété pour une recherche ou une requête.

[Conseil]
Il n’est pas nécessaire que le nom soit unique dans un espace de noms.

OperatingStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_EnabledLogicalElement.EnabledState »)

Indique la condition opérationnelle actuelle de l’élément. Cette propriété peut être utilisée pour fournir plus de détails sur l’état actuel de l’élément. Elle peut également indiquer des états transitoires. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

Valeur Signification
Unknown
0
 Indique que l’instrumentation ne peut pas signaler la propriété OperatingStatus pour l’instant.
Non disponible
1
 Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne la signale pas intentionnellement pour cet élément.
Maintenance
2
 Indique que l’élément est en cours de configuration, de maintenance, de nettoyage ou de gestion.
Démarrage en cours
3
 Indique que l’élément est en cours d’initialisation.
En cours d’arrêt
4
 Indique que l’élément est en cours d’arrêt de manière ordonnée.
Arrêté
5
 Indique que l’élément est volontairement arrêté.
Abandonné
6
 Indique que l’élément s’est arrêté de manière inattendue.
Dormant
7
 Indique que l’élément est inactif ou suspendu.
Terminé
8
 Indique que l’élément a terminé son opération. Il est recommandé d’utiliser une valeur de propriété PrimaryStatus de type OK, Erreur ou Dégradé pour indiquer le succès ou l’échec de l’opération.
Migration
9
 Indique que l’élément est déplacé entre les éléments hôtes.
Émigration
10
 Indique que l’élément est déplacé de l’élément hôte.
Immigration
11
 Indique que l’élément est déplacé vers un nouvel élément hôte.
Instantané
12
 Indique qu’une copie instantanée de l’élément est en cours de création.
Arrêt en cours
13
 Indique que l’élément s’arrête brusquement.
En test
14
 Indique que l’élément exécute des fonctions de test.
Transition en cours
15
 Indique que l’élément se trouve entre deux états et qu’il n’est pas entièrement disponible dans l’un ou l’autre état. Utilisez une autre valeur qui indique une transition plus spécifique si elle est disponible.
En service
16
 Indique que l’élément est en service et opérationnel.
DMTF réservé
17 32767
 Réservé.
Vendeur réservé
32768 = valeur
Réservé.

OperationalStatus

Type de données : tableau uint16

Type d’accès : Lecture seule

Qualificateurs : ArrayType (« Indexed »), ModelCorrespondence (« CIM_ManagedSystemElement.StatusDescriptions »)

Contient des indicateurs de l’état actuel de l’élément. La première valeur de OperationalStatus doit contenir l’état principal de l’élément.

Remarque

OperationalStatus remplace la propriété Status déconseillée. En raison de l’utilisation généralisée de la propriété Status existante dans les applications de gestion, Microsoft recommande vivement aux fournisseurs ou à l’instrumentation de fournir à la fois les propriétés Status et OperationalStatus. Lorsqu’il est instrumenté, Status (car il s’agit d’une propriété à valeur unique) doit également fournir l’état principal de l’élément.

Valeurs Signification
Unknown
0
 Indique que l’implémentation ne peut rien signaler sur OperationalStatus pour l’instant.
Autres
1
 Indique un état non défini.
OK
2
 Indique les fonctionnalités complètes sans erreurs.
Détérioré
3
 Indique que l’élément fonctionne et que toutes les fonctionnalités sont fournies. Toutefois, l’élément ne fonctionne pas au meilleur de ses capacités. Par exemple, l’élément peut ne pas fonctionner de manière optimale ou signaler des erreurs récupérables
Sous pression
4
 Indique que l’élément fonctionne, mais a besoin d’attention. La surcharge et la surchauffe sont des exemples d’états Sous pression.
Prévention d’erreur
5
 Indique qu’un élément fonctionne nominalement, mais prédit une défaillance dans un avenir proche.
Error
6
 Indique qu’une erreur s’est produite.
Erreur non récupérable
7
 Une erreur non récupérable s’est produite.
Démarrage en cours
8
 Le projet commence.
En cours d’arrêt
9
 Le projet s’arrête.
Arrêté
10
 L’élément a été volontairement arrêté.
En service
11
 Indique que l’élément est configuré, géré, nettoyé ou administré.
Aucun contact
12
 Indique que le système de surveillance a connaissance de cet élément, mais n’a jamais été en mesure d’établir des communications avec celui-ci.
Perte de communication
13
 Indique que le projet est connu pour exister et a été contacté avec succès dans le passé, mais est actuellement inaccessible.
Abandonné
14
 Indique que le projet s’est arrêté de manière inattendue. L’état et la configuration du projet doivent peut-être être mis à jour.
Dormant
15
 Indique que le projet est inactif.
Entité de prise en charge liée à l’erreur
16
 Indique qu’un élément sur lequel dépend ce projet est en erreur. Cet élément peut être OK, mais ne peut pas fonctionner en raison de l’état d’un élément dépendant. Par exemple, un service réseau ou un point de terminaison qui ne peut pas fonctionner en raison de problèmes de mise en réseau de couche inférieure.
Terminé
17
 Indique que le projet a terminé son opération. Cette valeur doit être combinée à OK, Erreur ou Détérioré afin qu’un client puisse indiquer si l’opération terminée s’est Terminée avec OK (réussie), Terminée avec erreur (échouée) ou Terminée avec détérioré (l’opération s’est terminée, mais elle n’a pas terminé OK ou n’a pas fait état d’une erreur).
Power Mode
18
 Le « mode de puissance » indique que l’élément contient des informations supplémentaires sur le modèle d’alimentation contenues dans l’association PowerManagementService associée.
DMTF réservé
19 32767
 DMTF a réservé cette partie de la plage pour des valeurs OperationalStatus supplémentaires à l’avenir.
Vendeur réservé
32768 65535
 Microsoft a réservé la partie inutilisée de la plage pour d’autres valeurs OperationalStatus à l’avenir.

PrimaryStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_ManagedSystemElement.DetailedStatus », « CIM_ManagedSystemElement.HealthState »)

Indique une valeur d’état de haut niveau.

Les valeurs possibles sont les suivantes.

Inconnu (0)

OK (1)

Dégradé (2)

Erreur (3)

DMTF réservé (4 32767)

Réservé au fournisseur (32768 = valeur)

État

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : Déceonseillé (« CIM_ManagedSystemElement.OperationalStatus »), MaxLen (10)

Contient une chaîne indiquant l’état primaire de l’objet.

Remarque

Cette propriété est déconseillée et remplacée par la propriété OperationalStatus. Si vous choisissez d’utiliser la propriété Status pour la compatibilité descendante, elle doit être secondaire à la propriété OperationalStatus.

Les valeurs possibles sont les suivantes.

(« OK »)

(« Erreur »)

(« Détérioré »)

(« Inconnu »)

(« Défaillance prédictive »)

(« Démarrage »)

(« Arrêt »)

(« Service »)

(« Sous pression »)

(« Non récupérable »)

(« Aucun contact »)

(« Perte de communication »)

(« Arrêté »)

StatusDescriptions

Type de données : tableau de chaînes

Type d’accès : Lecture seule

Qualificateurs : ArrayType (« Indexed »), ModelCorrespondence (« CIM_ManagedSystemElement.OperationalStatus »)

Indique les descriptions des valeurs correspondantes dans le tableau OperationalStatus. Par exemple, si un élément de la propriété OperationalStatus contient la valeur Arrêt, l’élément au même index de tableau de cette propriété peut contenir une explication quant à la raison pour laquelle un objet est arrêté.

Spécifications
Client minimal pris en charge
 Windows 8
Serveur minimal pris en charge
 Windows Server 2012
Espace de noms
 Root\standardcimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Voir aussi

CIM_ManagedElement