Msvm_SummaryInformationBase-Klasse

Artikel
06/13/2023

Wird in der GetSummaryInformation-Methode in der Msvm_VirtualSystemManagementService-Klasse verwendet, um schnell allgemeine Informationen im Zusammenhang mit einem virtuellen System oder Momentaufnahme abzurufen.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

[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;
};

Member

Die Msvm_SummaryInformationBase-Klasse verfügt über folgende Membertypen:

Eigenschaften

Eigenschaften

Die Msvm_SummaryInformationBase-Klasse verfügt über diese Eigenschaften.

CreationTime

Datentyp: DateTime
Zugriffstyp: Schreibgeschützt

Der Zeitpunkt, zu dem das virtuelle System oder Momentaufnahme erstellt wurde.

ElementName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Außerkraftsetzung ("CIM_ManagedElement.ElementName")

Der Anzeigename für das virtuelle System oder Momentaufnahme.

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der aktuelle Zustand des virtuellen Systems oder Momentaufnahme.

EnhancedSessionModeState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt an, ob Verbindungen im erweiterten Modus vom Host zugelassen werden oder nicht und ob sie für den virtuellen Computer verfügbar sind oder nicht.

Zulässig und verfügbar (2)

Nicht zulässig (3)

Zulässig, aber nicht verfügbar (6)

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der aktuelle Integritätsstatus für das virtuelle System. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die ein virtuelles System Momentaufnahme darstellen.

HostComputerSystemName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Name des Computers, auf dem dieser virtuelle Computer gehostet wird.

InstanceID

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Außerkraftsetzung ("CIM_ManagedElement.InstanceID"), Schlüssel

InstanceID ist eine optionale Eigenschaft, die verwendet werden kann, um eine instance dieser Klasse im Bereich des instanziierenden Namespace nicht transparent und eindeutig zu identifizieren. Verschiedene Unterklassen dieser Klasse können diese Eigenschaft außer Kraft setzen, um sie erforderlich zu machen, oder einen Schlüssel. Solche Unterklassen können auch die bevorzugten Algorithmen ändern, um die Eindeutigkeit sicherzustellen, die unten definiert sind.

Um die Eindeutigkeit innerhalb des NameSpace sicherzustellen, sollte der Wert von InstanceID mit dem folgenden "bevorzugten" Algorithmus erstellt werden:

Dabei <sind OrgID> und <LocalID> durch einen Doppelpunkt (:) getrennt, wobei <OrgID> einen urheberrechtlich geschützten, geschützten oder anderweitig eindeutigen Namen enthalten muss, der sich im Besitz der Geschäftsentität befindet, die die InstanceID erstellt oder definiert, oder bei der es sich um eine registrierte ID handelt, die der Geschäftsentität von einer anerkannten globalen Autorität zugewiesen wurde. (Diese Anforderung ähnelt der < Schemaname>\_<Klassenname-Struktur> von Schemaklassennamen.) Um die Eindeutigkeit sicherzustellen, <darf OrgID> außerdem keinen Doppelpunkt (:) enthalten. Bei Verwendung dieses Algorithmus muss der erste Doppelpunkt, der in InstanceID angezeigt wird, zwischen <OrgID> und <LocalID> angezeigt werden.

<LocalID> wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um verschiedene zugrunde liegende (reale) Elemente zu identifizieren. Wenn nicht NULL und der oben genannte "bevorzugte" Algorithmus nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht für alle InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern für den NameSpace dieser instance erstellt wurden.

Wenn für DMTF-definierte Instanzen nicht auf NULL festgelegt ist, muss der "bevorzugte" Algorithmus verwendet werden, wobei die <OrgID> auf CIM festgelegt ist.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der eindeutige Name für das virtuelle System oder Momentaufnahme.

Hinweise

Datentyp: string
Zugriffstyp: Schreibgeschützt

Die Notizen, die dem virtuellen System oder Momentaufnahme zugeordnet sind.

NumberOfProcessors

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der virtuellen Prozessoren, die dem virtuellen System oder Momentaufnahme zugeordnet sind.

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Die aktuelle status des Elements.

OtherEnabledState

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 ("Sonstige") festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState ein anderer Wert als 1 ist.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben.

Verfügbarkeit

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Die Zeitspanne seit dem letzten Start des virtuellen Systems. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die ein virtuelles System Momentaufnahme darstellen.

Version

Datentyp: string
Zugriffstyp: Schreibgeschützt

Die Version des virtuellen Systems im Format "major.minor"; beispiel: "2.0".

VirtualSwitchNames

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Zeichenfolgen, die die Anzeigenamen der virtuellen Switches auflisten, mit denen die VM verbunden ist.

VirtualSystemSubType

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Untertyp des virtuellen Systems.

Microsoft:Hyper-V:SubType:1 ("Microsoft:Hyper-V:SubType:1")

Microsoft:Hyper-V:SubType:2 ("Microsoft:Hyper-V:SubType:2")

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016
Namespace	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

CIM_View

Freigeben über