Msvm _ SummaryInformation-Klasse
Wird in den Methoden GetSummaryInformation und GetDefinitionFileSummaryInformation in der Msvm _ VirtualSystemManagementService-Klasse verwendet, um schnell allgemeine Informationen zu einem virtuellen Computer oder einer Momentaufnahme abzurufen.
Die folgende Syntax wird Managed Object Format (MOF)-Code vereinfacht.
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.
-
AllocatedGPU
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Bezeichner der physischen Grafikprozessor (GPU), die diesem virtuellen Computer zugeordnet ist. Diese Eigenschaft gilt nur für virtuelle Computer, die RemoteFX.
-
-
ApplicationHealth
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Integritätsstatus der Anwendung für den virtuellen Computer. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers 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 virtuellen Computer darstellen, die gerade ausgeführt werden. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers 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 Arbeitsspeicherpuffers zum idealen Arbeitsspeicherpuffer für den virtuellen Computer dar. Die ideale Arbeitsspeicherpuffergröße wird mithilfe der TargetMemoryBuffer-Eigenschaft der Msvm _ MemorySettingData-Klasse konfiguriert.
Diese Eigenschaft ist nicht gültig für Instanzen der Msvm _ SummaryInformation-Klasse, die virtuelle Computer darstellen, für die dynamischer Arbeitsspeicher nicht aktiviert ist.
Diese Eigenschaft ist für Instanzen der Msvm _ SummaryInformation-Klasse ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
Creationtime
-
Datentyp: DateTime
-
Zugriffstyp: Schreibgeschützt
Der Zeitpunkt, zu dem der virtuelle Computer oder die Momentaufnahme erstellt wurde.
ElementName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Anzeigename für den virtuellen Computer oder die Momentaufnahme.
EnabledState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Status des virtuellen Computers oder der 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 zugelassen werden und ob sie für den virtuellen Computer verfügbar sind, sofern zulässig.
Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.
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, falls verfügbar. Wenn diese Informationen nicht verfügbar sind, ist der Wert dieser Eigenschaft NULL. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
HealthState
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Integritätsstatus für den virtuellen Computer. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
Heartbeat
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Der aktuelle Heartbeatstatus für den virtuellen Computer. Weitere Informationen finden Sie in der Dokumentation zur StatusDescriptions-Eigenschaft der Msvm _ HeartbeatComponent-Klasse. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
-
OK (2)
-
Fehler (6)
-
Kein Kontakt (12)
-
Verlorene Kommunikation (13)
HostComputerSystemName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Computers, der diesen virtuellen Computer hosten soll.
Hinweis
Hinzugefügt in Windows 10.
InstanceID
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Außerkraftsetzung ("CIM _ ManagedElement.InstanceID"), Schlüssel
InstanceID ist eine optionale Eigenschaft, die verwendet werden kann, um eine Instanz dieser Klasse innerhalb des Bereichs des instanziierenden Namespace undurchsichtig und eindeutig zu identifizieren. Verschiedene Unterklassen dieser Klasse können diese Eigenschaft überschreiben, 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:
<OrgID > : < LocalID>
Dabei sind OrgID und LocalID durch einen Doppelpunkt < > < > (:)) getrennt, und dabei muss < OrgID einen urheberrechtlich geschützten, markengebundenen oder anderweitig eindeutigen Namen > enthalten, der im Besitz der Geschäftseinheit ist, die die InstanceID erstellt oder definiert, oder bei der es sich um eine registrierte ID handelt, die der Geschäftseinheit von einer erkannten globalen Autorität zugewiesen wird. (Diese Anforderung ähnelt der _ Struktur von Schemaklassennamen.) Um die Eindeutigkeit sicherzustellen, darf < OrgID > außerdem keinen Doppelpunkt (:). 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 festgelegt ist und der oben genannte "bevorzugte" Algorithmus nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht für instanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern für den NameSpace dieser Instanz erzeugt werden.
Wenn der Wert für DMTF-definierte Instanzen nicht auf NULL festgelegt ist, muss der "bevorzugte" Algorithmus mit der OrgID verwendet werden, die < > auf CIM festgelegt ist.
Hinweis
Hinzugefügt in Windows 10.
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)
Konflikt (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 nicht gültig für Instanzen der Msvm _ SummaryInformation-Klasse, die virtuelle Computer darstellen, für die dynamischer Arbeitsspeicher nicht aktiviert ist.
Diese Eigenschaft ist für Instanzen der Msvm _ SummaryInformation-Klasse ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
MemorySpansPhysicalNumaNodes
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Arbeitsspeicher eines oder mehrerer virtueller NUMA-Knoten (Nonuniform Memory Access) des virtuellen Computers mehrere physische NUMA-Knoten des hostenden Computersystems umfasst. Enthält TRUE, wenn der Arbeitsspeicher mehrere physische NUMA-Knoten umfasst, andernfalls FALSE.
MemoryUsage
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Speicherauslastung des virtuellen Computers in Megabyte. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der eindeutige Name für den virtuellen Computer oder die Momentaufnahme.
Hinweise
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die dem virtuellen Computer oder der Momentaufnahme zugeordneten Notizen.
NumberOfProcessors
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die Gesamtzahl der virtuellen Prozessoren, die dem virtuellen Computer oder der 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 ein anderer Wert als 1 ist.
ProcessorLoad
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Prozessorauslastung des virtuellen Computers in Prozent. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
ProcessorLoadHistory
-
Datentyp: uint16 array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Ein Array der vorherigen 100 Stichproben der Prozessorauslastung in Prozent für den virtuellen Computer. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
Replicationhealth
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet ("Msvm _ SummaryInformation.ReplicationHealthEx")
Die Replikationszustand für den virtuellen Computer. Mögliche Werte finden Sie in der ReplicationHealth-Eigenschaft der Msvm _ ComputerSystem-Klasse.
Hinweis
Diese Eigenschaft ist veraltet, beginnend mit Windows 8.1; 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 von Replikationszustandswerten 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 bei aktivierter erweiterter Replikation ist dies die Anbieter-ID für die erweiterte Beziehung.
Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.
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 erneuten Synchronisierung (9)
Neusynchronisierung (10)
Erneute Synchronisierung angehalten (11)
Failover wird ausgeführt (12)
ReplicationStateEx
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Das Array von Replikationszustandswerten 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 erneuten Synchronisierung (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
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Datenträgerupdate kritisch (16)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Unbekannt (17)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Replikation wird neuverwendet (18)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Vorbereitet für die Synchronisierungsreplikation (19)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Vorbereitet für die umgekehrte Gruppenreplikation (20)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Firedrill in Bearbeitung (21)
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Geschützt
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die Abschirmung für den virtuellen Computer konfiguriert ist.
Hinweis
Hinzugefügt in Windows 10 Version 1703 und Windows Server 2016.
Snapshots
-
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 für Instanzen von Msvm _ SummaryInformation, die eine Momentaufnahme eines virtuellen Computers darstellen, ungültig.
StatusDescriptions
-
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: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob paging auf zweiter Ebene aktiv ist. Enthält True, wenn paging der zweiten Ebene aktiv ist, andernfalls False.
TestReplicaSystem
-
Datentyp: CIM _ ComputerSystem
-
Zugriffstyp: Schreibgeschützt
Verweis auf eine CIM _ ComputerSystem-Instanz, die den virtuellen Testreplikatcomputer für den virtuellen Computer darstellt. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation, die eine Momentaufnahme eines virtuellen Computers darstellen, ungültig.
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 eine 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 der ThumbnailImage-Eigenschaft in Pixel.
Hinweis
In Windows 10 hinzugefügt.
Verfügbarkeit
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Die Zeit seit dem letzten Start des virtuellen Computers. Diese Eigenschaft ist für Instanzen von Msvm _ SummaryInformation ungültig, die eine Momentaufnahme eines virtuellen Computers darstellen.
Version
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die Version des virtuellen Systems im Format "major.minor", z.B. "2.0".
Hinweis
Hinzugefügt in Windows 10.
VirtualSwitchNames
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed")
Zeichenfolgen, die die Benutzerfreundlichen Namen der virtuellen Switches angeben, mit denen der virtuelle Computer verbunden ist.
Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.
VirtualSystemSubType
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Untertyp des virtuellen Systems.
Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.
Microsoft:Hyper-V:SubType:1 ()
Microsoft:Hyper-V:SubType:2 ()
Hinweise
Der Zugriff auf die Msvm _ SummaryInformation-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
[Windows 8 Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Namespace |
Root \ Virtualization \ V2 |
| MOF |
|
| DLL |
|