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

関連項目

MSFT_ReplicationGroup