Msvm_SummaryInformation-Klasse
Wird in den Methoden GetSummaryInformation und GetDefinitionFileSummaryInformation in der Msvm_VirtualSystemManagementService-Klasse verwendet, um schnell allgemeine Informationen im Zusammenhang mit einem virtuellen Computer oder Momentaufnahme abzurufen.
Bei der folgenden Syntax handelt es sich um vereinfachten MOF-Code (Managed Object Format).
Syntax
[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;
};
Member
Die Msvm_SummaryInformation-Klasse verfügt über die folgenden Membertypen:
Eigenschaften
Die Msvm_SummaryInformation-Klasse verfügt über diese Eigenschaften.
-
ZugeordnetEGPU
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Bezeichner der physischen Grafikverarbeitungseinheit (GPU), die diesem virtuellen Computer zugeordnet ist. Diese Eigenschaft gilt nur für virtuelle Computer, die RemoteFX verwenden.
-
-
ApplicationHealth
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Anwendungsintegrität status für den virtuellen Computer. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
-
-
OK (2)
-
Anwendungskritisch (32782)
-
Deaktiviert (32896)
AsynchronousTasks
-
Datentyp: CIM_ConcreteJob Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Ein Array von Msvm_ConcreteJob Instanzen, die alle asynchronen Vorgänge im Zusammenhang mit dem derzeit ausgeführten virtuellen Computer darstellen. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
AvailableMemoryBuffer
-
Datentyp: sint32
-
Zugriffstyp: Schreibgeschützt
Der Prozentsatz des verfügbaren Arbeitsspeicherpuffers für den virtuellen Computer. Wenn dynamischer Arbeitsspeicher für einen virtuellen Computer aktiviert ist, stellt diese Eigenschaft das Verhältnis des verfügbaren Speicherpuffers zum idealen Speicherpuffer für den virtuellen Computer dar. Die ideale Speicherpuffergröße wird mithilfe der TargetMemoryBuffer-Eigenschaft der Msvm_MemorySettingData-Klasse konfiguriert.
Diese Eigenschaft ist ungültig für Instanzen der Msvm_SummaryInformation-Klasse , die virtuelle Computer darstellen, für die der dynamische Arbeitsspeicher nicht aktiviert ist.
Diese Eigenschaft ist ungültig für Instanzen der Msvm_SummaryInformation-Klasse, die einen virtuellen Computer Momentaufnahme darstellen.
CreationTime
-
Datentyp: DateTime
-
Zugriffstyp: Schreibgeschützt
Der Zeitpunkt, zu dem der virtuelle Computer oder Momentaufnahme erstellt wurde.
ElementName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Anzeigename für den virtuellen Computer oder Momentaufnahme.
EnabledState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Zustand des virtuellen Computers oder Momentaufnahme. Mögliche Werte finden Sie in der EnabledState-Eigenschaft der Msvm_ComputerSystem-Klasse .
EnhancedSessionModeState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob Verbindungen im erweiterten Modus vom Host zulässig sind, und falls zulässig, ob sie für den virtuellen Computer verfügbar sind.
Windows 8.1: Dieser Wert wird erst Windows 8.1 und Windows Server 2012 R2 unterstützt.
Zulässig und verfügbar (2)
Nicht zulässig (3)
Zulässig, aber nicht verfügbar (6 )
GuestOperatingSystem
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Gastbetriebssystems, sofern verfügbar. Wenn diese Informationen nicht verfügbar sind, ist der Wert dieser Eigenschaft NULL. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
HealthState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Integritätsstatus für den virtuellen Computer. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
Heartbeat
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Heartbeat status für den virtuellen Computer. Weitere Informationen finden Sie in der Dokumentation zur StatusDescriptions-Eigenschaft der Msvm_HeartbeatComponent-Klasse . Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
-
OK (2)
-
Fehler (6)
-
Kein Kontakt (12)
-
Verlorene Kommunikation (13)
HostComputerSystemName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Computers, auf dem dieser virtuelle Computer gehostet wird.
Hinweis
In Windows 10 hinzugefügt.
InstanceID
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Überschreiben ("CIM_ManagedElement.InstanceID"), Schlüssel
InstanceID ist eine optionale Eigenschaft, die verwendet werden kann, um eine instance dieser Klasse im Bereich des instanziierenden Namespace transparent und eindeutig zu identifizieren. Verschiedene Unterklassen dieser Klasse können diese Eigenschaft oder einen Schlüssel überschreiben, um sie erforderlich zu machen. 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 mithilfe des folgenden "bevorzugten" Algorithmus erstellt werden:
<OrgID>:<LocalID>
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äftseinheit befindet, die die InstanceID erstellt oder definiert, oder eine registrierte ID ist, die der Geschäftseinheit von einer anerkannten globalen Autorität zugewiesen ist. (Diese Anforderung ähnelt der < Schemaname><Klassennamenstruktur> von Schemaklassennamen.) Darüber hinaus darf OrgID> keinen Doppelpunkt (:)) enthalten, <um die Eindeutigkeit sicherzustellen. Bei Verwendung dieses Algorithmus muss der erste Doppelpunkt, der in InstanceID angezeigt wird, zwischen <OrgID> und <LocalID> angezeigt werden.
<LocalID> wird von der Geschäftseinheit 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 Instance-IDs wiederverwendet wird, die von diesem oder anderen Anbietern für den NameSpace dieser instance erstellt werden.
Wenn für DMTF-definierte Instanzen nicht auf NULL festgelegt ist, muss der "bevorzugte" Algorithmus verwendet werden, wobei die <OrgID> auf CIM festgelegt ist.
Hinweis
In Windows 10 hinzugefügt.
IntegrationServicesVersionState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die auf dem virtuellen Computer installierten Integrationsdienste auf dem neuesten Stand sind.
Unbekannt (0)
UpToDate (1)
Nicht übereinstimmend (2)
MemoryAvailable
-
Datentyp: sint32
-
Zugriffstyp: Schreibgeschützt
Der Prozentsatz des aktuellen Arbeitsspeichers, der für den virtuellen Computer verfügbar ist. Wenn dynamischer Arbeitsspeicher für einen virtuellen Computer aktiviert ist, stellt diese Eigenschaft das Verhältnis des verfügbaren Arbeitsspeichers des virtuellen Computers zum gesamten physischen Arbeitsspeicher dar, der dem virtuellen Computer zugewiesen ist. Wenn ein virtueller Computer über keinen verfügbaren Arbeitsspeicher verfügt, ist diese Eigenschaft negativ und enthält das Verhältnis des für den virtuellen Computer benötigten Arbeitsspeichers zum gesamten physischen Arbeitsspeicher, der dem virtuellen Computer zugewiesen ist.
Diese Eigenschaft ist ungültig für Instanzen der Msvm_SummaryInformation-Klasse , die virtuelle Computer darstellen, für die der dynamische Arbeitsspeicher nicht aktiviert ist.
Diese Eigenschaft ist ungültig für Instanzen der Msvm_SummaryInformation-Klasse, die einen virtuellen Computer Momentaufnahme darstellen.
MemorySpansPhysicalNumaNodes
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Arbeitsspeicher eines oder mehrerer der NUMA-Knoten (Virtual NonUniform Memory Access) des virtuellen Computers mehrere physische NUMA-Knoten des Hostcomputersystems umfasst. Enthält True , wenn der Arbeitsspeicher mehrere physische NUMA-Knoten umfasst, oder andernfalls False .
MemoryUsage
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Arbeitsspeicherauslastung des virtuellen Computers in Megabyte. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der eindeutige Name für den virtuellen Computer oder Momentaufnahme.
Hinweise
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die Notizen, die dem virtuellen Computer oder Momentaufnahme zugeordnet sind.
NumberOfProcessors
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die Gesamtzahl der virtuellen Prozessoren, die dem virtuellen Computer oder Momentaufnahme zugeordnet sind.
OperationalStatus
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Der aktuelle Betriebsstatus des virtuellen Computers. Mögliche Werte finden Sie in der OperationalStatus-Eigenschaft der Msvm_ComputerSystem-Klasse .
OtherEnabledState
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 festgelegt ist. Diese Eigenschaft wird auf NULL festgelegt, wenn EnabledState einen anderen Wert als 1 aufweist.
ProcessorLoad
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Prozessorauslastung des virtuellen Computers in Prozent. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
ProcessorLoadHistory
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Ein Array der vorherigen 100 Beispiele der Prozessornutzung (in Prozent) für den virtuellen Computer. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
Replicationhealth
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet ("Msvm_SummaryInformation. ReplicationHealthEx")
Die Replikationsintegrität für den virtuellen Computer. Mögliche Werte finden Sie in der ReplicationHealth-Eigenschaft der Msvm_ComputerSystem-Klasse .
Hinweis
Diese Eigenschaft ist ab Windows 8.1 veraltet. Verwenden Sie stattdessen ReplicationHealthEx.
Nicht zutreffend (0)
Ok (1)
Warnung (2)
Kritisch (3)
ReplicationHealthEx
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Das Array der Replikationsintegritätswerte für die verschiedenen Replikationsbeziehungen des virtuellen Computers. Mögliche Werte finden Sie in der ReplicationHealth-Eigenschaft der Msvm_ReplicationRelationship-Klasse .
Nicht zutreffend (0)
Ok (1)
Warnung (2)
Kritisch (3)
ReplicationMode
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der Replikationstyp für den virtuellen Computer. Mögliche Werte finden Sie in der ReplicationMode-Eigenschaft der Msvm_ComputerSystem-Klasse .
Keine (0)
Primär (1)
Replikat (2)
Testreplikat (3)
Erweitertes Replikat (4)
ReplicationProviderId
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Für den primären oder erweiterten virtuellen Replikatcomputer ist dies die ID des primären Replikationsanbieters. Bei einem virtuellen Replikatcomputer und wenn die erweiterte Replikation aktiviert ist, ist dies die Anbieter-ID für erweiterte Beziehungen.
Windows 8.1: Dieser Wert wird erst Windows 8.1 und Windows Server 2012 R2 unterstützt.
ReplicationState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet ("Msvm_SummaryInformation. ReplicationStateEx")
Der Replikationsstatus für den virtuellen Computer. Mögliche Werte finden Sie in der ReplicationState-Eigenschaft der Msvm_ComputerSystem-Klasse .
Hinweis
Diese Eigenschaft ist ab Windows 8.1 veraltet. Verwenden Sie stattdessen ReplicationStateEx.
Deaktiviert (0)
Bereit für die Replikation (1)
Warten auf den Abschluss der ersten Replikation (2)
Replizieren (3)
Synchronisierte Replikation abgeschlossen (4)
Wiederhergestellt (5)
Commit (6)
Angehalten (7)
Kritisch (8)
Warten auf den Start der Neusynchronisierung (9)
Neusynchronisierung (10)
Erneute Synchronisierung angehalten (11)
Failover wird ausgeführt (12)
ReplicationStateEx
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Das Array der Replikationsstatuswerte für die verschiedenen Replikationsbeziehungen des virtuellen Computers. Mögliche Werte finden Sie in der ReplicationState-Eigenschaft der Msvm_ReplicationRelationship-Klasse .
Deaktiviert (0)
Bereit für die Replikation (1)
Warten auf den Abschluss der ersten Replikation (2)
Replizieren (3)
Synchronisierte Replikation abgeschlossen (4)
Wiederhergestellt (5)
Commit (6)
Angehalten (7)
Kritisch (8)
Warten auf den Start der Neusynchronisierung (9)
Neusynchronisierung (10)
Erneute Synchronisierung angehalten (11)
Failover wird ausgeführt (12)
Failback wird ausgeführt (13)
Failback abgeschlossen (14)
Datenträgerupdate wird ausgeführt (15)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Datenträgeraktualisierung kritisch (16)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Unbekannt (17)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Repurpose replication in progress (18)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Für die Synchronisierungsreplikation vorbereitet (19)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Vorbereitung für die Gruppenreplikation (20)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Firedrill in Bearbeitung (21)
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Geschützt
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die Abschirmung für den virtuellen Computer konfiguriert ist.
Hinweis
In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.
Momentaufnahmen
-
Datentyp: CIM_VirtualSystemSettingData Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Ein Array von Msvm_VirtualSystemSettingData Instanzen, die die Momentaufnahmen für den virtuellen Computer darstellen. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
StatusBeschreibungen
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Zeichenfolgen, die die entsprechenden OperationalStatus-Arraywerte beschreiben. Dies entspricht der StatusDescriptions-Eigenschaft der Msvm_ComputerSystem-Klasse .
SwapFilesInUse
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob das Paging auf zweiter Ebene aktiv ist. Enthält True , wenn das Paging auf zweiter Ebene aktiv oder andernfalls False ist.
TestReplicaSystem
-
Datentyp: CIM_ComputerSystem
-
Zugriffstyp: Schreibgeschützt
Verweis auf einen CIM_ComputerSystem instance, der den virtuellen Testreplikatcomputer für den virtuellen Computer darstellt. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
ThumbnailImage
-
Datentyp: uint8-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: OctetString, ArrayType ("Indexed"), ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImageWidth", "Msvm_SummaryInformation. ThumbnailImageHeight")
Ein Array, das ein kleines Miniaturbild des Desktops für den virtuellen Computer oder Momentaufnahme im RGB565-Format enthält.
ThumbnailImageHeight
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImage")
Die Höhe des Bilds in Pixel in der ThumbnailImage-Eigenschaft.
Hinweis
In Windows 10 hinzugefügt.
ThumbnailImageWidth
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImage")
Die Breite des Bilds in Pixel in der ThumbnailImage-Eigenschaft.
Hinweis
In Windows 10 hinzugefügt.
Verfügbarkeit
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Die Zeitspanne seit dem letzten Start des virtuellen Computers. Diese Eigenschaft ist ungültig für Instanzen von Msvm_SummaryInformation, die einen virtuellen Computer Momentaufnahme darstellen.
Version
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die Version des virtuellen Systems im Format "major.minor", z. B. "2.0".
Hinweis
In Windows 10 hinzugefügt.
VirtualSwitchNames
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Zeichenfolgen, die die Anzeigenamen der virtuellen Switches angeben, mit denen der virtuelle Computer verbunden ist.
Windows 8.1: Dieser Wert wird erst Windows 8.1 und Windows Server 2012 R2 unterstützt.
VirtualSystemSubType
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Untertyp des virtuellen Systems.
Windows 8.1: Dieser Wert wird erst Windows 8.1 und Windows Server 2012 R2 unterstützt.
Microsoft:Hyper-V:SubType:1 ()
Microsoft:Hyper-V:SubType:2 ()
Bemerkungen
Der Zugriff auf die Msvm_SummaryInformation-Klasse kann durch die UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 8 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2012 [nur Desktop-Apps] |
Namespace |
Stamm\Virtualization\V2 |
MOF |
|
DLL |
|