다음을 통해 공유

New-AzSqlDatabaseFailoverGroup

  • 참조
모듈:
Az.Sql

이 명령은 새 Azure SQL Database 장애 조치(failover) 그룹을 만듭니다.

구문

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)를 트리거해야 하는지 여부입니다.

형식:AllowReadOnlyFailoverToPrimary
허용되는 값:Enabled, Disabled
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FailoverGroupName

만들 Azure SQL Database 장애 조치(failover) 그룹의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FailoverPolicy

Azure SQL Database 장애 조치(failover) 그룹의 장애 조치(failover) 정책입니다.

형식:FailoverPolicy
허용되는 값:Automatic, Manual
Position:Named
Default value:Manual
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GracePeriodWithDataLossHours

주 서버에서 중단이 발생하고 데이터 손실 없이 장애 조치(failover)를 완료할 수 없는 경우 자동 장애 조치(failover)가 시작되기 전의 간격입니다.

형식:Int32
Position:Named
Default value:1
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartnerResourceGroupName

Azure SQL Database 장애 조치(failover) 그룹의 보조 리소스 그룹의 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartnerServerList

장애 조치(failover) 그룹의 파트너 서버 목록입니다(0개 서버에 대한 빈 목록).

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartnerServerName

Azure SQL Database 장애 조치(failover) 그룹의 보조 서버 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartnerSubscriptionId

Azure SQL Database 장애 조치(failover) 그룹의 보조 구독 ID 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReadOnlyEndpointTargetServer

읽기 전용 엔드포인트에 대한 대상 서버의 이름입니다. 비어 있는 경우 기본적으로 PartnerServerName 값으로 설정됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹의 이름입니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServerName

장애 조치(failover) 그룹의 기본 Azure SQL Database 서버 이름입니다.

형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

출력

AzureSqlFailoverGroupModel