두 개의 SQL Server PowerShell 모듈이 있습니다. SqlServer 및 SQLPS.
SqlServer 모듈은 사용할 현재 PowerShell 모듈입니다.
SQLPS 모듈은 이전 버전과의 호환성을 위해 SQL Server 설치에 포함되어 있지만 더 이상 업데이트되지 않습니다.
SqlServer 모듈에는 SQLPS의 업데이트된 버전의 cmdlet이 포함되어 있으며 최신 SQL 기능을 지원하는 새 cmdlet이 포함되어 있습니다.
이전 버전의 SqlServer 모듈은 /sql/ssms/download-sql-server-management-studio-ssms에 포함되었지만 SSMS의 16.x 버전에만 포함 되었습니다 .
SSMS 17.0 이상에서 PowerShell을 사용하려면 PowerShell 갤러리에서 SqlServer 모듈을 설치합니다.
Azure Data Studio에 대한 PowerShell 편집기 지원을 사용할 수도 있습니다.
모듈이 SQLPS에서 SqlServer로 변경된 이유는 무엇인가요?
SQL PowerShell 업데이트를 제공하려면 SQL PowerShell 모듈의 ID와 SQLPS.exe래퍼를 변경해야 했습니다. 이 변경으로 인해 이제 두 개의 SQL PowerShell 모듈인 SqlServer 모듈과 SQLPS 모듈이 있습니다.
SQLPS 모듈을 가져오는 경우 PowerShell 스크립트를 업데이트합니다.
실행되는 Import-Module -Name SQLPSPowerShell 스크립트가 있고 새 공급자 기능 및 새 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 Database, 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 공급자의 경로로 변환합니다. 자세한 내용은 Convert-UrnToPath를 참조하세요.
쿼리 식 및 균일한 리소스 이름
쿼리 식은 XPath와 유사한 구문을 사용하여 개체 모델 계층 구조에서 하나 이상의 개체를 열거하는 조건 집합을 지정하는 문자열입니다. URN(Uniform Resource Name)은 단일 개체를 고유하게 식별하는 특정 형식의 쿼리 식 문자열입니다. 자세한 내용은 쿼리 식 및 균일한 리소스 이름을 참조하세요.
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'가 로드되지 않았습니다. 모듈 디렉터리에서 유효한 모듈 파일을 찾을 수 없기 때문입니다.
SQLPS 모듈은 환경 변수 PSModulePath에서 사용할 수 있어야 합니다. 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