classe Msvm_VirtualSystemSnapshotService

Artigo
08/19/2023

Serviço para criar, aplicar e destruir instantâneos de máquinas virtuais.

A sintaxe a seguir é um código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.

Sintaxe

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

Membros

A classe Msvm_VirtualSystemSnapshotService tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Msvm_VirtualSystemSnapshotService tem esses métodos.

Método	Descrição
ApplySnapshot	Aplica uma máquina virtual instantâneo à máquina virtual da qual ela foi criada.
ClearSnapshotState	Limpa o estado de salvamento de uma instantâneo existente.
ConvertToReferencePoint	Converter um sistema virtual existente instantâneo em um ponto de referência. O instantâneo é excluído como um efeito colateral. Somente instantâneos de recuperação podem ser convertidos em pontos de referência. Nota: O suporte para esse método foi adicionado ao Windows 10.
CreateSnapshot	Cria um instantâneo de uma máquina virtual.
DestroySnapshot	Destrua uma máquina virtual existente instantâneo. Esse método pode, como efeito colateral, destruir outros instantâneos que dependem do instantâneo afetado.
DestroySnapshotTree	Remove um instantâneo existente e todos os seus filhos de uma máquina virtual.
RequestStateChange	Solicita uma alteração de estado para o elemento . Nota: O suporte para esse método foi adicionado ao Windows 10.
Startservice	Não há suporte para o método.
StopService	Não há suporte para o método.

Propriedades

A classe Msvm_VirtualSystemSnapshotService tem essas propriedades.

AvailableRequestedStates

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Indica os valores possíveis para o parâmetro RequestedState do método RequestStateChange usado para iniciar uma alteração de estado. Os valores listados serão um subconjunto dos valores contidos na propriedade RequestedStatesSupported da instância associada do CIM_EnabledLogicalElementCapabilities, em que os valores selecionados são uma função do estado atual do objeto CIM_EnabledLogicalElement . Essa propriedade poderá ser não Null se uma implementação for capaz de anunciar o conjunto de valores possíveis como uma função do estado atual. Essa propriedade será Null se uma implementação não puder determinar o conjunto de valores possíveis como uma função do estado atual.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Habilitado (2)
Desabilitado (3)
Desligar (4)
Offline (6)
Teste (7)
Adiar (8)
Quiesce (9)
Reinicialização (10)
Redefinir (11)
DMTF Reservado (.. )

Legenda

Tipo de dados: string
Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Serviço de Instantâneo do Sistema Virtual do Hyper-V".

CommunicationStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com o elemento gerenciado subjacente. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
Não disponível (1)
Comunicação OK (2)
Comunicação Perdida (3)
Sem Contato (4)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

CreationClassName

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen ( 256 )

O nome da classe ou subclasse usada na criação de uma instância. Essa propriedade é herdada de CIM_Service e é sempre definida como "Msvm_VirtualSystemSnapshotService".

Descrição

Tipo de dados: string
Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Serviço para criar, destruir e aplicar instantâneos de máquina virtual".

DetailedStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes status adicionais. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Não disponível (0)
Nenhuma informação adicional (1)
Estressado (2)
Falha preditiva (3)
Erro não recuperável (4)
Entidade de suporte em erro (5)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

ElementName

Tipo de dados: string
Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade é herdada de CIM_ManagedElement.

EnabledDefault

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A configuração padrão ou de inicialização de um administrador para o estado habilitado de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 2 (Habilitada).

Valor	Significado
2	habilitado

EnabledState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Os estados habilitados e desabilitados de um elemento. Ele também pode indicar as transições entre esses estados solicitados. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 2 (Habilitada).

Valor	Significado
2	habilitado

HealthState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A integridade atual do elemento. Esse atributo expressa a integridade desse elemento, mas não necessariamente a de seus subcomponentes. Os valores possíveis são de 0 a 30, em que 5 significa que o elemento está totalmente íntegro e 30 significa que o elemento é completamente não funcional. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como 5 (OK).

Valor	Significado
5	A status de saúde é normal.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data e a hora em que a configuração da máquina virtual foi criada. Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Key

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement.

Nome

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen ( 256 )

O rótulo pelo qual o objeto é conhecido. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como "vssnapsvc".

OperatingStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status atuais para a condição operacional do elemento e pode ser usado para fornecer mais detalhes em relação ao valor da propriedade EnabledState. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
Não disponível (1)
Manutenção (2)
Começando (3)
Parando (4)
Parado (5)
Anulado (6)
Dormente (7)
Concluído (8)
Migrando (9)
Emigrou (10)
Immigrating (11)
Instantâneo (12)
Desligar (13)
Em Teste (14)
Transição (15)
Em Serviço (16)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

OperationalStatus

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Os status atuais do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como 2 (OK).

OtherEnabledState

Tipo de dados: string
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1 (Outros). Essa propriedade deve ser definida como Null quando EnabledState for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como Null.

PrimaryOwnerContact

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: MaxLen ( 256 )

Qualquer informação sobre como o proprietário principal do serviço pode ser acessado (por exemplo, número de telefone, endereço de email e assim por diante). Essa propriedade é herdada de CIM_Service e é sempre definida como Null.

PrimaryOwnerName

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: MaxLen ( 64 )

O nome do proprietário primário do serviço, se um for definido. O proprietário primário é o contato de suporte inicial para o serviço. Essa propriedade é herdada de CIM_Service e é sempre definida como Null.

PrimaryStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status de alto nível. Essa propriedade deve ser usada em conjunto com a propriedade DetailedStatus para fornecer status de integridade detalhadas e de alto nível do elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
OK (1)
Degradado (2)
Erro (3)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

RequestedState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O último estado solicitado ou desejado para o elemento. O estado real do elemento é representado por EnabledState. Essa propriedade é fornecida para comparar os últimos estados solicitados e atuais de um elemento. Uma instância específica da classe CIM_EnabledLogicalElement pode não dar suporte à propriedade RequestedState . Se isso ocorrer, o valor 12 (Não Aplicável) será usado. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 12 (Não Aplicável).

Valor	Significado
12	Não aplicável.

Iniciado

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Indica se o serviço está em execução no momento. Essa propriedade é herdada de CIM_Service e é sempre definida como True.

StartMode

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: MaxLen ( 10 )

Um valor de cadeia de caracteres que indica se o serviço é iniciado automaticamente por um sistema, um sistema operacional ou é iniciado somente mediante solicitação. Essa propriedade é herdada de CIM_Service e é sempre definida como Null.

Status

Tipo de dados: string
Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_ManagedSystemElement, mas não é usada.

StatusDescriptions

Tipo de dados: matriz string
Tipo de acesso: Somente leitura

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus . Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como "O serviço está em execução normalmente".

SystemCreationClassName

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen ( 256 )

O nome da classe de criação do sistema de escopo. Essa propriedade é herdada de CIM_Service e é sempre definida como "Msvm_ComputerSystem".

Systemname

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen ( 256 )

O nome NetBIOS do sistema de computador de hospedagem. Essa propriedade é herdada de CIM_Service.

TimeOfLastStateChange

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data ou hora em que o estado habilitado do elemento foi alterado pela última vez. Essa propriedade é herdada de CIM_EnabledLogicalElement.

TransitioningToState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica o estado de destino para o qual a instância está em transição. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor	Significado
Desconhecido 0
Enabled 2
Desabilitado 3
Desligar 4
Nenhuma alteração 5	Nenhuma transição está em andamento.
Offline 6
Test 7
Adiar 8
Fechar 9
Reboot 10
Redefinir 11
Não aplicável 12	A implementação não dá suporte à representação de transições contínuas.
DMTF Reservado ..

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Compartilhar via