Switch-SqlAvailabilityGroup

참조

모듈:: SQLServer

가용성 그룹을 보조 복제본(replica) 장애 조치(failover)를 시작합니다.

Syntax

Switch-SqlAvailabilityGroup
      [-AllowDataLoss]
      [-Force]
      [[-Path] <String[]>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Switch-SqlAvailabilityGroup
      [-AllowDataLoss]
      [-Force]
      [-InputObject] <AvailabilityGroup[]>
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Switch-SqlAvailabilityGroup cmdlet은 가용성 그룹을 지정된 보조 복제본(replica) 장애 조치(failover)를 시작합니다. 대상 보조 복제본(replica) 이 cmdlet을 실행합니다. 장애 조치(failover) 후 보조 복제본(replica) 기본 복제본(replica) 됩니다.

예제

예제 1: 가용성 그룹 장애 조치(failover)

PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"

이 명령은 라는 서버 instance 가용성 그룹의 MainAG 수동 장애 조치(SecondaryServer\InstanceNamefailover)를 수행합니다. 이 명령은 데이터 손실을 허용하지 않습니다. 장애 조치(failover)할 보조 복제본(replica) 호스트하는 서버 instance 이 명령을 실행합니다.

예제 2: 가용성 그룹이 장애 조치(failover)되도록 강제 적용

PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -AllowDataLoss

이 명령은 라는 서버 instance 가용성 그룹의 MainAG 수동 장애 조치(SecondaryServer\InstanceNamefailover)를 수행합니다. 명령은 AllowDataLoss 매개 변수를 지정합니다. 따라서 장애 조치(failover)는 데이터가 손실될 가능성이 있으며 명령은 확인을 요청합니다. 확인을 건너뛰려면 Force 매개 변수를 지정합니다.

예제 3: 가용성 그룹을 장애 조치(failover)하는 스크립트 만들기

PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Script

이 명령은 라는 SecondaryServer\InstanceName서버 instance 가용성 그룹의 MainAG 수동 장애 조치(failover)를 수행하는 Transact-SQL 스크립트를 만듭니다. 스크립트는 데이터 손실을 허용하지 않습니다. 이 명령은 장애 조치(failover)를 일으키지 않습니다.

매개 변수

-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

-AllowDataLoss

이 cmdlet이 대상 보조 복제본(replica) 대한 강제 장애 조치(failover)를 시작했음을 나타냅니다. 데이터 손실이 발생할 수 있습니다. Force 또는 Script 매개 변수를 지정하지 않으면 cmdlet에서 확인 메시지를 표시합니다.

Type:	SwitchParameter
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

-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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다. 이 cmdlet은 AllowDataLoss 매개 변수를 지정하는 경우에만 확인 메시지를 표시합니다.

Type:	SwitchParameter
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이 장애 조치(fail over)되는 가용성 그룹을 지정합니다.

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

-Path

이 cmdlet이 장애 조치(fail over)하는 가용성 그룹의 경로를 지정합니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 현재 작업 위치를 사용합니다.

Type:	String[]
Position:	1
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.AvailabilityGroup[]

가용성 그룹을 이 cmdlet에 전달할 수 있습니다.

Switch-SqlAvailabilityGroup

Syntax

Description

예제

예제 1: 가용성 그룹 장애 조치(failover)

예제 2: 가용성 그룹이 장애 조치(failover)되도록 강제 적용

예제 3: 가용성 그룹을 장애 조치(failover)하는 스크립트 만들기

매개 변수

-AccessToken

-AllowDataLoss

-Confirm

-Encrypt

-Force

-HostNameInCertificate

-InputObject

-Path

-Script

-TrustServerCertificate

-WhatIf

입력

관련 링크

추가 리소스