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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Weitere Informationen

Msvm _ SummaryInformationBase

Virtuelle Systemklassen