Método MigrateVirtualSystemToHost da classe CIM_VirtualSystemMigrationService

Artigo
06/13/2023

Método para mover, migrar ou realocar um sistema virtual para um host de destino especificado por um nome de rede ou endereço IP.

Observação

Esse método destina-se apenas como uma solução de transição até que a modelagem do suporte ao cluster esteja disponível.

Sintaxe

uint32 MigrateVirtualSystemToHost(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 DestinationHost,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] CIM_ConcreteJob    REF Job
);

Parâmetros

ComputerSystem [in]

Sistema de computador virtual de origem a ser migrado.

DestinationHost [in]

Sistema de host de destino para a migração.

Formatos aceitáveis para esse parâmetro são transmitidos por meio de valores de elementos da propriedade de matriz DestinationHostFormatsSupported[ ] na instância do CIM_VirtualSystemMigrationCapabilities associada por meio da associação CIM_ElementCapabilities .

MigrationSettingData [in]

Cadeia de caracteres que contém uma instância inserida da classe CIM_VirtualSystemMigrationSettingData que representa as configurações de migração aplicáveis à operação de migração.

NewSystemSettingData [in]

Cadeia de caracteres que contém uma instância inserida da classe CIM_VirtualSystemSettingData que representa novas propriedades aplicáveis ao sistema virtual após a migração.

NewResourceSettingData [in]

Matriz de cadeias de caracteres que contém uma instância inserida da classe CIM_ResourceAllocationSettingData que representa novas propriedades aplicáveis a recursos virtuais no escopo do sistema virtual após a migração.

Trabalho [out]

Se a operação for de execução prolongada, opcionalmente, um CIM_ConcreteJob que representa o trabalho poderá ser retornado.

Valor retornado

Retorna um 0 com êxito; caso contrário, retornará um erro.

Retornar código/valor	Descrição
Concluído sem erro 0	O sistema virtual foi migrado.
Sem suporte 1	Método não compatível com a implementação.
Com falha 2	Falha na migração do sistema virtual por motivos não especificados.
Tempo Limite 3	Tempo limite de migração do sistema virtual; o estado do sistema virtual é desconhecido.
Parâmetro inválido 4	Um ou mais parâmetros são formalmente inválidos. Por exemplo, o valor do parâmetro DestinationHost poderia ter sido especificado em um formato sem suporte.
Estado inválido 5	O sistema virtual de origem, o sistema de host de origem ou o sistema de host de destino estão em um estado que permite o início da migração do sistema virtual solicitada; isso pode ser uma condição temporária.
Parâmetros incompatíveis 6	Um ou mais parâmetros de entrada são incompatíveis como um conjunto ou em relação ao host de destino. Por exemplo, o valor do parâmetro MigrationNewSettingData contém propriedades que não são compatíveis com o sistema de host de destino identificado pelo valor do parâmetro DestinationHost .
DMTF Reservado ..
Parâmetros de método verificados – Trabalho iniciado 4096
Método Reservado 4097..32767
Específico do fornecedor 32768..65535

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1
Servidor mínimo com suporte	Windows Server 2012 R2
Namespace	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

CIM_VirtualSystemMigrationService

Compartilhar via