MSFT_StorageSubSystem 類別的 CreateReplicationRelationship 方法
建立兩個復寫群組，以及兩者之間的復寫關聯性。 這個方法需要子系統支援完整探索到的複寫。
語法
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]
來源和目標群組之間關聯性的使用者相關名稱，或來源元素與目標群組之間的關聯性， (也就是一對多) 。 如果 為 NULL，實作會指派名稱。 如果個別目標專案需要 ElementName，實作會使用 RelationshipName 建構適當的 ElementName;例如， RelationshipName 作為前置詞，後面接著 「_n」 序號，其中 n 是開頭為 1 的數位。
SyncType [in]
描述將要建立的複本類型。
DMTF 保留 (。。)
鏡像 (6)
快照 集 (7)
複製 (8)
TokenizedClone (9)
DMTF 保留 (。。)
廠商特定 (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 物件的字串。
此參數可讓記憶體提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
找不到物件 (8)
已檢查方法參數 - 作業啟動 (4096)
拒絕存取 (40001)
沒有足夠的資源來完成作業。 (40002)
快取過期 (40003)
升級叢集時不支援此作業。 (40009)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |