Método DefineSystem da classe Msvm_VirtualSystemManagementService

Cria uma nova instância de máquina virtual. As propriedades que não são especificadas serão preenchidas com valores padrão.

Sintaxe

uint32 DefineSystem(
  [in]  string                           SystemSettings,
  [in]  string                           ResourceSettings[],
  [in]  CIM_VirtualSystemSettingData REF ReferenceConfiguration,
  [out] CIM_ComputerSystem           REF ResultingSystem,
  [out] CIM_ConcreteJob              REF Job
);

Parâmetros

SystemSettings [in]

Tipo: cadeia de caracteres

Uma instância inserida da classe Msvm_VirtualSystemSettingData que é usada para definir os atributos da máquina virtual a ser criada. Este parâmetro é necessário.

ResourceSettings [in]

Tipo: string[]

Várias instâncias inseridas da classe Msvm_ResourceAllocationSettingData (ou de classes derivadas dela). Juntas, essas instâncias descrevem os recursos virtuais da máquina virtual. Um conjunto padrão de dispositivos será criado para a máquina virtual, independentemente de esse parâmetro ser definido. Por exemplo, processador e memória são criados e configurados automaticamente com valores padrão.

ReferenceConfiguration [in]

Tipo: CIM_VirtualSystemSettingData

Uma referência a uma instância da classe Msvm_VirtualSystemSettingData que é o objeto de nível superior de uma configuração de máquina virtual de referência. A configuração de referência será usada para complementar a configuração da nova máquina virtual se os parâmetros SystemSettings e ResourceSettings não fornecerem as respectivas informações.

ResultingSystem [out]

Tipo: CIM_ComputerSystem

Uma referência a uma instância da classe CIM_ComputerSystem que representa a máquina virtual recém-criada.

Trabalho [out]

Tipo: CIM_ConcreteJob

Se a operação for executada de forma assíncrona, esse método retornará 4096 e esse parâmetro conterá uma referência a um objeto derivado de CIM_ConcreteJob.

Valor retornado

Tipo: uint32

Se esse método for executado de forma síncrona, ele retornará 0 se for bem-sucedido. Se esse método for executado de forma assíncrona, ele retornará 4096 e o parâmetro de saída trabalho poderá ser usado para acompanhar o progresso da operação assíncrona. Qualquer outro valor retornado indica um erro.

Concluído sem erro (0)

Sem suporte (1)

Falha (2)

Tempo limite (3)

Parâmetro inválido (4)

DMTF Reservado (..)

Parâmetros de método verificados – Trabalho iniciado (4096)

Método Reservado (4097..32767)

Específico do fornecedor (32768..65535)

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

Msvm_VirtualSystemManagementService