Freigeben über


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

Siehe auch

Msvm_SummaryInformationBase

Klassen des virtuellen Systems