SQL Server PowerShell 모듈 설치

아티클
06/01/2023

적용 대상:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

이 문서에서는 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.1 이상이 필요합니다.

도움말 항목:

SqlServer cmdlet.
SQLPS cmdlet.

SQL Server Management Studio

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

참고 항목

SSMS(SQL Server Management Studio) 16.x(및 이전 버전)에는 SQLPS 모듈이 포함됐습니다.

Azure Data Studio

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

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

SqlServer 모듈 설치 또는 업데이트

PowerShell 갤러리에서 SqlServer 모듈을 설치하려면 관리자로 PowerShell 세션을 시작하고 Install-Module SQLServer를 실행합니다.

Install-Module -Name SqlServer

Windows PowerShell에서 실행하는 경우 Install-Module SQLServer -Scope CurrentUser를 사용하여 현재 사용자에 대해서만 모듈을 설치하고 상승된 권한이 필요하지 않도록 할 수 있습니다.

모든 사용자에 대해 SqlServer 모듈 설치

모든 사용자에 대해 SqlServer 모듈을 설치하려면 상승된 PowerShell 세션에서 아래 명령을 실행합니다. PowerShell 세션은 관리자 권한으로 시작합니다.

Install-Module -Name SqlServer

오프라인 컴퓨터에 SqlServer 모듈 설치

이 섹션에서는 인터넷에 액세스할 수 없는 컴퓨터에 SqlServer PowerShell 모듈을 설치하는 단계를 안내합니다. 이 모듈을 설치하려면 인터넷에 연결된 컴퓨터와 오프라인(인터넷에 연결되지 않은) 상태인 대상 컴퓨터라는 두 대의 컴퓨터가 필요합니다.

인터넷에 연결된 컴퓨터에서 SQLServer PowerShell 모듈을 다운로드합니다. 이 명령은 -Path 매개 변수에 정의된 샘플 $env:TEMP\SQLServer\<SomeVersion> 폴더에 모듈의 모든 파일을 다운로드하고 저장합니다. 인터넷에 연결된 컴퓨터에서 원하는 폴더를 대상으로 선택할 수 있습니다.
```
Save-Module -Name SqlServer -Path $env:TEMP
```
파일 탐색기의 폴더 위치로 이동하여 $env:TEMP\SQLServer\<SomeVersion> 폴더가 있는지 확인하거나 다음 명령을 실행합니다.
```
Get-ChildItem -Path $env:TEMP\SQLServer\
```
2단계에서 찾은 $env:TEMP\SQLServer\<SomeVersion> 폴더를 %ProgramFiles%\WindowsPowerShell\Modules\SqlServer 폴더의 대상 오프라인 컴퓨터에 복사합니다(이 폴더는 PS5 및 PS7 모두에서 작동함). <SomeVersion>을(를) 이전 단계에서 찾은 값으로 반드시 바꿉니다.

다음의 PowerShell cmdlet을 실행하여 오프라인 컴퓨터에서 SqlServer PowerShell 모듈을 사용할 수 있는지 확인합니다.

Get-Module SqlServer -ListAvailable

출력은 다음과 같이 표시될 수 있습니다(실제 버전은 다를 수 있으며 이전에 나열된 <SomeVersion>과(와) 일치해야 함).

   PS C:\Users\user1> Get-Module SqlServer -ListAvailable

       Directory: C:\Program Files\WindowsPowerShell\Modules

   ModuleType Version    Name                     ExportedCommands
   ---------- -------    ----                     ----------------
   Script     22.1.1     SqlServer                {Add-RoleMember, Add-SqlAvail...

설치된 SqlServer 모듈의 버전 보기

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

Get-Module SqlServer -ListAvailable

현재 세션에서 로드된 SqlServer 모듈의 버전을 보려면

(Get-Module SqlServer).Version

이전 버전의 SqlServer 모듈을 덮어씁니다.

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

Install-Module -Name SqlServer -AllowClobber

참고

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

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

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

Update-Module -Name SqlServer -AllowClobber

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

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

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

Get-Module SqlServer -ListAvailable

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

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

문제 해결

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

특정 버전의 SqlServer 모듈 사용

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

Import-Module SqlServer -Version 21.1.18218

SqlServer 모듈의 시험판 버전

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

중요

-AllowPrerelease 스위치를 전달하여 PowerShellGet 모듈의 일부인 업데이트된 Find-Module 및 Install-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을 사용하여 SQL Server on Linux 관리를 참조하세요.

기타 모듈

Az.Sql - Windows PowerShell 및 PowerShell의 Azure Resource Manager를 위한 SQL 서비스 cmdlet입니다.
SqlServerDsc - Microsoft SQL Server의 배포 및 구성을 위한 DSC 리소스가 포함된 모듈입니다.