Msvm_VirtualSystemSnapshotService Klasse

Dienst zum Erstellen, Anwenden und Zerstören von Momentaufnahmen von virtuellen Computern.

Die folgende Syntax ist vereinfachter Code für verwaltetes Objektformat (MOF) 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 diese Arten von Mitgliedern:

Methoden

Die Msvm_VirtualSystemSnapshotService-Klasse weist diese Methoden auf.

Methode Beschreibung
ApplySnapshot Wendet eine Momentaufnahme des virtuellen Computers auf den virtuellen Computer an, von dem er erstellt wurde.
ClearSnapshotState Löscht den Status eines vorhandenen Momentaufnahmes.
ConvertToReferencePoint Konvertieren Sie eine vorhandene virtuelle Systemaufnahme in einen Referenzpunkt. Die Momentaufnahme wird als Nebeneffekt gelöscht. Nur Wiederherstellungsaufnahmen können in Referenzpunkte 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 eine vorhandene Momentaufnahme des virtuellen Computers. Diese Methode kann als Nebeneffekt andere Momentaufnahmen zerstören, die von der 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 weist diese Eigenschaften auf.

AvailableRequestedStates

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestStateState-Parameter der RequestStateChange-Methode an, die verwendet wird, um eine Zustandsänderung zu initiieren. Die aufgeführten Werte sind eine Teilmenge der Werte, die in der RequestedStatesSupported-Eigenschaft der zugeordneten Instanz 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 wird Null sein, wenn eine Implementierung nicht den Satz möglicher Werte als Funktion des aktuellen Zustands bestimmen kann.

Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Aktiviert (2)

Deaktiviert (3)

Herunterfahren (4)

Offline (6)

Test (7)

Verschiebung (8)

Quiesce (9)

Neustart (10)

Zurücksetzen (11)

DMTF Reserviert (.). )

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

CommunicationStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt die Möglichkeit 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 (..)

Anbieter reserviert (0x8000.).

CreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

Der Name der Klasse oder Unterklasse, die in der Erstellung einer Instanz verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt und wird immer auf " Msvm_VirtualSystemSnapshotService" festgelegt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und wird 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 Statusdetails. 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)

Betont (2)

Vorhersagefehler (3)

Nicht wiederherstellbarer Fehler (4)

Unterstützen der Entität im Fehler (5)

DMTF Reserved (..)

Vendor Reserved (0x8000.. )

ElementName

Datentyp: Zeichenfolge

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 sie wird immer auf 2 (Aktiviert) festgelegt.

Wert Bedeutung
2
Aktiviert

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände eines Elements. Sie kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, und sie wird 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 der unterkomonenten Elemente. 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 funktionslos ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und sie wird immer auf 5 (OK) festgelegt.

Wert Bedeutung
5
Der Integritätsstatus ist normal.

InstallDate

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit, zu dem die Konfiguration des virtuellen Computers erstellt wurde. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eine Instanz dieser Klasse eindeutig. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

Die Beschriftung, durch die das Objekt bekannt ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und sie wird immer auf "vssnapsvc" festgelegt.

OperatingStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt aktuelle Statusinformationen für den Betriebszustand des Elements bereit und kann verwendet werden, um mehr Details im Hinblick 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)

Start (3)

Beenden (4)

Beendet (5)

Abgebrochen (6)

Ruhende (7)

Abgeschlossen (8)

Migrieren (9)

Emigrating (10)

Immigrating (11)

Snapshotting (12)

Herunterfahren (13)

In Test (14)

Übergang (15)

In Service (16)

DMTF Reserved (..)

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 wird immer auf 2 (OK) festgelegt.

OtherEnabledState

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 (Other) festgelegt ist. Diese Eigenschaft muss auf Null festgelegt werden, wenn EnabledState einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, und sie wird immer auf Null festgelegt.

PrimaryOwnerContact

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen ( 256 )

Alle Informationen dazu, 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 sie wird immer auf Null festgelegt.

PrimaryOwnerName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen ( 64 )

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

PrimaryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt Statusinformationen auf hoher Ebene bereit. Diese Eigenschaft sollte in Verbindung mit der Detailstatus-Eigenschaft verwendet werden, um einen hohen und detaillierten Integritätsstatus 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)

Beeinträchtigt (2)

Fehler (3)

DMTF Reserviert (..)

Anbieter reserviert (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 die letzten angeforderten und aktuellen Status für ein Element zu vergleichen. Eine bestimmte Instanz der CIM_EnabledLogicalElement-Klasse unterstützt möglicherweise nicht die RequestedState-Eigenschaft . Wenn dies auftritt, wird der Wert 12 (Nicht anwendbar) verwendet. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 12 festgelegt (Nicht anwendbar).

Wert Bedeutung
12
Nicht zutreffend

Started

Datentyp: boolescher Datentyp

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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen ( 10 )

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

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, wird jedoch nicht verwendet.

StatusDescriptions

Datentyp: Zeichenfolgenarray

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".

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

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

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

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

TimeOfLastStateChange

Datentyp: Datumszeit

Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit, zu dem der aktivierte Zustand des Elements zuletzt geändert wurde. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

TransitioningToState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, zu dem die Instanz übergibt. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert Bedeutung
Unbekannt
0
Aktiviert
2
Deaktiviert
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 keine fortlaufenden Übergänge.
DMTF reserviert
..

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2012 [nur Desktop-Apps]
Namespace
Stamm\Virtualisierung\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe