Set-SqlAvailabilityReplica
가용성 복제본(replica) 설정을 지정합니다.
Syntax
Set-SqlAvailabilityReplica
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SqlAvailabilityReplica
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-InputObject] <AvailabilityReplica>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-SqlAvailabilityReplica cmdlet은 가용성 복제본(replica) 대한 다양한 속성을 설정하거나 수정합니다. 주 복제본(replica) 호스트하는 서버 instance 이 cmdlet을 실행합니다.
예제
예제 1: 복제본(replica) 가용성 모드 및 자동 장애 조치(failover) 수정
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"이 명령은 MainAG라는 가용성 그룹에서 Replica02라는 복제본(replica) 수정하여 동기-커밋 가용성 모드를 사용하고 자동 장애 조치(failover)를 지원합니다.
예제 2: 강제 수동 장애 조치(failover)를 지원하도록 복제본(replica) 수정
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"이 명령은 MainAG라는 가용성 그룹에서 Replica02라는 복제본(replica) 수정하여 비동기 커밋 가용성 모드를 사용하고 강제 수동 장애 조치(failover)만 지원하여 데이터 손실을 초래할 수 있습니다.
예제 3: 보조 역할의 모든 연결 허용
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"이 명령은 가용성 그룹 MainAG의 복제본(replica) 'Replica02'를 수정하여 보조 역할의 모든 연결을 허용합니다. 이렇게 하면 읽기 전용 데이터 처리 워크로드를 보조 복제본으로 오프로드할 수 있습니다.
예제 4: 읽기 전용 라우팅을 위한 기본 복제본(replica) 및 보조 복제본(replica) 구성
PS C:\> Set-Location "SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MainAG"
C:\PS> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
C:\PS> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica첫 번째 명령은 SQLSERVER: 공급자의 위치로 위치를 변경합니다.
두 번째 명령은 주 서버에 대한 복제본(replica) 가져오고 $PrimaryReplica 변수에 저장합니다.
세 번째 명령은 보조 서버에 대한 복제본(replica) 가져오고 $SecondaryReplica 변수에 저장합니다.
네 번째 명령은 기본 복제본(replica) 읽기 전용 라우팅 URL을 할당합니다. 그런 다음 주 복제본에 읽기 전용 라우팅 목록을 설정합니다.
다섯 번째 명령은 보조 복제본(replica) 읽기 전용 라우팅 URL을 할당합니다.
여섯 번째 명령은 기본 복제본(replica) 읽기 전용 라우팅 목록을 설정합니다. ReadOnly 속성 연결 문자열 있는 Connections 보조 복제본(replica) 리디렉션됩니다. 보조 복제본(replica) 읽을 수 없는 경우 연결은 기본 복제본(replica) 다시 전달됩니다.
예제 5: 백업 우선 순위 수정
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"이 명령은 가용성 복제본(replica) 'Replica02'의 백업 우선 순위를 60으로 설정합니다. 이 우선 순위는 주 복제본(replica) 호스트하는 서버 instance 사용하여 가용성 그룹의 데이터베이스에서 자동화된 백업 요청을 처리해야 하는 복제본(replica) 결정합니다. 우선 순위가 가장 높은 복제본(replica) 선택됩니다.
매개 변수
-AvailabilityMode
복제본(replica) 가용성 모드를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- SynchronousCommit
- 비동기Commit
$Null 값을 지정할 수 있습니다.
| Type: | AvailabilityReplicaAvailabilityMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupPriority
백업을 수행할 때 복제본의 원하는 우선 순위를 지정합니다. 이 매개 변수에 허용되는 값은 0에서 100까지의 정수입니다. 온라인 및 사용 가능한 복제본 집합 중 우선 순위가 가장 높은 복제본(replica) 백업을 수행합니다.
값이 0이면 복제본(replica) 후보가 아님을 나타냅니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| 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 |
-ConnectionModeInPrimaryRole
주 역할에서 가용성 복제본(replica) 연결을 처리하는 방법을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- AllowReadWriteConnections. 읽기/쓰기 연결을 허용합니다.
- AllowAllConnections. 모든 연결을 허용합니다.
| Type: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionModeInSecondaryRole
보조 역할에서 가용성 복제본(replica) 연결을 처리하는 방법을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- AllowNoConnections. 연결을 허용하지 않습니다.
- AllowReadIntentConnectionsOnly. 읽기 의도 연결만 허용합니다.
- AllowAllConnections. 모든 연결을 허용합니다.
| Type: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndpointUrl
데이터베이스 미러링 엔드포인트의 URL을 지정합니다. 이 URL은 다음 형식의 TCP 주소입니다.
TCP://system-address:port
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailoverMode
장애 조치(failover) 모드를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 자동
- 수동. $Null 값을 지정할 수 있습니다.
| Type: | AvailabilityReplicaFailoverMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
가용성 그룹을 복제본(replica) 속한 AvailabilityGroup 개체로 지정합니다.
| Type: | AvailabilityReplica |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
복제본(replica) 속한 가용성 그룹의 경로를 지정합니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 현재 작업 위치를 사용합니다.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadonlyRoutingConnectionUrl
다음 예제와 같이 읽기 전용 연결을 위해 복제본(replica) 라우팅할 때 사용할 FQDN(정규화된 도메인 이름) 및 포트를 지정합니다.
TCP://DBSERVER8.manufacturing.Contoso.com:7024
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadOnlyRoutingList
이 가용성 복제본(replica) 통해 읽기 전용 연결을 리디렉션할 때 사용할 연결 디렉터의 프로브 시퀀스를 나타내는 정렬된 복제본(replica) 서버 이름 목록을 지정합니다. 이 매개 변수는 가용성 복제본(replica) 가용성 그룹의 현재 기본 복제본(replica) 경우에 적용됩니다.
| Type: | String[] |
| 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 |
-SessionTimeout
연결이 실패하기 전에 기본 복제본(replica) 및 이 복제본(replica) 사이의 응답을 기다리는 시간(초)을 지정합니다.
| Type: | Int32 |
| 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.AvailabilityReplica