SQL Server PowerShell 모듈 설치

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Database 예Azure SQL Managed Instance 예Azure Synapse Analytics 예병렬 데이터 웨어하우스

이 문서에서는 SqlServer PowerShell 모듈 설치에 대한 지침을 제공합니다.

SQL Server용 PowerShell 모듈

SQL Server PowerShell 모듈에는 다음 두 가지가 있습니다.

  • SqlServer: SqlServer 모듈에는 최신 SQL 기능을 지원하는 새 cmdlet이 포함되어 있습니다. 또한 이 모듈에는 SQLPS 의 업데이트된 cmdlet 버전도 포함되어 있습니다. SqlServer 모듈을 다운로드하려면 PowerShell 갤러리의 SqlServer 모듈로 이동합니다.

  • SQLPS: SQLPS는 PowerShell 하위 시스템을 사용하여 에이전트 작업 단계에서 에이전트 작업을 실행하기 위해 SQL 에이전트에서 사용하는 모듈입니다.

참고

PowerShell 갤러리의 SqlServer 모듈 버전은 버전 관리를 지원하며 PowerShell 버전 5.0 이상이 필요합니다.

도움말 항목:

SQL Server Management Studio

SSMS(SQL Server Management Studio)도 PowerShell 모듈을 설치하지 않습니다. SSMS에서 PowerShell을 사용하려면 PowerShell 갤러리에서 SqlServer 모듈을 설치합니다.

참고

SSMS 16.x를 사용하는 경우 이전 버전의 SqlServer 모듈이 SSMS(SQL Server Management Studio)에 포함되어 있습니다.

Azure Data Studio

Azure Data Studio도 PowerShell 모듈을 설치하지 않습니다. Azure Data Studio에서 PowerShell을 사용하려면 PowerShell 갤러리에서 SqlServer 모듈을 설치합니다.

Azure Data Studio에서 풍부한 PowerShell 편집기 지원을 제공하는 PowerShell 확장을 사용할 수 있습니다.

SqlServer 모듈 설치 또는 업데이트

PowerShell 갤러리에서 SqlServer 모듈을 설치하려면 관리자로 PowerShell 세션을 시작합니다. 또한 통합 터미널의 PowerShell 세션에서 관리자로 Azure Data Studio를 시작하고 다음 명령을 실행할 수 있습니다.

Install-Module SQLServer -Scope CurrentUser 를 사용하여 상승된 권한을 실행할 수도 있습니다. 이 cmdlet은 해당 환경에서 관리자가 아닌 사용자에게 유용합니다. 그러나 범위가 현재 사용자로 제한되기 때문에 동일한 컴퓨터의 다른 사용자가 이 모듈을 사용할 수 없습니다.

SqlServer 모듈 설치

PowerShell 세션에서 다음 명령을 실행하여 모든 사용자에 대해 SqlServer 모듈을 설치합니다.

Install-Module -Name SqlServer

설치된 SqlServer 모듈의 버전을 보려면

다음 명령을 실행하여 설치된 SqlServer 모듈의 버전을 확인합니다.

Get-Module SqlServer -ListAvailable

관리자가 아닌 현재 사용자에 대해 설치

관리자로 PowerShell 세션을 실행할 수 없는 경우 다음 명령을 사용하여 현재 사용자에 대해 설치합니다.

Install-Module -Name SqlServer -Scope CurrentUser

이전 버전의 SqlServer 모듈을 덮어쓰려면

Install-Module 명령을 사용하여 이전 버전을 덮어쓸 수도 있습니다.

Install-Module -Name SqlServer -AllowClobber

참고

PowerShell은 항상 설치된 최신 모듈을 사용합니다.

설치된 SqlServer 모듈 버전 업데이트

SqlServer 모듈의 업데이트된 버전을 사용할 수 있는 경우 다음 명령을 사용하여 최신 버전을 설치할 수 있습니다.

Install-Module -Name SqlServer -AllowClobber

Update-Module 명령을 사용하여 최신 버전의 SQLServer PowerShell 모듈을 설치할 수 있지만 이전 버전은 제거되지 않습니다. 최신 버전을 실험해 볼 수 있도록 최신 버전을 설치하지만 이전 모듈도 여전히 설치되어 있습니다.

이전 모듈 버전을 유지하지 않으려면 Uninstall-Module 명령을 사용하여 이전 버전을 제거할 수 있습니다.

둘 이상의 버전이 설치된 경우 다음 명령을 사용하여 나열할 수 있습니다.

Get-Module SqlServer -ListAvailable

다음 명령을 사용하여 이전 버전을 제거할 수 있습니다.

Uninstall-module -Name SQLServer -RequiredVersion "<version number>" -AllowClobber

문제 해결

설치 시 문제가 발생할 경우 Install-Module 설명서Install-Module 참조를 참조하세요.

특정 버전의 SqlServer 모듈 사용

특정 버전의 모듈을 사용하려면 다음 명령과 비슷한 특정 버전 번호를 사용하여 가져옵니다.

Import-Module SqlServer -Version 21.1.18218

SqlServer 모듈의 시험판 버전

SqlServer 모듈의 시험판(또는 "미리 보기") 버전은 PowerShell 갤러리에서 사용할 수 있습니다.

중요

-AllowPrerelease 스위치를 전달하여 PowerShellGet 모듈의 일부인 업데이트된 Find-ModuleInstall-Module cmdlet을 사용하여 이러한 버전을 검색한 후 설치할 수 있습니다. 이러한 cmdlet을 사용하려면 PowerShellGet 모듈을 설치한 다음 새 세션을 엽니다.

SqlServer 모듈의 시험판 버전을 검색하려면

SqlServer 모듈의 시험판(미리 보기) 버전을 검색하려면 다음 명령을 실행합니다.

Find-Module SqlServer -AllowPrerelease

SqlServer 모듈의 특정 시험판 버전을 설치하려면

모듈의 특정 시험판 버전을 설치하려면 특정 버전 번호를 사용하여 설치합니다.

다음 명령을 사용할 수 있습니다.

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

Linux의 SQL Server PowerShell

Linux에서 SQL Server PowerShell을 설치하는 방법을 알아보려면 PowerShell Core를 사용하여 SQL Server on Linux 관리를 참조하세요.

기타 모듈

  • Az.Sql - Windows PowerShell 및 PowerShell Core의 Azure Resource Manager를 위한 SQL 서비스 cmdlet입니다.

  • SqlServerDsc - Microsoft SQL Server의 배포 및 구성을 위한 DSC 리소스가 포함된 모듈입니다.

Cmdlet 참조

다음 단계