次の方法で共有

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のインスタンスの DestinationHostFormatsSupported[ ] 配列プロパティの要素の値によって伝達されます。

MigrationSettingData [in]

移行操作に適用できる移行設定を表す CIM_VirtualSystemMigrationSettingData クラスの埋め込みインスタンスを含む文字列。

NewSystemSettingData [in]

移行後に仮想システムに適用できる新しいプロパティを表す 、CIM_VirtualSystemSettingData クラスの埋め込みインスタンスを含む文字列。

NewResourceSettingData [in]

仮想システムの移行後に仮想システムのスコープ内の仮想リソースに適用できる新しいプロパティを表す 、CIM_ResourceAllocationSettingData クラスの埋め込みインスタンスを含む文字列の配列。

IsMigratable [out]

移行チェック、仮想システムを正常に移行できるかどうかを示す結果になります。

戻り値

成功した場合は 0 を返します。それ以外の場合は、エラーを返します。

リターン コード/値 説明
エラーなしで完了
0
 実行されたチェック。結果は[Out] IsMigratable パラメーターの値によって報告されます。
サポートされていません
1
 メソッドは実装でサポートされていません。 [Out] IsMigratable パラメーターの値を使用して結果が報告されません。
失敗
2
 未指定の理由でチェックが失敗しました。 [Out] IsMigratable パラメーターの値を使用して結果が報告されません。
タイムアウト
3
 タイムアウトを確認します。[Out] IsMigratable パラメーターの値を使用して結果が報告されません。
無効なパラメーター
4
 1 つ以上のパラメーターが正式に無効です。 たとえば、 DestinationHost パラメーターの値がサポートされていない形式で指定されている可能性があります。 [Out] IsMigratable パラメーターの値を使用して結果が報告されません。
無効な状態
5
 ソース仮想システム、ソース ホスト システム、またはターゲット ホスト システムは、要求された仮想システムの移行の開始を許可する状態です。これは一時的な条件である可能性があります。 [Out] IsMigratable パラメーターの値を使用して結果が報告されません。
互換性のないパラメーター
6
 1 つ以上の入力パラメーターは、セットとして、またはターゲット ホストに対して互換性がありません。 たとえば、 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