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 |
|
| DLL |
|