Compartilhar via

Método ImportSystemDefinition da classe Msvm_VirtualSystemManagementService

  • Artigo

Cria um novo sistema de computador planejado com base na definição de máquina virtual especificada.

Sintaxe

uint32 ImportSystemDefinition(
  [in]  string                         SystemDefinitionFile,
  [in]  string                         SnapshotFolder,
  [in]  boolean                        GenerateNewSystemIdentifier,
  [out] Msvm_PlannedComputerSystem REF ImportedSystem,
  [out] CIM_ConcreteJob            REF Job
);

Parâmetros

SystemDefinitionFile [in]

O caminho totalmente qualificado para o arquivo de definição do sistema (.xml ou .exp) que representa a máquina virtual que deve ser importada. O arquivo de definição ainda não deve estar em uso pelo sistema host ou pela plataforma de virtualização.

SnapshotFolder [in]

O caminho totalmente qualificado para a pasta em que as configurações de instantâneo para essa máquina virtual podem ser encontradas. Essa pasta será pesquisada para localizar os instantâneos referenciados pela definição da máquina virtual. Todos os instantâneos referenciados não encontrados neste local devem ser excluídos usando o método DestroySnapshot ou importados usando o método ImportSnapshotDefinitions antes de perceber o sistema de computador planejado.

GenerateNewSystemIdentifier [in]

Indica se o identificador exclusivo da máquina virtual deve ser reutilizado. Se esse parâmetro for True, um novo identificador do sistema será gerado. Se esse parâmetro for False, o identificador do sistema existente será usado.

ImportedSystem [out]

Se a operação for concluída de forma síncrona, uma referência a um objeto Msvm_PlannedComputerSystem que representa a máquina virtual importada.

Trabalho [out]

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

Esse método retorna um dos valores a seguir.

Concluído sem erro (0)

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

Falha (32768)

Acesso negado (32769)

Sem suporte (32770)

O status é desconhecido (32771)

Tempo limite (32772)

Parâmetro inválido (32773)

O sistema está em uso (32774)

Estado inválido para esta operação (32775)

Tipo de dados incorreto (32776)

O sistema não está disponível (32777)

Memória insuficiente (32778)

Arquivo em uso (32779)

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