Msvm_VirtualSystemSnapshotService-Klasse

Artikel
08/19/2023

Dienst zum Erstellen, Anwenden und Zerstören von Momentaufnahmen virtueller Computer.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemSnapshotService : CIM_VirtualSystemSnapshotService
{
  string   InstanceID;
  string   Caption = "Hyper-V Virtual System Snapshot Service";
  string   Description = "Service for creating, destroying, and applying virtual machine snapshots";
  string   ElementName;
  datetime InstallDate;
  string   Name = "vssnapsvc";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The service is running normally" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemSnapshotService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

Member

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

Methoden
Eigenschaften

Methoden

Die Msvm_VirtualSystemSnapshotService-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
ApplySnapshot	Wendet einen virtuellen Computer Momentaufnahme auf den virtuellen Computer an, auf dem er erstellt wurde.
ClearSnapshotState	Löscht den Speicherstatus eines vorhandenen Momentaufnahme.
ConvertToReferencePoint	Konvertieren sie ein vorhandenes virtuelles System Momentaufnahme in einen Referenzpunkt. Die Momentaufnahme wird als Nebeneffekt gelöscht. Nur Wiederherstellungsmomentaufnahmen können in Verweispunkte konvertiert werden. Hinweis: Unterstützung für diese Methode wurde in Windows 10 hinzugefügt.
CreateSnapshot	Erstellt eine Momentaufnahme eines virtuellen Computers.
DestroySnapshot	Zerstören Sie einen vorhandenen virtuellen Computer Momentaufnahme. Diese Methode kann als Nebeneffekt andere Momentaufnahmen zerstören, die von den betroffenen Momentaufnahme abhängig sind.
DestroySnapshotTree	Entfernt eine vorhandene Momentaufnahme und alle untergeordneten Elemente eines virtuellen Computers.
RequestStateChange	Fordert eine Zustandsänderung für das Element an. Hinweis: Unterstützung für diese Methode wurde in Windows 10 hinzugefügt.
Startservice	Diese Methode wird nicht unterstützt.
StopService	Diese Methode wird nicht unterstützt.

Eigenschaften

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

AvailableRequestedStates

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an, die zum Initiieren einer Zustandsänderung verwendet wird. Die aufgeführten Werte sind eine Teilmenge der Werte, die in der RequestedStatesSupported-Eigenschaft der zugeordneten instance von CIM_EnabledLogicalElementCapabilities enthalten sind, wobei die ausgewählten Werte eine Funktion des aktuellen Zustands des CIM_EnabledLogicalElement-Objekts sind. Diese Eigenschaft kann nicht NULL sein, wenn eine Implementierung den Satz möglicher Werte als Funktion des aktuellen Zustands ankündigen kann. Diese Eigenschaft ist NULL , wenn eine Implementierung den Satz möglicher Werte nicht als Funktion des aktuellen Zustands ermitteln kann.

Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Aktiviert (2)
Deaktiviert (3)
Herunterfahren (4)
Offline (6)
Test (7)
Zurückstellen (8)
Stilllegen (9)
Neustart (10)
Zurücksetzen (11)
DMTF Reserviert (.. )

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Hyper-V Virtual System Snapshot Service" festgelegt.

CommunicationStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Kommunikation OK (2)
Verlorene Kommunikation (3)
Kein Kontakt (4)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_VirtualSystemSnapshotService" festgelegt.

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Dienst zum Erstellen, Zerstören und Anwenden von Momentaufnahmen virtueller Computer" festgelegt.

DetailedStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Nicht verfügbar (0)
Keine zusätzlichen Informationen (1)
Gestresst (2)
Vorhersagefehler (3)
Nicht wiederherstellbarer Fehler (4)
Unterstützende Entität im Fehler (5)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

ElementName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 2 (Aktiviert) festgelegt.

Wert	Bedeutung
2	Aktiviert

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände eines Elements. Es kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 2 (Aktiviert) festgelegt.

Wert	Bedeutung
2	Aktiviert

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die integrität seiner Unterkomponenten. Die möglichen Werte sind 0 bis 30, wobei 5 bedeutet, dass das Element vollständig fehlerfrei ist und 30 bedeutet, dass das Element vollständig nicht funktionsfähig ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (OK) festgelegt.

Wert	Bedeutung
5	Die integritäts status ist normal.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung der Konfiguration des virtuellen Computers. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel, MaxLen ( 256 )

Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf "vssnapsvc" festgelegt.

OperatingStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Wartung (2)
Ab (3)
Beenden (4)
Beendet (5)
Abgebrochen (6)
Ruhend (7)
Abgeschlossen (8)
Migrieren (9)
Auswandern (10)
Immigrieren (11)
Momentaufnahme (12)
Herunterfahren (13)
Im Test (14)
Übergang (15)
Im Dienst (16)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Die aktuellen Status des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement ist immer auf 2 (OK) festgelegt.

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. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf NULL festgelegt.

PrimaryOwnerContact

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 256 )

Alle Informationen darüber, wie der primäre Besitzer des Diensts erreicht werden kann (z. B. Telefonnummer, E-Mail-Adresse usw.). Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf NULL festgelegt.

PrimaryOwnerName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 64 )

Der Name des primären Besitzers für den Dienst, sofern einer definiert ist. Der primäre Besitzer ist der erste Supportkontakt für den Dienst. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um eine allgemeine und detaillierte Integrität status des Elements und seiner Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
OK (1)
Herabgestuft (2)
Fehler (3)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. Der tatsächliche Zustand des Elements wird durch EnabledState dargestellt. Diese Eigenschaft wird bereitgestellt, um den zuletzt angeforderten und den aktuellen Status für ein Element zu vergleichen. Eine bestimmte instance der CIM_EnabledLogicalElement-Klasse unterstützt die RequestedState-Eigenschaft möglicherweise nicht. In diesem Fall wird der Wert 12 (Nicht zutreffend) verwendet. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 12 (Nicht zutreffend) festgelegt.

Wert	Bedeutung
12	Nicht zutreffend.

Started

Datentyp: Boolescher Wert
Zugriffstyp: Schreibgeschützt

Gibt an, ob der Dienst derzeit ausgeführt wird. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf True festgelegt.

StartMode

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 10 )

Ein Zeichenfolgenwert, der angibt, ob der Dienst automatisch von einem System, einem Betriebssystem oder nur auf Anforderung gestartet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, aber nicht verwendet.

StatusBeschreibungen

Datentyp: string-Array
Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement wird immer auf "Der Dienst wird normal ausgeführt" festgelegt.

SystemCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_ComputerSystem" festgelegt.

Systemname

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der NetBIOS-Name des Hostcomputersystems. Diese Eigenschaft wird von CIM_Service geerbt.

TimeOfLastStateChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert	Bedeutung
Unbekannt 0
Aktiviert 2
Disabled 3
Herunterfahren 4
Keine Änderung 5	Es wird kein Übergang ausgeführt.
Offline 6
Test 7
Verzögern 8
Stilllegen 9
Neustart 10
Zurücksetzen 11
Nicht verfügbar 12	Die Implementierung unterstützt die Darstellung laufender Übergänge nicht.
DMTF Reserviert ..

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