New-AzSqlDatabaseFailoverGroup
이 명령은 새 Azure SQL Database 장애 조치(failover) 그룹을 만듭니다.
구문
Default (기본값)
New-AzSqlDatabaseFailoverGroup
[-ServerName] <String>
-FailoverGroupName <String>
[-PartnerSubscriptionId <String>]
[-PartnerResourceGroupName <String>]
-PartnerServerName <String>
[-FailoverPolicy <FailoverPolicy>]
[-GracePeriodWithDataLossHours <Int32>]
[-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
[-PartnerServerList <System.Collections.Generic.List`1[System.String]>]
[-ReadOnlyEndpointTargetServer <String>]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
지정된 서버에 대한 새 Azure SQL Database 장애 조치(failover) 그룹을 만듭니다.
FailoverGroupName.SqlDatabaseDnsSuffix(예: FailoverGroupName.database.windows.net) 및 FailoverGroupName.secondary.SqlDatabaseDnsSuffix에 두 개의 Azure SQL Database TDS 엔드포인트가 만들어집니다. 이러한 엔드포인트는 각각 장애 조치(failover) 그룹의 주 서버와 보조 서버에 연결하는 데 사용할 수 있습니다. 주 서버가 중단의 영향을 받는 경우 장애 조치(failover) 그룹의 장애 조치(failover) 정책 및 유예 기간에 따라 엔드포인트 및 데이터베이스의 자동 장애 조치(failover)가 트리거됩니다.
새로 만든 장애 조치(failover) 그룹에는 데이터베이스가 없습니다. 장애 조치(failover) 그룹의 데이터베이스 집합을 제어하려면 'Add-AzSqlDatabaseToFailoverGroup' 및 'Remove-AzSqlDatabaseFromFailoverGroup' cmdlet을 사용합니다.
'-GracePeriodWithDataLossHours' 매개 변수에는 1시간보다 크거나 같은 값만 지원됩니다.
[! 참고] Az.SQL 3.11.0 부터 Azure Powershell의 -PartnerSubscriptionId 매개 변수를 사용하여 구독 간에 자동 장애 조치(failover) 그룹을 배포할 수 있습니다.
예제
예제 1
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1
이 명령은 동일한 리소스 그룹에 있는 두 서버에 대해 장애 조치(failover) 정책이 '자동'인 새 장애 조치 그룹을 만듭니다.
예제 2
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual
이 명령은 서로 다른 리소스 그룹의 두 서버에 대해 장애 조치(failover) 정책 '수동'을 사용하여 새 장애 조치(failover) 그룹을 만듭니다.
예제 3
$sub2 = 'b3c40cd6-024f-428c-921b-cda6c6834c34'
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ServerName primaryserver -FailoverGroupName fg -PartnerSubscriptionId $sub2 -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverPolicy Manual -ResourceGroupName rg1
FailoverGroupName : fg
Location : East US
ResourceGroupName : rg1
ServerName : primaryserver
PartnerLocation : West US 2
PartnerResourceGroupName : rg2
PartnerServerName : secondaryserver1
ReplicationRole : Primary
ReplicationState : CATCH_UP
ReadWriteFailoverPolicy : Manual
FailoverWithDataLossGracePeriodHours :
DatabaseNames : {}
이 명령은 서로 다른 구독의 두 서버에 대해 장애 조치(failover) 정책 '수동'을 사용하여 새 장애 조치 그룹을 만듭니다.
매개 변수
-AllowReadOnlyFailoverToPrimary
보조 서버의 중단이 읽기 전용 엔드포인트의 자동 장애 조치(failover)를 트리거해야 하는지 여부입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독
매개 변수 속성
형식: IAzureContextContainer
Default value: None 와일드카드 지원: False DontShow: False 별칭: AzContext, AzureRmContext, AzureCredential
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-FailoverGroupName
만들 Azure SQL Database 장애 조치(failover) 그룹의 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-FailoverPolicy
Azure SQL Database 장애 조치(failover) 그룹의 장애 조치(failover) 정책입니다.
매개 변수 속성
형식: FailoverPolicy
Default value: Manual 허용되는 값: Automatic, Manual 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-GracePeriodWithDataLossHours
주 서버에서 중단이 발생하고 데이터 손실 없이 장애 조치(failover)를 완료할 수 없는 경우 자동 장애 조치(failover)가 시작되기 전의 간격입니다.
매개 변수 속성
형식: Int32
Default value: 1 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-PartnerResourceGroupName
Azure SQL Database 장애 조치(failover) 그룹의 보조 리소스 그룹의 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-PartnerServerList
장애 조치(failover) 그룹의 파트너 서버 목록입니다(0개 서버에 대한 빈 목록).
매개 변수 속성
형식: List<T> [ String ]
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-PartnerServerName
Azure SQL Database 장애 조치(failover) 그룹의 보조 서버 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-PartnerSubscriptionId
Azure SQL Database 장애 조치(failover) 그룹의 보조 구독 ID 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ReadOnlyEndpointTargetServer
읽기 전용 엔드포인트에 대한 대상 서버의 이름입니다. 비어 있는 경우 기본적으로 PartnerServerName 값으로 설정됩니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ResourceGroupName
리소스 그룹의 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: 0 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
-ServerName
장애 조치(failover) 그룹의 기본 Azure SQL Database 서버 이름입니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: 1 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력
