Condividi tramite

classe Msvm_VirtualSystemSnapshotService

  • Articolo

Servizio per creare, applicare ed eliminare definitivamente gli snapshot delle macchine virtuali.

La sintassi seguente è un codice MOF (Managed Object Format) semplificato e include tutte le proprietà ereditate.

Sintassi

[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;
};

Members

La classe Msvm_VirtualSystemSnapshotService ha questi tipi di membri:

Metodi

La classe Msvm_VirtualSystemSnapshotService dispone di questi metodi.

Metodo Descrizione
ApplySnapshot Applica uno snapshot di macchina virtuale alla macchina virtuale da cui è stato creato.
ClearSnapshotState Cancella lo stato di salvataggio da uno snapshot esistente.
ConvertToReferencePoint Convertire uno snapshot del sistema virtuale esistente in un punto di riferimento. Lo snapshot viene eliminato come effetto collaterale. Solo gli snapshot di ripristino possono essere convertiti in punti di riferimento.
Nota: Il supporto per questo metodo è stato aggiunto in Windows 10.
CreateSnapshot Crea uno snapshot di una macchina virtuale.
DestroySnapshot Eliminare definitivamente uno snapshot di macchina virtuale esistente. Questo metodo può, come effetto collaterale, eliminare definitivamente altri snapshot dipendenti dallo snapshot interessato.
DestroySnapshotTree Rimuove uno snapshot esistente e tutti i relativi elementi figlio di una macchina virtuale.
RequestStateChange Richiede una modifica dello stato per l'elemento .
Nota: Il supporto per questo metodo è stato aggiunto in Windows 10.
Startservice Questo metodo non è supportato.
StopService Questo metodo non è supportato.

Proprietà

La classe Msvm_VirtualSystemSnapshotService ha queste proprietà.

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange utilizzato per avviare una modifica dello stato. I valori elencati saranno un subset dei valori contenuti nella proprietà RequestedStatesSupported dell'istanza associata di CIM_EnabledLogicalElementCapabilities, in cui i valori selezionati sono una funzione dello stato corrente dell'oggetto CIM_EnabledLogicalElement . Questa proprietà può essere non Null se un'implementazione è in grado di annunciare il set di valori possibili come funzione dello stato corrente. Questa proprietà sarà Null se un'implementazione non è in grado di determinare il set di valori possibili come funzione dello stato corrente.

Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Abilitato (2)

Disabilitato (3)

Arresto (4)

Offline (6)

Test (7)

Rinvio (8)

Quiesce (9)

Riavvio (10)

Reimpostazione (11)

DMTF Riservato (.. )

Didascalia

Tipo di dati: string

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement e viene sempre impostata su "Servizio snapshot del sistema virtuale Hyper-V".

CommunicationStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Comunicazione OK (2)

Comunicazione persa (3)

Nessun contatto (4)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Key, MaxLen ( 256 )

Nome della classe o della sottoclasse utilizzata nella creazione di un'istanza di . Questa proprietà viene ereditata da CIM_Service ed è sempre impostata su "Msvm_VirtualSystemSnapshotService".

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement ed è sempre impostata su "Servizio per la creazione, l'eliminazione e l'applicazione di snapshot di macchine virtuali".

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Complimenta la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Non disponibile (0)

Nessuna informazione aggiuntiva (1)

Sottolineato (2)

Errore predittivo (3)

Errore non ripristinabile (4)

Entità di supporto nell'errore (5)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

ElementName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

EnabledDefault

Tipo di dati: uint16

Tipo di accesso: sola lettura

Configurazione predefinita o di avvio di un amministratore per lo stato abilitato di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement ed è sempre impostata su 2 (Abilitato).

Valore Significato
2
 Attivato

EnabledState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Può anche indicare le transizioni tra questi stati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement ed è sempre impostata su 2 (Abilitato).

Valore Significato
2
 Attivato

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Questo attributo esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. I valori possibili sono da 0 a 30, dove 5 significa che l'elemento è completamente integro e 30 significa che l'elemento è completamente non funzionante. Questa proprietà viene ereditata da CIM_ManagedSystemElement e viene sempre impostata su 5 (OK).

Valore Significato
5
 Lo stato di integrità è normale.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data e ora di creazione della configurazione della macchina virtuale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Key, MaxLen ( 256 )

Etichetta in base alla quale l'oggetto è noto. Questa proprietà viene ereditata da CIM_ManagedSystemElement ed è sempre impostata su "vssnapsvc".

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere usato per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Manutenzione (2)

Avvio (3)

Arresto (4)

Arrestato (5)

Interrotto (6)

Inattivo (7)

Completato (8)

Migrazione (9)

Emigrazione (10)

Immigrazione (11)

Snapshotting (12)

Arresto (13)

In Test (14)

Transizione (15)

Nel servizio (16)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement e ogni elemento della matrice è sempre impostato su 2 (OK).

OtherEnabledState

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stringa che descrive lo stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Altro). Questa proprietà deve essere impostata su Null quando EnabledState è qualsiasi valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su Null.

PrimaryOwnerContact

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen ( 256 )

Tutte le informazioni su come è possibile raggiungere il proprietario primario del servizio (ad esempio, numero di telefono, indirizzo di posta elettronica e così via). Questa proprietà viene ereditata da CIM_Service e viene sempre impostata su Null.

PrimaryOwnerName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen ( 64 )

Nome del proprietario primario per il servizio, se ne viene definito uno. Il proprietario primario è il contatto di supporto iniziale per il servizio. Questa proprietà viene ereditata da CIM_Service e viene sempre impostata su Null.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni di stato di alto livello. Questa proprietà deve essere usata insieme alla proprietà DetailedStatus per fornire stato di integrità elevato e dettagliato dell'elemento e dei relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

OK (1)

Degradato (2)

Errore (3)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

RequestedState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Ultimo stato richiesto o desiderato per l'elemento. Lo stato effettivo dell'elemento è rappresentato da EnabledState. Questa proprietà viene fornita per confrontare gli ultimi stati richiesti e correnti per un elemento. Un'istanza specifica della classe CIM_EnabledLogicalElement potrebbe non supportare la proprietà RequestedState . In questo caso, viene usato il valore 12 (non applicabile). Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su 12 (non applicabile).

Valore Significato
12
 Non applicabile.

Avviato

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se il servizio è attualmente in esecuzione. Questa proprietà viene ereditata da CIM_Service e viene sempre impostata su True.

Modalità avvio

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen ( 10 )

Valore stringa che indica se il servizio viene avviato automaticamente da un sistema, un sistema operativo o viene avviato solo dopo la richiesta. Questa proprietà viene ereditata da CIM_Service e viene sempre impostata su Null.

Status

Tipo di dati: stringa

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_ManagedSystemElement, ma non viene usata.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement e ogni elemento della matrice è sempre impostato su "Il servizio è in esecuzione normalmente".

SystemCreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Key, MaxLen ( 256 )

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_Service ed è sempre impostata su " Msvm_ComputerSystem".

Systemname

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Key, MaxLen ( 256 )

Nome NetBIOS del sistema computer di hosting. Questa proprietà viene ereditata da CIM_Service.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora in cui lo stato abilitato dell'elemento è stato modificato. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Transizione diToState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica lo stato di destinazione a cui viene eseguita la transizione dell'istanza. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
Unknown
0
Enabled
2
Disabilitato
3
Arresta
4
Nessuna modifica
5
 Nessuna transizione è in corso.
Offline
6
Test
7
Rinviare
8
Disattivazione
9
Reboot
10
Reimpostazione
11
Non applicabile
12
 L'implementazione non supporta la rappresentazione delle transizioni in corso.
DMTF riservato
..

Requisiti

Requisito Valore
Client minimo supportato
 Windows 8 [solo app desktop]
Server minimo supportato
 Windows Server 2012 [solo app desktop]
Spazio dei nomi
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe