Set-SqlAvailabilityGroup

모듈:

SQLPS Module

가용성 그룹의 설정을 설정합니다.

구문

ByPath (기본값)

Set-SqlAvailabilityGroup
    [[-Path] <String>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Set-SqlAvailabilityGroup
    [-InputObject] <AvailabilityGroup>
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹의 기존 가용성 그룹에 대한 설정을 수정합니다. 자동화된 백업 기본 설정, 실패 조건 수준 및 상태 검사 시간 제한을 수정할 수 있습니다. 주 복제본을 호스트하는 서버 인스턴스에서 이 cmdlet을 실행해야 합니다.

예제

예제 1: 상태 검사 시간 제한 기간 변경

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000

이 명령은 MainAG라는 가용성 그룹의 상태 검사 시간 제한 속성을 120,000밀리초 또는 2분으로 변경합니다. 자동 장애 조치(failover)를 사용하는 경우 이 시간 이후에 AlwaysOn 가용성 그룹이 자동 장애 조치(failover)를 시작합니다.

예제 2: 자동화된 백업 기본 설정 변경

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnly

이 명령은 MainAG라는 가용성 그룹에 대한 자동화된 백업 기본 설정을 SecondaryOnly로 변경합니다. 이 가용성 그룹에 있는 데이터베이스의 자동화된 백업은 주 복제본에서 발생하지 않습니다. 대신 자동화된 백업은 백업 우선 순위가 가장 높은 보조 복제본에서 발생합니다.

예제 3: 오류 조건 수준 변경

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDown

이 명령은 MainAG라는 가용성 그룹의 오류 조건 수준을 OnServerDown으로 변경합니다. 주 복제본을 호스트하는 서버 인스턴스가 오프라인으로 전환되고 자동 장애 조치(failover)가 활성화된 경우 AlwaysOn 가용성 그룹은 자동 장애 조치(failover)를 시작합니다.

매개 변수

-AutomatedBackupPreference

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

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

매개 변수 속성

형식:	AvailabilityGroupAutomatedBackupPreference
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

-DatabaseHealthTrigger

Set-SqlAvailabilityGroup cmdlet은 AlwaysOn 가용성 그룹의 기존 가용성 그룹에 대한 설정을 수정합니다. 자동화된 백업 기본 설정, 실패 조건 수준 및 상태 검사 시간 제한을 수정할 수 있습니다. 주 복제본을 호스트하는 서버 인스턴스에서 이 cmdlet을 실행해야 합니다.

매개 변수 속성

형식:	Boolean
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이 수정하는 가용성 그룹을 AvailabilityGroup 개체로 지정합니다.

매개 변수 속성

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

매개 변수 집합

ByObject

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

-Path

cmdlet에서 수정하는 가용성 데이터베이스의 경로를 지정합니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 현재 작업 위치를 사용합니다.

매개 변수 속성

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

매개 변수 집합

ByPath

Position:	2
필수:	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를 참조하세요.

관련 링크

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