SQL Server PowerShell 모듈 설치

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

SQL Server용 PowerShell 모듈

두 가지 SQL Server PowerShell 모듈이 있습니다.

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

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

도움말 문서는 다음으로 이동합니다.

• SqlServer cmdlet.
• SQLPS cmdlet.

SSMS(SQL Server Management Studio)

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

Azure Data Studio

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

Azure Data Studio에서 풍부한 PowerShell 편집기 지원을 제공하는 Azure Data Studio에 대한 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 모듈을 설치하는 단계를 안내합니다. 이 설치를 수행하려면 인터넷에 연결된 컴퓨터와 오프라인 대상 컴퓨터라는 두 대의 컴퓨터가 필요합니다.

1. 인터넷에 연결된 컴퓨터에서 SQLServer PowerShell 모듈을 다운로드합니다. 이 명령은 $env:TEMP\SQLServer\<SomeVersion> 매개 변수에 정의된 샘플 폴더에 모듈의 모든 파일을 다운로드하고 저장합니다. 인터넷에 연결된 컴퓨터에서 원하는 폴더를 대상으로 선택할 수 있습니다.

   Save-Module -Name SqlServer -Path $env:TEMP
   

2. 파일 탐색기에서 폴더 위치로 이동하여 폴더가 있는지 $env:TEMP\SQLServer\<SomeVersion> 확인하거나 다음 명령을 실행합니다.

   Get-ChildItem -Path $env:TEMP\SQLServer\
   

3. $env:TEMP\SQLServer\<SomeVersion> 2단계에서 찾은 폴더를 폴더의 대상 오프라인 컴퓨터에 %ProgramFiles%\WindowsPowerShell\Modules\SqlServer 복사합니다(이 폴더는 PS5 및 PS7 모두에서 작동함). 이전 단계에서 찾은 값으로 바꿔 <SomeVersion> 야 합니다.

4. 다음 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

설치된 버전의 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 갤러리에서 사용할 수 있습니다.

SqlServer 모듈의 시험판 버전 검색

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

Find-Module SqlServer -AllowPrerelease

SqlServer 모듈의 특정 시험판 버전 설치

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

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

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

Linux의 SQL Server PowerShell

/sql/linux/sql-server-linux-manage-powershell-core를 방문하여 Linux에 SQL Server PowerShell을 설치하는 방법을 알아보세요.

기타 모듈

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

• SqlServerDsc - Microsoft SQL Server를 배포하고 구성하기 위한 DSC 리소스가 있는 모듈입니다.

Cmdlet 참조

• SqlServer cmdlet
• SQLPS cmdlet

관련 콘텐츠

• SQL Server PowerShell
• SQL Server PowerShell cmdlet
• Azure Data Studio에 대한 PowerShell 편집기 지원