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 개체를 포함하는 문자열입니다. 필요한 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]
복제 그룹 및 관계가 성공적으로 만들어지면 이 매개 변수는 대상 복제 그룹에 대한 복제본(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 |