Msvm_SummaryInformationBase classe

Article
06/13/2023

Utilisée dans la méthode GetSummaryInformation de la classe Msvm_VirtualSystemManagementService pour récupérer rapidement des informations courantes relatives à un système virtuel ou à un instantané.

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

[Abstract, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformationBase : CIM_View
{
  string   InstanceID;
  DateTime CreationTime;
  string   ElementName;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   HealthState;
  string   Name;
  string   Notes;
  string   Version;
  uint16   NumberOfProcessors;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  uint64   UpTime;
  uint16   EnhancedSessionModeState;
  string   VirtualSwitchNames[];
  string   VirtualSystemSubType;
  string   HostComputerSystemName;
};

Membres

La classe Msvm_SummaryInformationBase a les types de membres suivants :

Propriétés

Propriétés

La classe Msvm_SummaryInformationBase possède ces propriétés.

CreationTime

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

Heure à laquelle le système virtuel ou le instantané a été créé.

ElementName

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Remplacer (« CIM_ManagedElement.ElementName »)

Nom convivial du système virtuel ou du instantané.

EnabledState

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

État actuel du système virtuel ou du instantané.

EnhancedSessionModeState

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

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

Autorisé et disponible (2)

Non autorisé (3)

Autorisé mais non disponible (6)

HealthState

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

État d’intégrité actuel du système virtuel. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation représentant un système virtuel instantané.

HostComputerSystemName

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

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

InstanceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Remplacer (« 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 d’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 le 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é mondiale reconnue. (Cette exigence est similaire à la < Nom> de schéma\_<Structure de nom> de classe des noms de classe de schéma.) En outre, pour garantir l’unicité, <OrgID> ne doit pas contenir de deux-points (:). Lorsque vous utilisez cet algorithme, le premier signe deux-points à apparaître dans InstanceID doit apparaître entre <OrgID> et <LocalID>.

<LocalID> est choisi par l’entité commerciale et ne doit pas être réutilisé pour identifier différents éléments sous-jacents (réels). S’il 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 produites par ce fournisseur ou 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’Id d’organisation <> défini sur CIM.

Nom

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

Nom unique du système virtuel ou du instantané.

Remarques

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

Notes associées au système virtuel ou au instantané.

NumberOfProcessors

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

Nombre total de processeurs virtuels alloués au système virtuel ou au instantané.

OperationalStatus

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

Status actuelle de l’élément.

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 (« Autre »). Cette propriété doit avoir la valeur null lorsque EnabledState a une valeur autre que 1.

StatusDescriptions

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

Chaînes qui décrivent les différentes valeurs du tableau OperationalStatus .

Disponibilité

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

Durée écoulée depuis le dernier démarrage du système virtuel. Cette propriété n’est pas valide pour les instances de Msvm_SummaryInformation représentant un système virtuel instantané.

Version

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

Version du système virtuel au format « major.minor » ; par exemple, « 2.0 ».

VirtualSwitchNames

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

Chaînes qui répertorient les noms conviviaux des commutateurs virtuels auxquels la machine virtuelle est connectée.

VirtualSystemSubType

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

Sous-type du système virtuel.

Microsoft:Hyper-V:SubType:1 (« Microsoft:Hyper-V:SubType:1 »)

Microsoft:Hyper-V:SubType:2 (« Microsoft:Hyper-V:SubType:2 »)

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016
Espace de noms	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

CIM_View

Partager via