Always On 가용성 그룹에 대한 PowerShell Cmdlet 개요(SQL Server)Overview of PowerShell Cmdlets for Always On Availability Groups (SQL Server)

이 항목은 다음에 적용됩니다. 예SQL Server(2016부터 시작)아니요Azure SQL 데이터베이스아니요Azure SQL 데이터 웨어하우스아니요병렬 데이터 웨어하우스THIS TOPIC APPLIES TO: yesSQL Server (starting with 2016)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

MicrosoftMicrosoft PowerShell은 시스템 관리를 위해 특별히 설계된 태스크 기반 명령줄 셸이자 스크립팅 언어입니다. PowerShell is a task-based command-line shell and scripting language designed especially for system administration. Always On 가용성 그룹Always On availability groups 은 가용성 그룹, 가용성 복제본 및 가용성 데이터베이스를 배포, 관리 및 모니터링할 수 있도록 SQL Server 2017SQL Server 2017 에 PowerShell cmdlet 집합을 제공합니다. provides a set of PowerShell cmdlets in SQL Server 2017SQL Server 2017 that enable you to deploy, manage, and monitor availability groups, availability replicas, and availability databases.

참고

PowerShell cmdlet은 작업을 시작하여 완료할 수 있습니다.A PowerShell cmdlet can complete by successfully initiating an action. 이것이 원하는 작업(예: 가용성 그룹 장애 조치)이 완료되었음을 나타내는 것은 아닙니다.This does not indicate that the intended work, such as the fail over of an availability group, has completed. 작업 시퀀스를 스크립팅하는 경우 작업 상태를 확인하고 작업이 완료되는 동안 기다려야 할 수 있습니다.When scripting a sequence of actions, you might have to check the status of actions, and wait for them to complete.

이 항목에서는 다음 태스크 집합에 대한 cmdlet에 대해 설명합니다.This topic introduces the cmdlets for the following sets of tasks:

참고

cmdlet을 사용하여 SQL Server 2017SQL Server 2017 태스크를 수행하는 방법을 설명하는 Always On 가용성 그룹Always On availability groups 온라인 설명서의 항목 목록은 Always On 가용성 그룹 개요(SQL Server)의 "관련 태스크" 섹션을 참조하세요.For a list of topics in SQL Server 2017SQL Server 2017 Books Online that describe how to use cmdlets to perform Always On 가용성 그룹Always On availability groups tasks, see the "Related Tasks" section of Overview of Always On Availability Groups (SQL Server).

Configuring a Server Instance for Always On Availability Groups Configuring a Server Instance for Always On Availability Groups

CmdletCmdlets 설명Description 지원되는 위치Supported on
Disable-SqlAlwaysOnDisable-SqlAlwaysOn 서버 인스턴스에서 Always On 가용성 그룹Always On availability groups 기능을 사용하지 않도록 설정합니다.Disables the Always On 가용성 그룹Always On availability groups feature on a server instance. Path, InputObject또는 Name 매개 변수에 지정된 서버The server instance that is specified by the Path, InputObject, or Name parameter. 인스턴스( SQL ServerSQL Server 을 지원하는 Always On 가용성 그룹Always On availability groups버전이어야 함)(Must be an edition of SQL ServerSQL Server that supports Always On 가용성 그룹Always On availability groups.)
Enable-SqlAlwaysOnEnable-SqlAlwaysOn Always On 가용성 그룹Always On availability groups 기능을 지원하는 SQL Server 2017SQL Server 2017 의 인스턴스에서 Always On 가용성 그룹Always On availability groups 을 사용하도록 설정합니다.Enables Always On 가용성 그룹Always On availability groups on an instance of SQL Server 2017SQL Server 2017 that supports the Always On 가용성 그룹Always On availability groups feature. Always On 가용성 그룹Always On availability groups 지원에 대한 자세한 내용은 Always On 가용성 그룹에 대한 필수 조건, 제한 사항 및 권장 사항(SQL Server)을 참조하세요.For information about support for Always On 가용성 그룹Always On availability groups, see Prerequisites, Restrictions, and Recommendations for Always On Availability Groups (SQL Server). SQL ServerSQL Server 을 지원하는 모든 Always On 가용성 그룹Always On availability groups버전Any edition of SQL ServerSQL Server that supports Always On 가용성 그룹Always On availability groups.
New-SqlHadrEndPointNew-SqlHadrEndPoint 서버 인스턴스에서 새 데이터베이스 미러링 끝점을 만듭니다.Creates a new database mirroring endpoint on a server instance. 이 끝점은 주 데이터베이스와 보조 데이터베이스 간에 데이터를 이동하는 데 필요합니다.This endpoint is required for data movement between primary and secondary databases. 다음의 모든 인스턴스 SQL ServerSQL ServerAny instance of SQL ServerSQL Server
Set-SqlHadrEndpointSet-SqlHadrEndpoint 기존 데이터베이스 미러링 끝점의 속성(예: 이름, 상태 또는 인증 속성)을 변경합니다.Changes the properties of an existing database mirroring endpoint, such as the name, state, or authentication properties. Always On 가용성 그룹Always On availability groups 을 지원하고 데이터베이스 미러링 끝점이 부족한 서버 인스턴스A server instance that supports Always On 가용성 그룹Always On availability groups and lacks a database mirroring endpoint

Backing Up and Restoring Databases and Transaction Logs Backing Up and Restoring Databases and Transaction Logs

CmdletCmdlets 설명Description 지원되는 위치Supported on
Backup-SqlDatabaseBackup-SqlDatabase 데이터 또는 로그 백업을 만듭니다.Creates a data or log backup. 온라인 데이터베이스( Always On 가용성 그룹Always On availability groups의 경우 주 복제본을 호스팅하는 서버 인스턴스의 데이터베이스)Any online database (for Always On 가용성 그룹Always On availability groups, a database on the server instance that hosts the primary replica)
Restore-SqlDatabaseRestore-SqlDatabase 백업을 복원합니다.Restores a backup. SQL ServerSQL Server 의 인스턴스( Always On 가용성 그룹Always On availability groups의 경우 보조 복제본을 호스팅하는 서버 인스턴스)Any instance of SQL ServerSQL Server (for Always On 가용성 그룹Always On availability groups, a server instance that hosts a secondary replica)

** 중요 *\* 보조 데이터베이스를 준비하는 경우 모든 Restore-SqlDatabase 명령에서 -NoRecovery 매개 변수를 사용해야 합니다.** Important *\* When preparing a secondary database, you must use the -NoRecovery parameter in every Restore-SqlDatabase command.

cmdlet을 사용하여 보조 데이터베이스를 준비하는 방법은 가용성 그룹에 대한 보조 데이터베이스 수동 준비(SQL Server)를 참조하세요.For information about using these cmdlets to prepare a secondary database, see Manually Prepare a Secondary Database for an Availability Group (SQL Server).

Creating and Managing an Availability Group Creating and Managing an Availability Group

CmdletCmdlets 설명Description 지원되는 위치Supported on
New-SqlAvailabilityGroupNew-SqlAvailabilityGroup 새 가용성 그룹을 만듭니다.Creates a new availability group. 주 복제본을 호스팅할 서버 인스턴스Server instance to host primary replica
Remove-SqlAvailabilityGroupRemove-SqlAvailabilityGroup 가용성 그룹을 삭제합니다.Deletes availability group. HADR 사용 서버 인스턴스HADR-enabled server instance
Set-SqlAvailabilityGroupSet-SqlAvailabilityGroup 가용성 그룹의 속성을 설정하고 가용성 그룹을 온라인/오프라인으로 전환합니다.Sets the properties of an availability group; take an availability group online/offline 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica
Switch-SqlAvailabilityGroupSwitch-SqlAvailabilityGroup 다음 형식의 장애 조치 중 하나를 시작합니다.Initiates one of the following forms of failover:

가용성 그룹의 강제 장애 조치(failover)(데이터가 손실될 수 있음)A forced failover of an availability group (with possible data loss).

가용성 그룹 수동 장애 조치(failover)A manual failover of an availability group.
대상 보조 복제본을 호스팅하는 서버 인스턴스Server instance that hosts target secondary replica

Creating and Managing an Availability Group Listener Creating and Managing an Availability Group Listener

CmdletCmdlet 설명Description 지원되는 위치Supported on
New-SqlAvailabilityGroupListenerNew-SqlAvailabilityGroupListener 새 가용성 그룹 수신기를 만들고 기존 가용성 그룹에 연결합니다.Creates a new availability group listener and attaches it to an existing availability group. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica
Set-SqlAvailabilityGroupListenerSet-SqlAvailabilityGroupListener 기존 가용성 수신기에서 포트 설정을 수정합니다.Modifies the port setting on an existing availability group listener. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica
Add-SqlAvailabilityGroupListenerStaticIpAdd-SqlAvailabilityGroupListenerStaticIp 기존 가용성 그룹 수신기 구성에 고정 IP 주소를 추가합니다.Adds a static IP address to an existing availability group listener configuration. IP 주소는 서브넷이 있는 IPv4 주소이거나 IPv6 주소일 수 있습니다.The IP address can be an IPv4 address with subnet, or an IPv6 address. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica

Creating and Managing an Availability Replica Creating and Managing an Availability Replica

CmdletCmdlets 설명Description 지원되는 위치Supported on
New-SqlAvailabilityReplicaNew-SqlAvailabilityReplica 새 가용성 복제본을 만듭니다.Creates a new availability replica. -AsTemplate 매개 변수를 사용하여 새 가용성 복제본별로 하나의 메모리 내 가용성 복제본 개체를 만들 수 있습니다.You can Use the -AsTemplate parameter to create an in-memory availability-replica object for each new availability replica. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica
Join-SqlAvailabilityGroupJoin-SqlAvailabilityGroup 보조 복제본을 가용성 그룹에 조인합니다.Joins a secondary replica to the availability group. 보조 복제본을 호스팅하는 서버 인스턴스Server instance that hosts secondary replica
Remove-SqlAvailabilityReplicaRemove-SqlAvailabilityReplica 가용성 복제본을 삭제합니다.Deletes an availability replica. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica
Set-SqlAvailabilityReplicaSet-SqlAvailabilityReplica 가용성 복제본의 속성을 설정합니다.Sets the properties of an availability replica. 주 복제본을 호스팅하는 서버 인스턴스Server instance that hosts primary replica

Adding and Managing an Availability Database Adding and Managing an Availability Database

CmdletCmdlets 설명Description 지원되는 위치Supported on
Add-SqlAvailabilityDatabaseAdd-SqlAvailabilityDatabase 주 복제본에서 데이터베이스를 가용성 그룹에 추가합니다.On the primary replica, adds a database to an availability group.

보조 복제본에서 보조 데이터베이스를 가용성 그룹에 조인합니다.On a secondary replica, joins a secondary database to an availability group.
가용성 복제본을 호스팅하는 모든 서버 인스턴스(주 복제본과 보조 복제본의 동작이 서로 다름)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Remove-SqlAvailabilityDatabaseRemove-SqlAvailabilityDatabase 주 복제본에서 데이터베이스를 가용성 그룹에서 제거합니다.On the primary replica, removes the database from the availability group.

보조 복제본에서 로컬 보조 데이터베이스를 로컬 보조 복제본에서 제거합니다.On a secondary replica, removes the local secondary database from the local secondary replica.
가용성 복제본을 호스팅하는 모든 서버 인스턴스(주 복제본과 보조 복제본의 동작이 서로 다름)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Resume-SqlAvailabilityDatabaseResume-SqlAvailabilityDatabase 일시 중지된 가용성 데이터베이스에 대한 데이터 이동을 재개합니다.Resumes the data movement for a suspended availability database. 데이터베이스가 일시 중지된 서버 인스턴스The server instance on which the database was suspended.
Suspend-SqlAvailabilityDatabaseSuspend-SqlAvailabilityDatabase 가용성 데이터베이스에 대한 데이터 이동을 일시 중지합니다.Suspends the data movement for an availability database. 가용성 복제본을 호스팅하는 서버 인스턴스Any server instance that hosts an availability replica.

Monitoring Availability Group Health Monitoring Availability Group Health

다음 SQL ServerSQL Server cmdlet을 사용하면 가용성 그룹과 가용성 그룹의 복제본 및 데이터베이스의 상태를 모니터링할 수 있습니다.The following SQL ServerSQL Server cmdlets enable you to monitor the health of an availability group and its replicas and databases.

중요

이 cmdlet을 실행하려면 연결, 서버 상태 보기 및 모든 정의 보기 권한이 있어야 합니다.You must have CONNECT, VIEW SERVER STATE, and VIEW ANY DEFINITION permissions to execute these cmdlets.

CmdletCmdlet 설명Description 지원되는 위치Supported on
Test-SqlAvailabilityGroupTest-SqlAvailabilityGroup SQL Server PBM(정책 기반 관리) 정책을 평가하여 가용성 그룹의 상태를 평가합니다.Assesses the health of an availability group by evaluating SQL Server policy based management (PBM) policies. 가용성 복제본을 호스팅하는 서버 인스턴스Any server instance that hosts an availability replica.
Test-SqlAvailabilityReplicaTest-SqlAvailabilityReplica SQL Server PBM(정책 기반 관리) 정책을 평가하여 가용성 복제본의 상태를 평가합니다.Assesses the health of availability replicas by evaluating SQL Server policy based management (PBM) policies. 가용성 복제본을 호스팅하는 서버 인스턴스Any server instance that hosts an availability replica.
Test-SqlDatabaseReplicaStateTest-SqlDatabaseReplicaState SQL Server PBM(정책 기반 관리) 정책을 평가하여 모든 조인된 가용성 복제본에 대한 가용성 데이터베이스 상태를 평가합니다.Assesses the health of an availability database on all joined availability replicas by evaluating SQL Server policy based management (PBM) policies. 가용성 복제본을 호스팅하는 서버 인스턴스Any server instance that hosts an availability replica.

가용성 그룹의 모든 가용성 복제본에 대한 정보를 보려면 주 복제본을 호스팅하는 서버 인스턴스를 사용합니다.To view information about all of the availability replicas in an availability group, use to the server instance that hosts the primary replica.

자세한 내용은 Always On 정책을 사용하여 가용성 그룹의 상태 보기(SQL Server)를 참조하세요.For more information, see Use Always On Policies to View the Health of an Availability Group (SQL Server).

관련 항목:See Also

Always On 가용성 그룹 개요(SQL Server) Overview of Always On Availability Groups (SQL Server)
SQL Server PowerShell 도움말 보기Get Help SQL Server PowerShell