MSFT_ReplicationGroup クラスの CreateReplica メソッド
レプリケーション グループ間にレプリケーション関係を作成します。
構文
UInt32 CreateReplica(
[in] String FriendlyName,
[in] String TargetStorageSubsystem,
[in] String TargetGroupObjectId,
[in, optional] String TargetStoragePoolObjectId,
[in, optional] UInt32 RecoveryPointObjective,
[in] String ReplicationSettings,
[in] UInt16 SyncType,
[out] String CreatedReplicaPeer,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
パラメーター
FriendlyName [in]
作成される要素のエンド ユーザー関連の名前。 NULL の場合、システム指定の既定の名前を使用できます。 値は、作成された要素の FriendlyName プロパティに格納されます。
TargetStorageSubsystem [in]
レプリカ ターゲット サブシステムを指定する埋め込み MSFT_ReplicaPeer オブジェクトを含む文字列。
TargetGroupObjectId [in]
ターゲット マシン上のレプリケーション グループ ターゲットを指定します。
TargetStoragePoolObjectId [in, optional]
必要なターゲット ストレージ要素を作成するためのソースとして使用されるターゲット上のストレージ プール。 ターゲット グループに要素が含まれている場合、このパラメーターは無視されます。
RecoveryPointObjective [in, optional]
データが失われる可能性がある最大間隔を示します。 同期コピー操作の場合、 RecoveryPointObjective は 0 です。 非同期コピー操作の場合、RecoveryPointObjective は、データがターゲット要素へ最後に転送されてからの間隔を表します。
ReplicationSettings [in]
適用する埋め込み MSFT_ReplicationSettings オブジェクトを含む文字列。
SyncType [in]
作成されるコピーの種類。 次のいずれかの値です。
Value | 意味 |
---|---|
DMTF 予約済み .. | この値は、システム使用のために予約されています。 |
ミラー 6 | ソースのコピーを作成して維持します。 |
スナップショット 7 | ソースのボリューム シャドウ コピーを作成します。 |
複製 8 | ソースのポイントインタイムで完全なコピーを作成します。 |
TokenizedClone 9 | ソースのポイントインタイムでトークン化したコピーを作成します。 |
DMTF 予約済み .. | この値は、システム使用のために予約されています。 |
ベンダー固有 0x8000.. | これらの値はベンダー向けに予約されています。 |
CreatedReplicaPeer [out]
このパラメーターは、レプリケーション グループ間の関連付けを表す埋め込み MSFT_Synchronized オブジェクトを含む文字列を受け取ります。
CreatedStorageJob [out]
実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を返します。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。
戻り値
成功 (0)
サポート非対称 (1)
不明なエラー (2)
タイムアウト (3)
失敗 (4)
無効なパラメーター (5)
オブジェクトが見つかりません (8)
チェックされたメソッド パラメーター - ジョブの開始 (4096)
アクセスが拒否されました (40001)
リソース不足のため、操作を完了できません。 (40002)
キャッシュの期限切れ (40003)
クラスターのアップグレード中の操作はサポートされていません。 (40009)
要件
要件 | Value |
---|---|
サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
名前空間 | Root\Microsoft\Windows\Storage |
ヘッダー | Adojet.h |
MOF | Storagewmi.mof |