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, a modificação e a 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 (Managed Object Format) 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 estes 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 de 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 de 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 de sistema virtual. |
| DefinePlannedSystem | Define um sistema virtual planejado. A entrada que não está 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. |
| DiagnosnetworkConnection | Diagnostica a conectividade de rede de uma VM em um Ambiente de Virtualização de Rede do 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 de Msvm_Error inseridas. |
| GenerateWwpn | Gera um conjunto de WWPNs (Nomes de Portas Em Todo o Mundo). |
| 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 na pasta especificada 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 nesse 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 recurso 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 do 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 recurso virtual de uma configuração de 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 os 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 de sistema virtual. |
| RequestStateChange | Não há suporte para o método. |
| SetGuestNetworkAdapterConfiguration | Configura os adaptadores de rede dentro do 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 do 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 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 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: 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 é 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 adicionais de status. 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: 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 do Hyper-V".
-
-
EnabledDefault
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
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 (Habilitado).
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 é sempre definida como 2 (Habilitado).
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 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 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)
-
Emigrando (10)
-
Imigração (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: 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 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: 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 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 detalhada 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 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 é 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 |
|
| DLL |
|