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 对象的字符串。 这允许用户在设置与其他子系统的关系时指定副本 (replica) 目标子系统。

SourceReplicationGroupFriendlyName [in]

要创建的源复制组的名称。

SourceReplicationGroupDescription [in]

源复制组的用途说明。

SourceStorageElements [in]

指定包含嵌入 MSFT_StorageObject 对象的字符串数组。 这是要作为源复制组一部分的存储对象的有序列表。

SourceGroupSettings [in]

一个字符串,其中包含要应用于源复制组的嵌入 MSFT_ReplicationSettings 对象。

TargetReplicationGroupFriendlyName [in]

要创建的目标复制组的名称。

TargetReplicationGroupDescription [in]

目标复制组的用途说明。

TargetStorageElements [in]

指定包含嵌入 MSFT_StorageObject 对象的字符串数组。 这是要作为目标复制组一部分的存储对象的有序列表。

TargetStoragePool [in]

包含嵌入 MSFT_StoragePool 对象的字符串。 这是要用作创建必要 TargetStorageElement 的源的目标上的存储池。 可以指定此参数来代替 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]

如果成功创建复制组和关系,此参数将接收一个字符串,其中包含表示目标复制组副本 (replica) 对等的嵌入式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

另请参阅

MSFT_StorageSubSystem