다음을 통해 공유


CIM_VirtualSystemMigrationService 클래스의 CheckVirtualSystemIsMigratableToHost 메서드

가상 시스템이 네트워크 이름 또는 IP 주소로 지정된 대상 호스트로 성공적으로 마이그레이션될 가능성이 있는지 여부를 확인하기 위해 사전 검사 수행하는 방법입니다. 이 메서드는 동적 리소스 가용성으로 인해 후속 마이그레이션이 항상 성공한다고 보장하지는 않습니다.

반환 코드 설명:

참고: 이 방법은 클러스터 지원 모델링을 사용할 수 있는 경우에만 전환 솔루션으로 사용됩니다.

구문

uint32 CheckVirtualSystemIsMigratableToHost(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 DestinationHost,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] boolean                IsMigratable
);

매개 변수

ComputerSystem [in]

마이그레이션할 원본 가상 컴퓨터 시스템에 대한 CIM_ComputerSystem 참조입니다.

DestinationHost [in]

마이그레이션을 위한 대상 호스트 시스템입니다.

이 매개 변수에 허용되는 형식은 CIM_ElementCapabilities 연결을 통해 연결된 CIM_VirtualSystemMigrationCapabilities instance DestinationHostFormatsSupported[ ] 배열 속성의 요소 값을 통해 전달됩니다.

MigrationSettingData [in]

마이그레이션 작업에 적용할 수 있는 마이그레이션 설정을 나타내는 CIM_VirtualSystemMigrationSettingData 클래스의 포함된 instance 포함하는 문자열입니다.

NewSystemSettingData [in]

마이그레이션 후 가상 시스템에 적용할 수 있는 새 속성을 나타내는 CIM_VirtualSystemSettingData 클래스의 포함된 instance 포함하는 문자열입니다.

NewResourceSettingData [in]

마이그레이션 후 가상 시스템의 scope 가상 리소스에 적용할 수 있는 새 속성을 나타내는 CIM_ResourceAllocationSettingData 클래스의 포함된 instance 포함하는 문자열 배열입니다.

IsMigratable [out]

마이그레이션 검사 가상 시스템을 성공적으로 마이그레이션할 수 있는지 여부를 나타내는 결과입니다.

반환 값

성공하면 0을 반환합니다. 그렇지 않으면 에서 오류를 반환합니다.

반환 코드/값 설명
오류 없이 완료됨
0
확인이 수행되었습니다. 결과는 [Out] IsMigratable 매개 변수의 값을 통해 보고됩니다.
지원 안 됨
1
구현에서 지원되지 않는 메서드입니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
실패
2
지정되지 않은 이유로 검사에 실패했습니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
Timeout
3
시간 초과를 확인합니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
잘못된 매개 변수
4
하나 이상의 매개 변수가 공식적으로 유효하지 않습니다. 예를 들어 DestinationHost 매개 변수의 값은 지원되지 않는 형식으로 지정되었을 수 있습니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
잘못된 상태
5
원본 가상 시스템, 원본 호스트 시스템 또는 대상 호스트 시스템은 요청된 가상 시스템 마이그레이션의 시작을 허용하는 상태입니다. 이는 일시적인 조건일 수 있습니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
호환되지 않는 매개 변수
6
하나 이상의 입력 매개 변수는 집합으로 호환되지 않거나 대상 호스트와 관련이 없습니다. 예를 들어 MigrationNewSettingData 매개 변수의 값에는 DestinationHost 매개 변수 값으로 식별된 대상 호스트 시스템에서 지원하지 않는 속성이 포함되어 있습니다. [Out] IsMigratable 매개 변수 값을 통해 보고된 결과가 없습니다.
DMTF 예약됨
..
예약된 메서드
4097..32767
공급업체별
32768..65535

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 8.1
지원되는 최소 서버
Windows Server 2012 R2
네임스페이스
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

추가 정보

CIM_VirtualSystemMigrationService