SQL Server PowerShell 공급자에 인스턴스 지정Specify Instances in the SQL Server PowerShell Provider

SQL Server PowerShell 공급자에 대해 지정되는 경로는 데이터베이스 엔진Database Engine 의 인스턴스와 해당 인스턴스가 실행 중인 컴퓨터를 식별해야 합니다.The paths specified for the SQL Server PowerShell provider must identify the instance of the 데이터베이스 엔진Database Engine and the computer it is running on. 컴퓨터와 인스턴스를 지정하는 구문은 SQL Server 식별자 규칙과 Windows PowerShell 경로 규칙을 모두 준수해야 합니다.The syntax for specifying the computer and the instance must comply with both the rules for SQL Server identifiers and Windows PowerShell paths.

  1. Before you begin: Limitations and RestrictionsBefore you begin: Limitations and Restrictions

  2. To specify an instance: ExamplesTo specify an instance: Examples

시작하기 전에Before You Begin

SQL Server 공급자 경로에서 SQLSERVER:\SQL 다음에 오는 첫 번째 노드는 데이터베이스 엔진Database Engine인스턴스를 실행하는 컴퓨터 이름입니다. 예를 들면 다음과 같습니다.The first node following the SQLSERVER:\SQL in a SQL Server provider path is the name of the computer that is running the instance of the 데이터베이스 엔진Database Engine; for example:

SQLSERVER:\SQL\MyComputer  

데이터베이스 엔진Database Engine인스턴스와 동일한 컴퓨터에 Windows PowerShell을 실행하는 경우 컴퓨터 이름 대신 localhost 또는 (local)을 사용할 수 있습니다.If you are running Windows PowerShell on the same computer as the instance of the 데이터베이스 엔진Database Engine, you can use either localhost or (local) instead of the name of the computer. localhost 또는 (로컬)을 사용하는 스크립트는 다른 컴퓨터 이름을 반영하도록 변경하지 않고도 모든 컴퓨터에서 실행할 수 있습니다.Scripts that use localhost or (local) can be run on any computer without having to be changed to reflect the different computer names.

데이터베이스 엔진Database Engine 실행 프로그램의 여러 인스턴스를 동일한 컴퓨터에서 실행할 수 있습니다.You can run multiple instances of the 데이터베이스 엔진Database Engine executable program on the same computer. SQL Server 공급자 경로에서 컴퓨터 이름 다음에 오는 노드는 인스턴스를 식별합니다. 예를 들면 다음과 같습니다.The node following the computer name in a SQL Server provider path identifies the instance; for example:

SQLSERVER:\SQL\MyComputer\MyInstance  

각 컴퓨터는 기본 데이터베이스 엔진Database Engine인스턴스를 한 개 가질 수 있습니다.Each computer can have one default instance of the 데이터베이스 엔진Database Engine. 기본 인스턴스는 설치할 때 이름을 지정하지 마세요.You do not specify a name for the default instance when you install it. 연결 문자열에 컴퓨터 이름만 지정하면 해당 컴퓨터의 기본 인스턴스로 연결됩니다.If you specify only a computer name in a connection string, you are connected to the default instance on that computer. 컴퓨터의 다른 모든 인스턴스는 명명된 인스턴스여야 합니다.All other instances on the computer must be named instances. 인스턴스 이름은 설치 시 지정하고, 연결 문자열에는 컴퓨터 이름과 인스턴스 이름을 모두 지정해야 합니다.You specify the instance name during setup, and connection strings must specify both the computer name and the instance name.

제한 사항 Limitations and Restrictions

PowerShell 스크립트에서 마침표(.)를 사용하여 로컬 컴퓨터를 지정할 수 없습니다.You cannot use a period (.) to specify the local computer in PowerShell scripts. 마침표는 PowerShell에서 명령으로 해석되기 때문에 지원되지 않습니다.The period is not supported because the period is interpreted as a command by PowerShell.

(local)의 괄호 문자는 일반적으로 Windows PowerShell에서 명령으로 처리됩니다.The parenthesis characters in (local) are normally treated as commands by Windows PowerShell. 따라서 경로에 사용할 수 있도록 괄호 문자를 인코딩 또는 이스케이프하거나, 경로를 큰따옴표로 묶어야 합니다.You must either encode them or escape them for use in a path, or enclose the path in double-quotation marks. 자세한 내용은 SQL Server 식별자 인코딩 및 디코딩을 참조하세요.For more information, see Encode and Decode SQL Server Identifiers.

SQL ServerSQL Server 공급자는 항상 인스턴스 이름을 지정하도록 요청합니다.The SQL ServerSQL Server provider requires that you always specify an instance name. 기본 인스턴스의 인스턴스 이름은 DEFAULT로 지정해야 합니다.For default instances, you must specify an instance name of DEFAULT.

예: 컴퓨터 및 인스턴스 이름 Examples; Computer and Instance Names

이 예에서는 localhost 및 DEFAULT를 사용하여 로컬 컴퓨터의 기본 인스턴스를 지정합니다.This example uses localhost and DEFAULT to specify the default instance on the local computer:

Set-Location SQLSERVER:\SQL\localhost\DEFAULT   

(local)의 괄호 문자는 일반적으로 Windows PowerShell에서 명령으로 처리됩니다.The parenthesis characters in (local) are normally treated as commands by Windows PowerShell. 다음 중 하나를 수행해야 합니다.You must either:

  • 경로 문자열을 따옴표로 묶습니다.Enclose the path string in quotes:

    Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"  
    
  • 역따옴표 문자(`)를 사용하여 괄호를 이스케이프 처리합니다.Escape the parenthesis using the back tick character (`):

    Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT  
    
  • 16진수 표현을 사용하여 괄호를 인코딩합니다.Encode the parenthesis using their hexadecimal representation:

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

참고 항목See Also

PowerShell의 SQL Server 식별자 SQL Server Identifiers in PowerShell
SQL Server PowerShell 공급자 SQL Server PowerShell Provider
SQL Server PowerShell SQL Server PowerShell