다음을 통해 공유

Enable-SqlAlwaysOn

  • 참조
모듈:
SQLServer

Always On 가용성 그룹 기능을 사용하도록 설정합니다.

구문

Enable-SqlAlwaysOn
      [[-Path] <String>]
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      [-InputObject] <Server>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      -ServerInstance <String>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Enable-SqlAlwaysOn cmdlet을 사용하면 SQL Server 인스턴스에서 Always On을 사용할 수 있습니다.

SQL Server 서비스가 실행되는 동안 Always On 가용성 그룹 기능을 사용하도록 설정한 경우 변경 내용을 완료하려면 데이터베이스 엔진 서비스를 다시 시작해야 합니다.

Force 매개 변수를 지정하지 않는 한 cmdlet은 서비스를 다시 시작하라는 메시지를 표시합니다.

Always On 가용성 그룹 기능을 이미 사용하도록 설정한 경우 아무 작업도 수행되지 않습니다.

이 cmdlet은 원격 서비스에 대해 실행할 수 있습니다.

이 cmdlet을 실행하려면 관리자 권한이 있어야 합니다.

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

예제

예제 1: 지정된 경로에서 Always On 가용성 그룹 사용

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"

이 명령을 사용하면 지정된 경로에 있는 SQL Server 인스턴스에서 Always On 가용성 그룹을 사용할 수 있습니다. 이 변경을 수행하려면 인스턴스를 다시 시작해야 하며 이 다시 시작을 확인하라는 메시지가 표시됩니다.

예제 2: 지정된 경로에서 Always On 가용성 그룹을 사용하도록 설정하고 확인 없이 서버를 다시 시작합니다.

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force

이 명령을 사용하면 지정된 경로에 있는 SQL Server 인스턴스에서 Always On 가용성 그룹을 사용할 수 있습니다. 강제 옵션을 사용하면 확인 메시지를 표시하지 않고 서버 인스턴스를 다시 시작합니다.

예제 3: 지정된 서버 인스턴스에 Always On 가용성 그룹 사용

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance"

이 명령은 Computer\Instance라는 SQL Server 인스턴스에서 Always On 가용성 그룹을 사용하도록 설정합니다. 이 변경을 수행하려면 인스턴스를 다시 시작해야 하며 이 다시 시작을 확인하라는 메시지가 표시됩니다.

예제 4: Windows 인증을 사용하여 지정된 서버 인스턴스에 Always On 가용성 그룹 사용

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")

이 명령은 Windows 인증을 사용하여 'Computer\Instance'라는 SQL Server 인스턴스에서 Always On 가용성 그룹을 사용하도록 설정합니다. 지정된 계정의 암호를 입력하라는 메시지가 표시됩니다. 이 변경을 수행하려면 인스턴스를 다시 시작해야 하며 이 다시 시작을 확인하라는 메시지도 표시됩니다.

예제 5: 서버를 다시 시작하지 않고 지정된 경로에서 Always On 가용성 그룹 사용

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart

이 명령을 사용하면 지정된 경로에 있는 SQL Server 인스턴스에서 Always On 가용성 그룹을 사용할 수 있지만 이 명령은 인스턴스를 다시 시작하지 않습니다. 이 서버 인스턴스를 수동으로 다시 시작할 때까지 변경 내용이 적용되지 않습니다.

매개 변수

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

Always On 가용성 그룹 기능을 사용하도록 설정할 SQL Server 인스턴스의 이름을 지정합니다. MACHINENAME\INSTANCE 형식입니다. 원격 서버에서 이 설정을 사용하려면 자격 증명 매개 변수와 함께 사용합니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다. 이 매개 변수는 스크립트 생성을 허용하기 위해 제공됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

SQL Server 인스턴스의 서버 개체를 지정합니다.

형식:Server
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-NoServiceRestart

사용자에게 SQL Server 서비스를 다시 시작하라는 메시지가 표시되지 않음을 나타냅니다. 변경 내용을 적용하려면 SQL Server 서비스를 수동으로 다시 시작해야 합니다. 이 매개 변수를 설정하면 Force가 무시됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Path

SQL Server 인스턴스의 경로를 지정합니다. 선택적 매개 변수입니다. 지정하지 않으면 현재 작업 위치가 사용됩니다.

형식:String
Position:1
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProgressAction

powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.

형식:ActionPreference
별칭:proga
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerInstance

SQL Server 인스턴스의 이름을 지정합니다. MACHINENAME\INSTANCE 형식입니다. 원격 서버에서 이 설정을 사용하려면 자격 증명 매개 변수와 함께 사용합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.SqlServer.Management.Smo.Server

System.String

출력

System.Object