MSFT_StorageSubSystem クラスの CreateReplicationRelationship メソッド
2 つのレプリケーション グループとそれらの間にレプリケーション関係を作成します。 このメソッドでは、サブシステムが完全に検出されたレプリケーションをサポートする必要があります。
構文
UInt32 CreateReplicationRelationship(
[in] String FriendlyName,
[in] Uint16 SyncType,
[in] String TargetStorageSubsystem,
[in] String SourceReplicationGroupFriendlyName,
[in] String SourceReplicationGroupDescription,
[in] String SourceStorageElements[],
[in] String SourceGroupSettings,
[in] String TargetReplicationGroupFriendlyName,
[in] String TargetReplicationGroupDescription,
[in] String TargetStorageElements[],
[in] String TargetStoragePool,
[in] String TargetStoragePools[],
[in] String TargetGroupSettings,
[in] UInt16 RecoveryPointObjective,
[out] String SourceGroup,
[out] String TargetGroup,
[out] String CreatedReplicaPeer,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
パラメーター
FriendlyName [in]
ソース グループとターゲット グループの間、またはソース要素とターゲット グループ (つまり、1 対多) の間のリレーションシップのユーザー関連の名前。 NULL の場合、実装は名前を割り当てます。 個々のターゲット要素に ElementName が必要な場合、実装は適切な ElementName を RelationshipName などを使用し、RelationshipName をプレフィックスとし、その後に「_n」シーケンス番号を続けます。n は 1 で始まる番号です。
SyncType [in]
作成されるコピーの種類について説明します。
DMTF Reserved (..)
Mirror (6)
Snapshot (7)
Clone (8)
TokenizedClone (9)
DMTF Reserved (..)
Vendor Specific (0x8000..)
TargetStorageSubsystem [in]
埋め込み MSFT_ReplicaPeer オブジェクトを含む文字列。 これにより、ユーザーは別のサブシステムとの関係を設定するときにレプリカ ターゲット サブシステムを指定できます。
SourceReplicationGroupFriendlyName [in]
作成されるソース レプリケーション グループの名前。
SourceReplicationGroupDescription [in]
ソース レプリケーション グループの目的の説明。
SourceStorageElements [in]
埋め込まれた MSFT_StorageObject オブジェクトを含む文字列の配列を指定します。 これは、ソース レプリケーション グループの一部となるストレージ オブジェクトの順序付きリストです。
SourceGroupSettings [in]
ソース レプリケーション グループに適用される埋め込み MSFT_ReplicationSettings オブジェクトを含む文字列。
TargetReplicationGroupFriendlyName [in]
作成されるターゲット レプリケーション グループの名前。
TargetReplicationGroupDescription [in]
ターゲット レプリケーション グループの目的の説明。
TargetStorageElements [in]
埋め込まれた MSFT_StorageObject オブジェクトを含む文字列の配列を指定します。 これは、ターゲット レプリケーション グループの一部となるストレージ オブジェクトの順序付きリストです。
TargetStoragePool [in]
埋め込み MSFT_StoragePool オブジェクトを含む文字列。 これは、必要は TargetStorageElements を作成するためのソースとして使用されるターゲット上のストレージ プールです。 このパラメーターは、TargetStorageElements の代わりに指定できます。
TargetStoragePools [in]
埋め込み MSFT_StoragePool オブジェクトを含む文字列の配列。 ターゲット要素 (レプリカ) の基になるストレージは、指定された場合、 TargetStoragePoolから引き出されます。 それ以外の場合、割り当ては実装固有です。 ターゲット要素が指定された場合、このパラメーターは NULL になります。 TargetStoragePools が指定された場合、TargetStoragePool は NULL になります。
TargetGroupSettings [in]
ターゲット レプリケーション グループに適用される埋め込み MSFT_ReplicationSettings オブジェクトを含む文字列。
RecoveryPointObjective [in]
データが失われる可能性がある最大間隔を示します。 同期コピー操作の場合、RecoveryPointObjective は 0 です。 非同期コピー操作の場合、RecoveryPointObjective は、データがターゲット要素へ最後に転送されてからの間隔を表します。
SourceGroup [out]
レプリケーション グループとリレーションシップが正常に作成された場合、このパラメーターは、ソース レプリケーション グループを表す埋め込み MSFT_ReplicationGroup オブジェクトを含む文字列を受け取ります。
TargetGroup [out]
レプリケーション グループとリレーションシップが正常に作成された場合、このパラメーターは、ターゲット レプリケーション グループを表す埋め込み MSFT_ReplicationGroup オブジェクトを含む文字列を受け取ります。
CreatedReplicaPeer [out]
レプリケーション グループとリレーションシップが正常に作成された場合、このパラメーターは、ターゲット レプリケーション グループのレプリカ ピアを表す埋め込み MSFT_ReplicaPeer オブジェクトを含む文字列を受け取ります。
CreatedStorageJob [out]
実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を返します。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。
戻り値
Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Object Not Found (8)
Method Parameters Checked - Job Started (4096)
Access denied (40001)
リソース不足のため、操作を完了できません。 (40002)
Cache out of date (40003)
クラスターのアップグレード中の操作はサポートされていません。 (40009)
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |