Método CheckVirtualSystemIsMigratableToHost da classe CIM_VirtualSystemMigrationService

Artigo
06/13/2023

Método para executar um pré-marcar para determinar se um sistema virtual provavelmente será migrado com êxito para um host de destino especificado por um nome de rede ou endereço IP. Esse método não garante que uma migração subsequente sempre terá êxito devido à disponibilidade dinâmica de recursos.

Descrição do código de retorno:

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 CheckVirtualSystemIsMigratableToHost(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 DestinationHost,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] boolean                IsMigratable
);

Parâmetros

ComputerSystem [in]

Uma referência CIM_ComputerSystem ao 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 associado 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 cada uma contendo uma instância inserida da classe CIM_ResourceAllocationSettingData que representa novas propriedades aplicáveis aos recursos virtuais no escopo do sistema virtual após a migração.

IsMigratable [out]

A migração marcar resultado indicando se o sistema virtual pode ou não ser migrado com êxito.

Valor retornado

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

Código/valor de retorno	Descrição
Concluído sem erro 0	Verificação executada; resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
Sem suporte 1	Método sem suporte na implementação. Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
Com falha 2	Falha na verificação por motivos não especificados. Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
Tempo Limite 3	A verificação atingiu o tempo limite. Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
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. Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
Estado inválido 5	O sistema virtual de origem, o sistema de host de origem ou o sistema 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. Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
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 . Nenhum resultado relatado por meio do valor do parâmetro [Out] IsMigratable .
DMTF Reservado ..
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