Msvm_SummaryInformation classe

Article
06/13/2023

Utilisé dans les méthodes GetSummaryInformation et GetDefinitionFileSummaryInformation de la classe Msvm_VirtualSystemManagementService pour récupérer rapidement des informations courantes relatives à une machine virtuelle ou à un instantané.

La syntaxe suivante est le code MOF (Managed Object Format) simplifié.

Syntaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformation : Msvm_SummaryInformationBase
{
  string                       InstanceID;
  string                       AllocatedGPU;
  boolean                      Shielded;
  CIM_ConcreteJob              AsynchronousTasks[];
  DateTime                     CreationTime;
  string                       ElementName;
  uint16                       EnabledState;
  string                       OtherEnabledState;
  string                       GuestOperatingSystem;
  uint16                       HealthState;
  uint16                       Heartbeat;
  uint64                       MemoryUsage;
  sint32                       MemoryAvailable;
  sint32                       AvailableMemoryBuffer;
  boolean                      SwapFilesInUse;
  string                       Name;
  string                       Notes;
  string                       Version;
  uint16                       NumberOfProcessors;
  uint16                       OperationalStatus[];
  uint16                       ProcessorLoad;
  uint16                       ProcessorLoadHistory[];
  CIM_VirtualSystemSettingData Snapshots[];
  string                       StatusDescriptions[];
  uint8                        ThumbnailImage[];
  uint16                       ThumbnailImageHeight;
  uint16                       ThumbnailImageWidth;
  uint64                       UpTime;
  uint16                       ReplicationState;
  uint16                       ReplicationStateEx[];
  uint16                       ReplicationHealth;
  uint16                       ReplicationHealthEx[];
  uint16                       ReplicationMode;
  CIM_ComputerSystem       REF TestReplicaSystem;
  uint16                       ApplicationHealth;
  uint16                       IntegrationServicesVersionState;
  boolean                      MemorySpansPhysicalNumaNodes;
  string                       ReplicationProviderId[];
  uint16                       EnhancedSessionModeState;
  string                       VirtualSwitchNames[];
  string                       VirtualSystemSubType;
  string                       HostComputerSystemName;
};

Membres

La classe Msvm_SummaryInformation comporte les types de membres suivants :

Propriétés

Propriétés

La classe Msvm_SummaryInformation a ces propriétés.

Allocation de processeurs de groupe

Type de données : chaîne
Type d'accès : Lecture seule

Identificateur de l’unité de traitement graphique physique (GPU) allouée à cette machine virtuelle. Cette propriété s’applique uniquement aux machines virtuelles qui utilisent RemoteFX.

ApplicationHealth

Type de données : uint16
Type d'accès : Lecture seule

L’intégrité de l’application actuelle status pour la machine virtuelle. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

OK (2)

Critique pour l’application (32782)

Désactivé (32896)

Tâches asynchrones

Type de données : tableau CIM_ConcreteJob
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

Tableau d’instances Msvm_ConcreteJob qui représentent toutes les opérations asynchrones liées à la machine virtuelle en cours d’exécution. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

AvailableMemoryBuffer

Type de données : sint32
Type d'accès : Lecture seule

Pourcentage de mémoire tampon disponible pour la machine virtuelle. Lorsque la mémoire dynamique est activée pour une machine virtuelle, cette propriété représente le ratio entre la mémoire tampon disponible et la mémoire tampon idéale pour la machine virtuelle. La taille de mémoire tampon idéale est configurée à l’aide de la propriété TargetMemoryBuffer de la classe Msvm_MemorySettingData .

Cette propriété n’est pas valide pour les instances de la classe Msvm_SummaryInformation qui représentent des machines virtuelles pour lesquelles la mémoire dynamique n’est pas activée.

Cette propriété n’est pas valide pour les instances de la classe Msvm_SummaryInformation qui représentent une machine virtuelle instantané.

CreationTime

Type de données : DateTime
Type d'accès : Lecture seule

Heure à laquelle la machine virtuelle ou le instantané a été créé.

ElementName

Type de données : chaîne
Type d'accès : Lecture seule

Nom complet de la machine virtuelle ou du instantané.

EnabledState

Type de données : uint16
Type d'accès : Lecture seule

État actuel de la machine virtuelle ou du instantané. Consultez la propriété EnabledState de la classe Msvm_ComputerSystem pour connaître les valeurs possibles.

EnhancedSessionModeState

Type de données : uint16
Type d'accès : Lecture seule

Indique si les connexions en mode amélioré sont autorisées par l’hôte et, si elles sont autorisées, si elles sont disponibles pour la machine virtuelle.

Windows 8.1 : cette valeur n’est pas prise en charge tant qu’Windows 8.1 et Windows Server 2012 R2.

Autorisé et disponible (2)

Non autorisé (3)

Autorisé mais non disponible (6 )

GuestOperatingSystem

Type de données : chaîne
Type d'accès : Lecture seule

Nom du système d’exploitation invité, s’il est disponible. Si ces informations ne sont pas disponibles, la valeur de cette propriété est Null. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

HealthState

Type de données : uint16
Type d'accès : Lecture seule

État d’intégrité actuel de la machine virtuelle. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

Pulsation

Type de données : uint16
Type d'accès : Lecture seule

La pulsation actuelle status pour la machine virtuelle. Pour plus d’informations, consultez la documentation relative à la propriété StatusDescriptions de la classe Msvm_HeartbeatComponent . Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

OK (2)
Erreur (6)
Aucun contact (12)
Perte de communication (13)

HostComputerSystemName

Type de données : chaîne
Type d'accès : Lecture seule

Nom de l’ordinateur hébergeant cette machine virtuelle.

Notes

Ajouté dans Windows 10.

InstanceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Override (« CIM_ManagedElement.InstanceID »), Clé

InstanceID est une propriété facultative qui peut être utilisée pour identifier de manière opaque et unique un instance de cette classe dans l’étendue de l’espace de noms instanciant. Différentes sous-classes de cette classe peuvent remplacer cette propriété pour la rendre obligatoire, ou une clé. Ces sous-classes peuvent également modifier les algorithmes préférés pour garantir l’unicité définis ci-dessous.

Pour garantir l’unicité dans NameSpace, la valeur de InstanceID doit être construite à l’aide de l’algorithme « préféré » suivant :

Où <OrgID> et <LocalID> sont séparés par un signe deux-points (:), et où <OrgID> doit inclure un nom protégé par un droit d’auteur, une marque déposée ou un nom unique appartenant à l’entité commerciale qui crée ou définit l’InstanceID ou qui est un ID enregistré attribué à l’entité commerciale par une autorité globale reconnue. (Cette exigence est similaire à la < Structure de><nom> de classe de nom de schéma des noms de classe de schéma.) En outre, pour garantir l’unicité, <OrgID> ne doit pas contenir de deux-points (:). Lors de l’utilisation de cet algorithme, le premier signe deux-points à apparaître dans InstanceID doit apparaître entre <OrgID> et <LocalID>.

<LocalID> est choisi par l’entité métier et ne doit pas être réutilisé pour identifier différents éléments sous-jacents (réels). Si la valeur n’est pas null et que l’algorithme « préféré » ci-dessus n’est pas utilisé, l’entité de définition doit s’assurer que l’InstanceID résultant n’est pas réutilisé sur les ID d’instance produits par ce fournisseur ou par d’autres fournisseurs pour le NameSpace de cette instance.

S’il n’est pas défini sur null pour les instances définies par DMTF, l’algorithme « préféré » doit être utilisé avec l’OrgID <> défini sur CIM.

Notes

Ajouté dans Windows 10.

IntegrationServicesVersionState

Type de données : uint16
Type d'accès : Lecture seule

Indique si les services d’intégration installés sur la machine virtuelle sont à jour.

Inconnu (0)

UpToDate (1)

Incompatibilité (2)

MemoryAvailable

Type de données : sint32
Type d'accès : Lecture seule

Pourcentage de la mémoire actuelle disponible pour la machine virtuelle. Lorsque la mémoire dynamique est activée pour une machine virtuelle, cette propriété représente le rapport entre la mémoire disponible de la machine virtuelle et la mémoire physique totale affectée à la machine virtuelle. Lorsqu’une machine virtuelle n’a pas de mémoire disponible, cette propriété est négative et contient le ratio de mémoire nécessaire pour la machine virtuelle par rapport à la mémoire physique totale affectée à la machine virtuelle.

Cette propriété n’est pas valide pour les instances de la classe Msvm_SummaryInformation qui représentent des machines virtuelles pour lesquelles la mémoire dynamique n’est pas activée.

Cette propriété n’est pas valide pour les instances de la classe Msvm_SummaryInformation qui représentent une machine virtuelle instantané.

MemorySpansPhysicalNumaNodes

Type de données : booléen
Type d'accès : Lecture seule

Indique si la mémoire d’un ou plusieurs des nœuds d’accès à la mémoire virtuelle non uniforme (NUMA) de la machine virtuelle s’étend sur plusieurs nœuds NUMA physiques du système informatique hôte. Contient True si la mémoire s’étend sur plusieurs nœuds NUMA physiques ou False dans le cas contraire.

MemoryUsage

Type de données : uint64
Type d'accès : Lecture seule

Utilisation actuelle de la mémoire, en mégaoctets, de la machine virtuelle. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

Nom

Type de données : chaîne
Type d'accès : Lecture seule

Nom unique de la machine virtuelle ou du instantané.

Remarques

Type de données : chaîne
Type d'accès : Lecture seule

Notes associées à la machine virtuelle ou instantané.

NumberOfProcessors

Type de données : uint16
Type d'accès : Lecture seule

Nombre total de processeurs virtuels alloués à la machine virtuelle ou instantané.

OperationalStatus

Type de données : tableau uint16
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

État opérationnel actuel de la machine virtuelle. Pour connaître les valeurs possibles, consultez la propriété OperationalStatus de la classe Msvm_ComputerSystem .

OtherEnabledState

Type de données : chaîne
Type d'accès : Lecture seule

Chaîne qui décrit l’état activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1. Cette propriété est définie sur Null lorsque EnabledState a une valeur autre que 1.

ProcessorLoad

Type de données : uint16
Type d'accès : Lecture seule

Utilisation actuelle du processeur de la machine virtuelle, en pourcentage. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

ProcessorLoadHistory

Type de données : tableau uint16
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

Tableau des 100 exemples précédents de l’utilisation du processeur, en pourcentage, pour la machine virtuelle. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation qui représentent un instantané de machine virtuelle.

ReplicationHealth

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : déconseillé (« Msvm_SummaryInformation. ReplicationHealthEx »)

Intégrité de la réplication de la machine virtuelle. Pour connaître les valeurs possibles, consultez la propriété ReplicationHealth de la classe Msvm_ComputerSystem .

Notes

Cette propriété est déconseillée à partir de Windows 8.1 ; utilisez plutôt ReplicationHealthEx.

Non applicable (0)

Ok (1)

Avertissement (2)

Critique (3)

ReplicationHealthEx

Type de données : tableau uint16
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

Tableau des valeurs d’intégrité de réplication pour les différentes relations de réplication de la machine virtuelle. Pour connaître les valeurs possibles, consultez la propriété ReplicationHealth de la classe Msvm_ReplicationRelationship .

Non applicable (0)

Ok (1)

Avertissement (2)

Critique (3)

ReplicationMode

Type de données : uint16
Type d'accès : Lecture seule

Type de réplication de la machine virtuelle. Consultez la propriété ReplicationMode de la classe Msvm_ComputerSystem pour connaître les valeurs possibles.

Aucun (0)

Principal (1)

Réplica (2)

Réplica de test (3)

Réplica étendu (4)

ReplicationProviderId

Type de données : tableau de chaînes
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

Pour la machine virtuelle principale ou étendue réplica, il s’agit de l’ID du fournisseur de réplication principal. Pour une machine virtuelle réplica et si la réplication étendue est activée, il s’agit de l’ID de fournisseur pour la relation étendue.

Windows 8.1 : cette valeur n’est pas prise en charge tant qu’Windows 8.1 et Windows Server 2012 R2.

ReplicationState

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : déconseillé (« Msvm_SummaryInformation. ReplicationStateEx »)

État de réplication de la machine virtuelle. Pour connaître les valeurs possibles, consultez la propriété ReplicationState de la classe Msvm_ComputerSystem .

Notes

Cette propriété est déconseillée à partir de Windows 8.1 ; à la place, utilisez ReplicationStateEx.

Désactivé (0)

Prêt pour la réplication (1)

Attente de la fin de la réplication initiale (2)

Réplication (3)

Réplication synchronisée terminée (4)

Récupéré (5)

Commit (6)

Suspendu (7)

Critique (8)

Attente de démarrer la resynchronisation (9)

Resynchronisation (10)

Resynchronisation suspendue (11)

Basculement en cours (12)

ReplicationStateEx

Type de données : tableau uint16
Type d'accès : Lecture seule
Qualificateurs : ArrayType (« Indexed »)

Tableau des valeurs d’état de réplication pour les différentes relations de réplication de la machine virtuelle. Pour connaître les valeurs possibles, consultez la propriété ReplicationState de la classe Msvm_ReplicationRelationship .

Désactivé (0)

Prêt pour la réplication (1)

Attente de la fin de la réplication initiale (2)

Réplication (3)

Réplication synchronisée terminée (4)

Récupéré (5)

Commit (6)

Suspendu (7)

Critique (8)

Attente de démarrer la resynchronisation (9)

Resynchronisation (10)

Resynchronisation suspendue (11)

Basculement en cours (12)

Restauration automatique en cours (13)

Restauration automatique terminée (14)

Mise à jour du disque en cours (15)

Notes