New-SqlAvailabilityGroup

모듈:

SQLPS Module

가용성 그룹을 만듭니다.

구문

ByPath (기본값)

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹에 가용성 그룹을 만듭니다. InputObject 또는 Path 매개 변수는 초기 주 복제본을 호스트하는 서버를 지정합니다.

예제

예제 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 인스턴스를 가져오고 $PrimaryServer 변수에 저장합니다.

두 번째 명령은 보조 서버에서 SQL Server 인스턴스를 가져오고 $SecondaryServer 변수에 저장합니다.

세 번째 명령은 New-SqlAvailabilityReplica cmdlet을 사용하여 주 서버 인스턴스를 포함하는 복제본을 만든 다음 $PrimaryReplica 변수에 저장합니다. 이 명령은 $PrimaryServer Version 속성을 사용하여 서버 인스턴스의 버전을 지정합니다.

네 번째 명령은 New-SqlAvailabilityReplica를 사용하여 보조 서버 인스턴스를 포함하는 복제본을 만든 다음 $SecondaryReplica 변수에 저장합니다. 이 명령은 $SecondaryServer Version 속성을 사용하여 서버 인스턴스의 버전을 지정합니다.

최종 명령은 가용성 그룹을 만듭니다. 이름, 주 서버, 복제본 및 기타 정보를 지정합니다.

매개 변수

-AutomatedBackupPreference

가용성 그룹에 대한 자동화된 백업 기본 설정을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

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

매개 변수 속성

형식:	AvailabilityGroupAutomatedBackupPreference
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AvailabilityReplica

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

매개 변수 속성

형식:	AvailabilityReplica[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BasicAvailabilityGroup

New-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹에 가용성 그룹을 만듭니다. InputObject 또는 Path 매개 변수는 초기 주 복제본을 호스트하는 서버를 지정합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Database

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

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DatabaseHealthTrigger

New-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹에 가용성 그룹을 만듭니다. InputObject 또는 Path 매개 변수는 초기 주 복제본을 호스트하는 서버를 지정합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DtcSupportEnabled

New-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹에 가용성 그룹을 만듭니다. InputObject 또는 Path 매개 변수는 초기 주 복제본을 호스트하는 서버를 지정합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FailureConditionLevel

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

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

매개 변수 속성

형식:	AvailabilityGroupFailureConditionLevel
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HealthCheckTimeout

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

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InputObject

이 cmdlet이 만드는 가용성 그룹의 주 복제본을 호스팅하는 SQL Server 인스턴스를 지정합니다.

매개 변수 속성

형식:	Server
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByObject

Position:	3
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Name

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Path

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByPath

Position:	3
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Script

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

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

Microsoft.SqlServer.Management.Smo.Server

서버 인스턴스를 이 cmdlet에 전달할 수 있습니다.

출력

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

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

관련 링크

• SQL 가용성 그룹에 조인
• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityGroup (SQL 가용성 그룹 제거)
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup