classe Msvm_VirtualSystemManagementService

Representa o serviço de virtualização presente em um único sistema de host. Msvm_VirtualSystemManagementService é usado para controlar a definição, modificação e exclusão de máquinas virtuais. Ele também tem métodos para executar operações em máquinas virtuais, como clonagem, instantâneo e importação ou exportação de máquinas virtuais. Para recuperar informações por máquina virtual, use Msvm_ComputerSystem.

A sintaxe a seguir é um código MOF (Formato de Objeto Gerenciado) simplificado e inclui todas as propriedades herdadas.

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
  string   InstanceID;
  string   Caption = "Virtual System Management Service";
  string   Description = "Service for creating, manipulating, and managing virtual machines";
  string   ElementName = "Hyper-V Virtual System Management Service";
  datetime InstallDate;
  string   Name = "vmms";
  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;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemManagementService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

Membros

A classe Msvm_VirtualSystemManagementService tem esses tipos de membros:

Métodos

A classe Msvm_VirtualSystemManagementService tem esses métodos.

Método Descrição
AddBootSourceSettings Adiciona fontes de inicialização a uma configuração do sistema virtual quando aplicada a uma configuração de sistema virtual de "estado".
AddFeatureSettings Adiciona configurações de recurso Ethernet à configuração de uma conexão Ethernet de máquina virtual.
AddFibreChannelChap Adiciona parâmetros DH-CHAP a uma porta fibre channel sintética em uma máquina virtual.
AddGuestServiceSettings Adiciona configurações de serviço convidado a uma configuração do sistema virtual.
Quando aplicado a partes de uma configuração de sistema virtual "atual", como um efeito colateral, os serviços convidados do sistema virtual ativo podem ser modificados.
AddKvpItems Adiciona pares chave-valor a uma máquina virtual.
AddResourceSettings Adiciona recursos a uma configuração de máquina virtual.
AddSystemComponentSettings Adiciona configurações genéricas a uma configuração do sistema virtual.
DefinePlannedSystem Define um sistema virtual planejado.
A entrada que não é completamente especificada pode ser preenchida com valores padrão.
DefineSystem Cria uma nova definição de máquina virtual.
DestroySystem Exclui uma definição de máquina virtual existente.
DiagnosticNetworkConnection Diagnostica a conectividade de rede de uma VM em um ambiente de virtualização de rede Windows.
ExportSystemDefinition Exporta uma máquina virtual ou um instantâneo de uma máquina virtual para um arquivo.
FormatError Retorna uma cadeia de caracteres de mensagem de erro formatada para a matriz especificada de instâncias Msvm_Error inseridas.
GenerateWwpn Gera um conjunto de WWPNs (Nomes de Portas Mundiais).
GetCurrentWwpnFromGenerator Fornece a capacidade de visualizar o WWPN (World Wide Port Name) atual sem que o WWPN seja reservado.
GetDefinitionFileSummaryInformation Retorna informações de resumo da máquina virtual para os arquivos de definição de máquina virtual especificados.
GetSizeOfSystemFiles Recupera o tamanho total dos arquivos do sistema da máquina virtual.
GetSummaryInformation Retorna informações de resumo da máquina virtual.
GetVirtualSystemThumbnailImage Recupera uma imagem em miniatura de uma máquina virtual existente.
ImportSnapshotDefinitions Pesquisa a pasta especificada para quaisquer arquivos de definição de instantâneo associados ao sistema de computador planejado especificado e cria um novo instantâneo no sistema de computador planejado para cada arquivo de definição associado neste local.
ImportSystemDefinition Cria um novo sistema de computador planejado com base na definição de máquina virtual especificada.
ModifyDiskMergeSettings Modifica os dados de configuração de mesclagem de disco.
ModifyFeatureSettings Modifica as configurações de recursos atuais de uma conexão Ethernet de máquina virtual.
ModifyGuestServiceSettings Modifica as configurações do serviço convidado.
Quando aplicado a partes de uma configuração de sistema virtual "atual", como um efeito colateral, os serviços convidados do sistema virtual ativo podem ser modificados.
ModifyKvpItems Modifica pares chave-valor existentes em uma máquina virtual.
ModifyResourceSettings Modifica as configurações de recurso virtual.
ModifyServiceSettings Modifica os dados de configuração do serviço.
ModifySystemComponentSettings Modifica as configurações genéricas de componente do sistema.
ModifySystemSettings Modifica as configurações da máquina virtual.
RealizePlannedSystem Valida a configuração de uma máquina virtual planejada e a converte em uma máquina virtual realizada.
RemoveBootSourceSettings Remove as configurações de recursos virtuais de uma configuração do sistema virtual.
Quando aplicado a partes de uma configuração de sistema virtual "atual", como um efeito colateral, os recursos do sistema virtual ativo podem ser removidos.
RemoveFeatureSettings Remove as configurações de recurso de uma conexão Ethernet de máquina virtual.
RemoveFibreChannelChap Remove parâmetros DH-CHAP de uma porta fibre channel sintética em uma máquina virtual.
RemoveGuestServiceSettings Remove as configurações do serviço convidado de uma configuração do sistema virtual.
Quando aplicado a partes de uma configuração de sistema virtual "atual", como um efeito colateral, os serviços convidados do sistema virtual ativo podem ser modificados.
RemoveKvpItems Remove pares chave-valor existentes de uma máquina virtual.
RemoveResourceSettings Remove as configurações de recurso virtual de uma configuração de máquina virtual.
RemoveSystemComponentSettings Remove as configurações de componente genérico de uma configuração do sistema virtual.
RequestStateChange Não há suporte para o método.
SetGuestNetworkAdapterConfiguration Configura os adaptadores de rede no sistema operacional convidado.
SetInitialMachineConfigurationData Define os dados de configuração do computador inicial de uma VM.
Startservice Não há suporte para o método.
StopService Não há suporte para o método.
TestNetworkConnection Testa a conectividade de rede de uma VM em um ambiente de virtualização de rede Windows.
UpgradeSystemVersion Atualiza o sistema virtual.
Quando aplicado às configurações do sistema de uma configuração de sistema virtual "atual"
ValidatePlannedSystem Valida o sistema planejado especificado.

Propriedades

A classe Msvm_VirtualSystemManagementService 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 . Essa propriedade é herdada de CIM_EnabledLogicalElement e está sempre definida como Null.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement e sempre é definida como "Serviço de Gerenciamento de Sistema Virtual 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 nulo indica que essa propriedade não foi 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: cadeia de caracteres

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 está sempre definida como "Msvm_VirtualSystemManagementService".

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement e sempre é definida como "Serviço para criar, manipular e gerenciar máquinas virtuais".

DetailedStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes de status adicionais. Um valor nulo indica que essa propriedade não foi 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 no erro (5)

DMTF Reservado (..)

Fornecedor Reservado (0x8000.. )

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um nome de exibição para o objeto. Essa propriedade é herdada de CIM_ManagedElement e sempre é definida como "Serviço de Gerenciamento de Sistema Virtual hyper-V".

EnabledDefault

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Configuração de inicialização ou padrão de um administrador para o estado habilitado de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e está 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. Essa propriedade também pode indicar as transições entre esses estados solicitados. Essa propriedade é herdada de CIM_EnabledLogicalElement e está 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 é totalmente íntegro e 30 significa que o elemento é completamente não funcional. Essa propriedade é herdada de CIM_ManagedSystemElement e está sempre definida como 5 (OK).

Valor Significado
5
O status de integridade é 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: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave

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

Nome

Tipo de dados: cadeia de caracteres

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

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 nulo indica que essa propriedade não foi implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)

Não disponível (1)

Manutenção (2)

Começando (3)

Parando (4)

Parado (5)

Abortado (6)

Dormente (7)

Concluído (8)

Migração (9)

Emigrou (10)

Imigração (11)

Instantâneo (12)

Desligar (13)

Em Teste (14)

Transição (15)

No 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: cadeia de caracteres

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: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen ( 256 )

Qualquer informação sobre como o proprietário primário 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: cadeia de caracteres

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 principal é 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 detalhado e de alto nível do elemento e seus subcomponentes. Um valor nulo indica que essa propriedade não foi 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 para 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: cadeia de caracteres

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 após a solicitação. Essa propriedade é herdada de CIM_Service e sempre é definida como Null.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres

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: cadeia de caracteres

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: cadeia de caracteres

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 e está sempre definida como Null.

Comentários

O acesso à classe Msvm_VirtualSystemManagementService pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de Conta de Usuário e WMI.

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

Confira também

CIM_VirtualSystemManagementService

CIM_VirtualSystemManagementService

Msvm_VirtualSystemManagementService (V1)

Classes de Gerenciamento de Sistema Virtual