SQL Server PowerShell

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)

SQL Server PowerShell 설치

SQL Server PowerShell 모듈에는 SqlServer와 SQLPS의 두 가지가 있습니다.

SqlServer 모듈이 사용할 현재 PowerShell 모듈입니다.

SQLPS 모듈은 (이전 버전과의 호환성을 위해) SQL Server 설치에 포함되어 있지만 더 이상 업데이트되지 않습니다.

SqlServer 모듈은 SQLPS에 업데이트된 버전의 cmdlet이 포함되어 있으며, 최신 SQL 기능을 지원하는 새로운 cmdlet이 포함되어 있습니다.

이전 버전의 SqlServer 모듈은 SSMS(SQL Server Management Studio)에 포함되었습니다(SSMS 16.x 버전만 해당).

SSMS 17.0 이상에서 PowerShell을 사용하려면 PowerShell 갤러리에서 SqlServer 모듈을 설치합니다.

또한 Azure Data Studio와 함께 PowerShell을 사용할 수 있습니다.

모듈이 SQLPS에서 SqlServer로 변경된 이유는 무엇인가요?

SQL PowerShell 업데이트를 제공하려면 SQL PowerShell 모듈의 ID와 SQLPS.exe라는 래퍼를 변경해야 했습니다. 이러한 변경으로 인해 이제 SqlServer 모듈과 SQLPS 모듈이라는 두 가지 SQL PowerShell 모듈이 있습니다.

SQLPS 모듈을 가져오는 경우 PowerShell 스크립트를 업데이트하세요.

Import-Module -Name SQLPS를 실행하는 PowerShell 스크립트가 있다면 새로운 공급자 기능과 새로운 cmdlet을 활용하는 것이 좋으며 이를 Import-Module -Name SqlServer로 변경해야 합니다. 새 모듈이 %ProgramFiles%\WindowsPowerShell\Modules\SqlServer 폴더에 설치됩니다. 따라서 $env:PSModulePath 변수를 업데이트할 필요가 없습니다. SqlServer라는 모듈의 타사 또는 커뮤니티 버전을 사용하는 스크립트가 있는 경우 접두사 매개 변수를 사용하여 이름 충돌을 방지합니다.

SQLPS 모듈이 동일한 컴퓨터에 설치된 경우 병렬 문제를 방지하려면 Import-Module SQLServer를 사용하여 스크립트를 시작하는 것이 좋습니다.

이 섹션은 SQL 에이전트가 아닌 PowerShell에서 실행되는 스크립트에 적용됩니다. 새 모듈은 #NOSQLPS를 사용하여 SQL 에이전트 작업 단계와 함께 사용할 수 있습니다.

SQL Server PowerShell 구성 요소

SqlServer 모듈에는 다음이 함께 제공됩니다.

  • 파일 시스템 경로와 유사한 간단한 탐색 메커니즘을 제공하는 PowerShell 공급자. 드라이브가 SQL Server 관리 개체 모델과 연결되고 노드가 개체 모델 클래스를 기반으로 하는 파일 시스템 경로와 비슷한 경로를 작성할 수 있습니다. 그런 다음, 명령 프롬프트 창에서 폴더를 탐색하는 것과 비슷한 방법으로 cd(Set-Location에 대한 별칭) 및 dir(Get-ChildItem에 대한 별칭)과 같은 친숙한 명령을 사용하여 경로를 탐색할 수 있습니다. ren(Rename-Item에 대한 별칭) 또는 del(Remove-Item에 대한 별칭)과 같은 다른 명령을 사용하여 경로의 노드에 동작을 수행할 수 있습니다.

  • Transact-SQL 또는 XQuery 문이 포함된 sqlcmd 스크립트 실행과 같은 동작을 지원하는 cmdlet 집합.

  • 별도로 설치되기 전의 AS 공급자 및 cmdlet.

SQL Server 버전

SQL PowerShell cmdlet을 사용하여 Azure SQL 데이터베이스, Azure Synapse Analytics 및 모든 지원되는 SQL Server 제품의 인스턴스를 관리할 수 있습니다.

PowerShell 경로에서 지원되지 않는 문자가 포함된 SQL Server 식별자

Encode-Sqlname(ConvertTo-EncodedSqlName에 대한 별칭) 및 Decode-Sqlname(ConvertFrom-EncodedSqlName에 대한 별칭) cmdlet을 사용하면 PowerShell 경로에서 지원되지 않는 문자가 포함된 SQL Server 식별자를 지정할 수 있습니다. 자세한 내용은 PowerShell의 SQL Server 식별자를 참조하세요.

Convert-UrnToPath cmdlet을 사용하여 데이터베이스 엔진 개체의 고유 리소스 이름을 SQL Server PowerShell 공급자의 경로로 변환합니다. 자세한 내용은 URN을 SQL Server 공급자 경로로 변환을 참조하세요.

쿼리 식 및 URN

쿼리 식은 XPath와 유사한 구문을 사용하여 개체 모델 계층 구조에서 하나 이상의 개체를 열거하는 조건 집합을 지정하는 문자열입니다. URN(Uniform Resource Name)은 단일 개체를 고유하게 식별하는 특정 유형의 쿼리 식 문자열입니다. 자세한 내용은 Query Expressions and Uniform Resource Names을(를) 참조하세요.

SQL Server 에이전트

SQL Server 에이전트에서 사용하는 모듈에 대한 변경 사항은 없습니다. 따라서 PowerShell 유형 작업 단계가 있는 SQL Server 에이전트 작업은 SQLPS 모듈을 사용합니다. 자세한 내용은 SQL Server 에이전트 사용하여 PowerShell을 실행하는 방법을 참조하세요. 그러나 SQL Server 2019부터 SQLPS를 사용하지 않도록 설정할 수 있습니다. 이렇게 하려면 #NOSQLPS을(를) 추가할 수 있는 PowerShell 형식의 작업 단계 첫 번째 줄에서 SQL 에이전트가 SQLPS 모듈을 자동으로 로드하지 못하도록 합니다. 이렇게 하면 SQL 에이전트 작업이 컴퓨터에 설치된 PowerShell 버전을 실행한 다음에 원하는 다른 PowerShell 모듈을 사용할 수 있습니다.

SQLPS 문제 해결

다음 오류가 발생하여 에이전트 작업 단계(PowerShell 하위 시스템)가 실패하는 경우 이 섹션이 문제 해결에 유용할 수 있습니다.

PowerShell 스크립트의 첫째 줄에서 작업 단계에 대한 오류가 표시되었습니다. 해당 줄은 'import-module SQLPS'입니다. 스크립트를 수정하고 작업 일정을 다시 예약합니다. PowerShell에서 반환된 오류 정보는 '지정된 모듈 'SQLPS'가 로드되지 않았습니다. 모듈 디렉터리에서 유효한 모듈 파일을 찾을 수 없기 때문입니다.

PSModulePath 환경 변수에서 SQLPS 모듈을 사용할 수 있어야 합니다. SSMS 16.x를 제거하면 PSModulePath에서 SQLPS가 제거될 수도 있습니다. PSModulePath에 저장된 현재 값을 확인하려면 다음 PowerShell을 실행합니다.

 $env:PSModulePath -split ";"

경로가 설정된 경우 C:\Program Files (x86)\Microsoft SQL Server\130\Tools\PowerShell\Modules과(와) 유사한 항목이 표시됩니다. 경로가 설정되지 않은 경우 서버에서 SQLPS 폴더를 찾아 PowerShell 또는 시스템 속성>고급>환경 변수를 통해 환경 변수 값에 추가합니다.

SQL 에이전트를 사용한 SQLServer 모듈

SQL 에이전트 작업 단계에서 SqlServer 모듈을 사용하려는 경우 스크립트의 처음 두 줄에 이 코드를 배치할 수 있습니다.

#NOSQLPS
Import-Module -Name SqlServer

Cmdlet 참조

다음 단계