New-SqlAvailabilityGroup

모듈:

SQLServer

가용성 그룹을 만듭니다.

Syntax

New-SqlAvailabilityGroup
   -AvailabilityReplica <AvailabilityReplica[]>
   [-Database <String[]>]
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-BasicAvailabilityGroup]
   [-ContainedAvailabilityGroup]
   [-ReuseSystemDatabases]
   [-DatabaseHealthTrigger]
   [-DtcSupportEnabled]
   [-ClusterType <AvailabilityGroupClusterType>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-SqlAvailabilityGroup
   -AvailabilityReplica <AvailabilityReplica[]>
   [-Database <String[]>]
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-BasicAvailabilityGroup]
   [-ContainedAvailabilityGroup]
   [-ReuseSystemDatabases]
   [-DatabaseHealthTrigger]
   [-DtcSupportEnabled]
   [-ClusterType <AvailabilityGroupClusterType>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-SqlAvailabilityGroup cmdlet은 Always On 가용성 그룹에 가용성 그룹을 만듭니다.

InputObject 또는 Path 매개 변수는 초기 주 복제본(replica) 호스트하는 서버를 지정합니다.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

예제

예제 1: 가용성 그룹 만들기

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version) 
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

첫 번째 명령은 주 서버에서 SQL Server instance 가져오고 $PrimaryServer 변수에 저장합니다.

네 번째 명령은 New-SqlAvailabilityReplica를 사용하여 보조 서버 instance 포함하는 복제본(replica) 만든 다음 $SecondaryReplica 변수에 저장합니다.

명령은 $SecondaryServer Version 속성을 사용하여 서버 instance 버전을 지정합니다.

예제 2: WSFC에서 지원하는 가용성 그룹 만들기

# Get server
PS C:\> cd 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD

# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate

# Create AG with explicit cluster type WSFC (same as not passing -ClusterType, since it is the default value)
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType Wsfc

예제 3: 독립된 가용성 그룹 클러스터 만들기

# Get server
PS C:\> CD 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD

# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate

# Create AG cluster group independent
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType None

예제 4: 트랜잭션이 주 복제본에서 커밋하는 데 사용할 수 있어야 하는 SYNCHRONOUS_COMMIT 보조 데이터베이스 수를 설정하는 가용성 그룹 만들기

# Get server
PS C:\> Get-Item 'SQLSERVER:\SQL\some-hostname\Default'
# Create primary replica
PS C:\> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate
# Create AG with RequiredSynchronizedSecondariesToCommit = 3
PS C:\> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -RequiredSynchronizedSecondariesToCommit 3

참고: 대상 서버 버전이 2016 이하인 경우 -RequiredSynchronizedSecondariesToCommit 매개 변수가 사용되는 경우 예외가 SQL Server throw됩니다.

매개 변수

-AccessToken

사용자/암호 또는 Windows 인증 대신 SQL Server 인증하는 데 사용되는 액세스 토큰입니다.

예를 들어 또는 에 연결 SQL Azure DB 하고 를 사용하는 Service Principal 데 사용할 수 있습니다Managed IdentitySQL Azure Managed Instance.

사용할 매개 변수는 토큰을 나타내는 문자열이거나 PSAccessToken 를 실행 Get-AzAccessToken -ResourceUrl https://database.windows.net하여 반환된 개체일 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomatedBackupPreference

가용성 그룹에 대한 자동화된 백업 기본 설정을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

• 주. 백업이 항상 주 복제본에서 수행되도록 지정합니다. 이 옵션은 차등 백업과 같은 보조 복제본(replica) 백업을 실행할 때 사용할 수 없는 기능의 사용을 지원합니다.
• SecondaryOnly. 백업이 주 복제본에서 수행되지 않도록 지정합니다. 기본 복제본(replica) 유일한 온라인 복제본(replica) 경우 백업이 발생하지 않습니다.
• 보조. 주 복제본(replica) 유일한 온라인 복제본(replica) 아닌 한 보조 복제본에서 백업이 수행되도록 지정합니다. 그런 다음 백업이 주 복제본에서 발생합니다.
• 없음 백업을 수행하는 복제본(replica) 결정할 때 기본 또는 보조 상태 고려되지 않도록 지정합니다. 대신 백업 우선 순위 및 온라인 상태 백업을 수행하는 복제본(replica) 결정합니다.

Type:	AvailabilityGroupAutomatedBackupPreference
Accepted values:	Primary, SecondaryOnly, Secondary, None, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailabilityReplica

이 cmdlet이 가용성 그룹에 포함하는 가용성 복제본의 배열을 지정합니다. AvailabilityReplica를 가져오려면 New-SqlAvailabilityReplica cmdlet을 사용합니다. AsTemplate 매개 변수를 지정합니다.

Type:	AvailabilityReplica[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BasicAvailabilityGroup

(기본값) 또는 basic 가용성 그룹을 만들 advanced 지 여부를 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterType

AG를 지원하는 클러스터의 유형입니다. 가능한 값은 다음과 같습니다.

• Wsfc. AG는 Windows Server 장애 조치(failover) 클러스터에 통합됩니다. 이는 2016년 SQL Server 이하의 AG를 만드는 방법입니다. 이것이 기본값입니다.
• 없음 AG는 클러스터 독립적입니다.
• 외부. AG는 Linux의 Pacemaker와 같이 Windows Server 장애 조치(failover) 클러스터가 아닌 클러스터 관리자에 의해 관리됩니다. 이는 SQL Server 2017 이상에서 지원됩니다. SQL Server on Linux 대상으로 지정할 때 이 값을 지정해야 합니다. 그렇지 않으면 오류가 발생합니다.

참고: 대상 서버가 SQL Server 2016 이하일 때 -ClusterType 매개 변수를 사용하는 경우 예외가 throw됩니다.

Type:	AvailabilityGroupClusterType
Accepted values:	Wsfc, None, External
Position:	Named
Default value:	Wsfc
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContainedAvailabilityGroup

포함된 가용성 그룹을 만드는 데 사용됩니다. 이 옵션은 가용성 그룹의 복제본 집합 간에 동기화된 상태로 유지되는 자체 master 및 msdb 데이터베이스를 사용하여 가용성 그룹을 만드는 데 사용됩니다. 이 매개 변수는 도우미 -ReuseSystemDatabases와 함께 사용할 수 있습니다.

이 매개 변수는 대상 SQL Server 포함된 가용성 그룹(SQL 2022 이상)을 지원하는 경우에만 허용됩니다. 사용하려고 하면 포함된 가용성 그룹을 지원하지 않는 SQL 버전에 대해 cmdlet이 오류를 throw합니다.

이 매개 변수는 모듈 버전 22 이상에서만 사용할 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

로컬 읽기/쓰기 사용자 데이터베이스의 배열을 지정합니다. 이러한 데이터베이스는 전체 복구 모델을 사용해야 하며 AUTO_CLOSE 사용하지 않아야 합니다. 이러한 데이터베이스는 다른 가용성 그룹에 속할 수 없으며 데이터베이스 미러링에 대해 구성할 수 없습니다. 이 매개 변수의 값을 지정해야 합니다.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseHealthTrigger

가용성 그룹 내의 사용자 데이터베이스 복제본(replica) 데이터베이스 오류 조건이 발생하는 경우 가용성 그룹의 자동 장애 조치(failover)를 트리거할지 여부를 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DtcSupportEnabled

가용성 그룹 내의 데이터베이스가 instance 수준(기본값) 또는 데이터베이스별 수준에서 MSDTC에 등록하는지 여부를 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

SQL Server 연결할 때 사용할 암호화 유형입니다.

이 값은 Encrypt Microsoft.Data.SqlClient 드라이버의 SqlConnection 개체에 있는 속성 SqlConnectionEncryptOption 에 매핑됩니다.

모듈의 v22에서 기본값은 (v21과의 호환성을 위해)입니다 Optional . 모듈의 v23 이상에서는 기본값이 '필수'이며 기존 스크립트에 대한 호환성이 손상되는 변경이 발생할 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FailureConditionLevel

가용성 그룹의 자동 장애 조치(failover) 동작을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• OnServerDown. SQL Server 서비스가 중지되면 장애 조치(failover) 또는 다시 시작합니다.
• OnServerUnresponsive. 더 낮은 값의 조건이 충족되고 SQL Server 서비스가 클러스터에 연결되고 HealthCheckTimeout 임계값이 초과되거나 현재 주 역할에 있는 가용성 복제본(replica) 실패 상태인 경우 장애 조치(failover) 또는 다시 시작합니다.
• OnCriticalServerError. 더 낮은 값의 조건이 충족되는 경우 장애 조치(failover) 또는 다시 시작, 메모리 부족 상태, 심각한 쓰기 액세스 위반 또는 너무 많은 덤프를 포함한 내부 중요 서버 오류가 발생할 때.
• OnModerateServerError. 더 낮은 값의 조건이 충족되는 경우 장애 조치(failover) 또는 다시 시작과 메모리 부족 상태를 포함하는 보통 서버 오류가 발생하는 경우.
• OnAnyQualifiedFailureConditions. 더 낮은 값의 조건이 충족되는 경우 장애 조치(failover) 또는 다시 시작, 그리고 엔진 작업자 스레드 고갈 및 해결 불가능한 교착 상태가 감지되는 정규화된 오류 조건이 발생하는 경우.

Type:	AvailabilityGroupFailureConditionLevel
Accepted values:	OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthCheckTimeout

Always On 가용성 그룹이 응답하지 않는 서버를 비정상으로 선언하는 시간(밀리초)을 지정합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. 강제 암호화에 대해 SQL Server instance 사용하도록 설정되어 있고 hostname/shortname을 사용하여 instance 연결하려는 경우 이 매개 변수를 전달해야 합니다. 이 매개 변수를 생략하면 FQDN(정규화된 도메인 이름)을 -ServerInstance에 전달하여 강제 암호화를 사용하도록 설정된 SQL Server instance 연결해야 합니다.

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

이 cmdlet에서 만드는 가용성 그룹의 기본 복제본(replica) 호스트하는 SQL Server instance 지정합니다.

Type:	Server
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

이 cmdlet에서 만드는 가용성 그룹의 이름을 지정합니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

이 cmdlet에서 만드는 가용성 그룹의 초기 기본 복제본(replica) 호스트하는 SQL Server instance 경로를 지정합니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 현재 작업 위치를 사용합니다. 값을 지정하는 경우 경로가 현재 있어야 합니다.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredSynchronizedSecondariesToCommit

주 데이터베이스에서 커밋할 수 있도록 사용할 수 있어야 하는 동기 커밋 보조 데이터베이스의 수입니다.

보조 복제본 SYNCHRONOUS_COMMIT 의 연결이 일정 시간 동안 주 데이터베이스와 연결이 끊어지면 주 복제본은 커밋 차단을 방지하기 위해 로 강등 ASYNCHRONOUS_COMMIT 합니다. 주 복제본을 사용할 수 없게 되고 사용자가 이러한 보조 데이터베이스 중 하나로 장애 조치(failover)하려는 경우 데이터 손실이 발생할 수 있습니다. RequiredSynchronizedSecondariesToCommit을 일부 숫자로 설정하면 너무 많은 보조 데이터베이스가 로 강등되는 경우 주 복제본이 커밋 차단을 시작하기 때문에 사용자는 데이터 손실을 방지할 ASYNCHRONOUS_COMMIT수 있습니다.

이 설정의 기본값은 0입니다. 즉, 주 데이터베이스가 커밋을 차단하지 않습니다. 이는 2017년 SQL Server 이전의 동작과 동일합니다.

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReuseSystemDatabases

이 매개 변수를 사용하면 이전 버전의 AG에서 포함된 master 및 msdb 데이터베이스가 이 새 가용성 그룹을 만드는 데 사용됩니다.

-ContainedAvailabilityGroup을 지정하지 않고 이 매개 변수를 사용하려고 하면 cmdlet에서 오류가 발생합니다.

이 매개 변수는 모듈 버전 22 이상에서만 사용할 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

이 cmdlet이 이 cmdlet이 수행하는 작업을 수행하는 Transact-SQL 스크립트를 반환한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

신뢰의 유효성을 검사하기 위해 인증서 체인을 건너뛰는 동안 채널이 암호화되는지 여부를 나타냅니다.

모듈의 v22에서 기본값은 (v21과의 호환성을 위해)입니다 $true . 모듈의 v23 이상에서 기본값은 '$false'이며, 이로 인해 기존 스크립트에 대한 호환성이 손상되는 변경이 발생할 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

Microsoft.SqlServer.Management.Smo.Server

서버 instance 이 cmdlet에 전달할 수 있습니다.

출력

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

이 cmdlet은 가용성 그룹을 반환합니다.

관련 링크

• Join-SqlAvailabilityGroup
• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityGroup
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup