SQL Server PowerShell 공급자에 인스턴스 지정

  • 아티클

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

SQL Server PowerShell 공급자에 대해 지정된 경로는 데이터베이스 엔진의 인스턴스와 해당 엔진 인스턴스가 실행되고 있는 컴퓨터를 식별해야 합니다. 컴퓨터와 인스턴스를 지정하는 구문은 SQL Server 식별자 및 Windows PowerShell 경로에 대한 규칙을 모두 준수해야 합니다.

참고 항목

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

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

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

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

PowerShell 갤러리에서 SqlServer 모듈을 설치합니다.

자세한 내용은 SQL Server PowerShell을 참조하세요.

시작하기 전에

SQL Server 공급자 경로에서 SQLSERVER:\SQL 다음의 첫 번째 노드는 데이터베이스 엔진 인스턴스를 실행하는 컴퓨터의 이름입니다. 예를 들면 다음과 같습니다.

SQLSERVER:\SQL\MyComputer

데이터베이스 엔진 인스턴스와 동일한 컴퓨터에서 Windows PowerShell을 실행하는 경우 컴퓨터 이름 대신 localhost 또는 (local)을 사용할 수 있습니다. localhost 또는 (local)을 사용하는 스크립트는 다른 컴퓨터 이름을 반영하도록 변경할 필요 없이 모든 컴퓨터에서 실행할 수 있습니다.

동일한 컴퓨터에서 데이터베이스 엔진 실행 파일 프로그램의 여러 인스턴스를 실행할 수 있습니다. SQL Server 공급자 경로에서 컴퓨터 이름을 따르는 노드는 인스턴스를 식별합니다. 예를 들면 다음과 같습니다.

SQLSERVER:\SQL\MyComputer\MyInstance

각 컴퓨터에는 데이터베이스 엔진의 기본 인스턴스가 하나 있을 수 있습니다. 기본 인스턴스를 설치할 때는 이름을 지정하지 않습니다. 연결 문자열의 컴퓨터 이름만 지정하면 해당 컴퓨터의 기본 인스턴스에 연결됩니다. 컴퓨터의 다른 모든 인스턴스는 명명된 인스턴스여야 합니다. 설치하는 동안 인스턴스 이름을 지정하고 연결 문자열은 컴퓨터 이름과 인스턴스 이름을 모두 지정해야 합니다.

제한 사항

마침표(.)를 사용하여 PowerShell 스크립트에서 로컬 컴퓨터를 지정할 수 없습니다. 마침표는 PowerShell에서 명령으로 해석되므로 지원되지 않습니다.

(local)의 괄호 문자는 일반적으로 Windows PowerShell에서 명령으로 처리됩니다. 따라서 경로에 사용할 수 있도록 괄호 문자를 인코딩 또는 이스케이프하거나, 경로를 큰따옴표로 묶어야 합니다. 자세한 내용은 SQL Server 식별자 인코딩 및 디코딩을 참조하세요.

SQL Server 공급자는 항상 인스턴스 이름을 지정해야 합니다. 기본 인스턴스의 경우 DEFAULT의 인스턴스 이름을 지정해야 합니다.

예제; 컴퓨터 및 인스턴스 이름

이 예제에서는 localhost 및 DEFAULT를 사용하여 로컬 컴퓨터에서 기본 인스턴스를 지정합니다.

Set-Location SQLSERVER:\SQL\localhost\DEFAULT

(local)의 괄호 문자는 일반적으로 Windows PowerShell에서 명령으로 처리됩니다. 다음 중 하나를 수행해야 합니다.

  • 경로 문자열을 따옴표로 묶습니다.

    Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"

  • 백틱 문자(')를 사용하여 괄호를 이스케이프합니다.

    Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT

  • 16진수 표현을 사용하여 괄호를 인코딩합니다.

    Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT

참고 항목

PowerShell의 SQL Server 식별자
SQL Server PowerShell 공급자
SQL Server PowerShell