Msvm_VirtualSystemSnapshotService clase

Artículo
06/12/2023

Servicio para crear, aplicar y destruir instantáneas de máquinas virtuales.

La siguiente sintaxis es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

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

Miembros

La clase Msvm_VirtualSystemSnapshotService tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Msvm_VirtualSystemSnapshotService tiene estos métodos.

Método	Descripción
ApplySnapshot	Aplica una instantánea de máquina virtual a la máquina virtual a partir de la que se creó.
ClearSnapshotState	Borra el estado de guardado de una instantánea existente.
ConvertToReferencePoint	Convierta una instantánea de sistema virtual existente en un punto de referencia. La instantánea se elimina como efecto secundario. Solo se pueden convertir instantáneas de recuperación en puntos de referencia. Nota: Se agregó compatibilidad con este método en Windows 10.
CreateSnapshot	Crea una instantánea de una máquina virtual.
DestroySnapshot	Destruir una instantánea de máquina virtual existente. Este método puede, como efecto secundario, destruir otras instantáneas que dependen de la instantánea afectada.
DestroySnapshotTree	Quita una instantánea existente y todos sus elementos secundarios de una máquina virtual.
RequestStateChange	Solicita un cambio de estado para el elemento . Nota: Se agregó compatibilidad con este método en Windows 10.
StartService	No se admite este método.
StopService	No se admite este método.

Propiedades

La clase Msvm_VirtualSystemSnapshotService tiene estas propiedades.

AvailableRequestedStates

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Indica los valores posibles para el parámetro RequestedState del método RequestStateChange utilizado para iniciar un cambio de estado. Los valores enumerados serán un subconjunto de los valores contenidos en la propiedad RequestedStatesSupported de la instancia asociada de CIM_EnabledLogicalElementCapabilities, donde los valores seleccionados son una función del estado actual del objeto CIM_EnabledLogicalElement . Esta propiedad puede ser distinta de Null si una implementación puede anunciar el conjunto de valores posibles como una función del estado actual. Esta propiedad será Null si una implementación no puede determinar el conjunto de valores posibles como una función del estado actual.

Esta propiedad se hereda de CIM_EnabledLogicalElement.

Habilitado (2)
Deshabilitado (3)
Apagar (4)
Sin conexión (6)
Prueba (7)
Aplazar (8)
Modo inactivo (9)
Reinicio (10)
Restablecimiento (11)
DMTF Reservado (.. )

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Servicio de instantáneas de sistema virtual de Hyper-V".

CommunicationStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)
No disponible (1)
Comunicación correcta (2)
Comunicación perdida (3)
Sin contacto (4)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

CreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen ( 256 )

Nombre de la clase o subclase usada en la creación de una instancia. Esta propiedad se hereda de CIM_Service y siempre se establece en "Msvm_VirtualSystemSnapshotService".

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Servicio para crear, destruir y aplicar instantáneas de máquina virtual".

DetailedStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

No disponible (0)
Sin información adicional (1)
Estresado (2)
Error predictivo (3)
Error no recuperable (4)
Entidad auxiliar en error (5)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

ElementName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.

EnabledDefault

Tipo de datos: uint16
Tipo de acceso: solo lectura

Configuración de inicio o predeterminada de un administrador para el estado habilitado de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 2 (Habilitado).

Valor	Significado
2	habilitado

EnabledState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 2 (Habilitado).

Valor	Significado
2	habilitado

HealthState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5 (Correcto).

Valor	Significado
5	El estado de mantenimiento es normal.

InstallDate

Tipo de datos: fecha/hora
Tipo de acceso: solo lectura

Fecha y hora en que se creó la configuración de la máquina virtual. Esta propiedad se hereda de CIM_ManagedSystemElement.

InstanceID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: key

Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen ( 256 )

Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en "vssnapsvc".

OperatingStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)
No disponible (1)
Mantenimiento (2)
A partir de (3)
Detención (4)
Detenido (5)
Anulado (6)
Inactivo (7)
Completado (8)
Migración (9)
Migración (10)
Migración (11)
Instantáneas (12)
Apagado (13)
En prueba (14)
Transición (15)
En servicio (16)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en 2 (OK).

OtherEnabledState

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que describe el estado habilitado o deshabilitado del elemento cuando la propiedad EnabledState está establecida en 1 (Otros). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.

PrimaryOwnerContact

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen ( 256 )

Cualquier información sobre cómo se puede acceder al propietario principal del servicio (por ejemplo, número de teléfono, dirección de correo electrónico, etc.). Esta propiedad se hereda de CIM_Service y siempre se establece en Null.

PrimaryOwnerName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen ( 64 )

Nombre del propietario principal del servicio, si se define uno. El propietario principal es el contacto de soporte técnico inicial del servicio. Esta propiedad se hereda de CIM_Service y siempre se establece en Null.

PrimaryStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Proporciona información de estado de alto nivel. Esta propiedad debe usarse junto con la propiedad DetailedStatus para proporcionar un estado de mantenimiento alto y detallado del elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)
Ok (1)
Degradado (2)
Error (3)
DMTF Reserved (..)
Proveedor reservado (0x8000.. )

RequestedState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Último estado solicitado o deseado para el elemento. El estado real del elemento se representa mediante EnabledState. Esta propiedad se proporciona para comparar los últimos estados solicitados y actuales de un elemento. Es posible que una instancia determinada de la clase CIM_EnabledLogicalElement no admita la propiedad RequestedState . Si esto ocurre, se usa el valor 12 (no aplicable). Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 12 (no aplicable).

Valor	Significado
12	No aplicable.

Introducción

Tipo de datos: booleano
Tipo de acceso: solo lectura

Indica si el servicio se está ejecutando actualmente. Esta propiedad se hereda de CIM_Service y siempre se establece en True.

StartMode

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen ( 10 )

Valor de cadena que indica si un sistema inicia automáticamente el servicio, un sistema operativo o solo se inicia a petición. Esta propiedad se hereda de CIM_Service y siempre se establece en Null.

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.

StatusDescriptions

Tipo de datos: matriz de cadena
Tipo de acceso: solo lectura

Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement, y cada elemento de matriz siempre se establece en "El servicio se ejecuta normalmente".

SystemCreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen ( 256 )

Nombre de la clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_Service y siempre se establece en "Msvm_ComputerSystem".

SystemName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen ( 256 )

Nombre NetBIOS del sistema de equipo host. Esta propiedad se hereda de CIM_Service.

TimeOfLastStateChange

Tipo de datos: fecha/hora
Tipo de acceso: solo lectura

Fecha u hora en que el estado habilitado del elemento cambió por última vez. Esta propiedad se hereda de CIM_EnabledLogicalElement.

TransitioningToState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica el estado de destino al que se está realizando la transición de la instancia. Esta propiedad se hereda de CIM_EnabledLogicalElement.

Valor	Significado
Unknown 0
Enabled 2
Deshabilitada 3
Apaga 4
Sin cambio 5	No hay ninguna transición en curso.
Sin conexión 6
Prueba 7
Defer 8
Modo de inactividad 9
Reboot 10
Reset 11
No aplicable 12	La implementación no admite la representación de transiciones en curso.
DMTF Reserved ..

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Compartir a través de