다음을 통해 공유

Convert-UrnToPath

모듈:
SqlServer Module

SQL Server 관리 개체 URN을 Windows PowerShell 공급자 경로로 변환합니다.

구문

Default (기본값) 

Convert-UrnToPath
    [-Urn] <String>
    [<CommonParameters>]

Description

Convert-UrnToPath cmdlet은 SQL Server 관리 개체 URN(Uniform Resource Name)을 SQL Server 공급자 경로로 변환합니다.

SQL Server 관리 개체에는 SQL Server 개체 계층 구조의 위치를 나타내는 문자열을 반환하는 Urn 속성이 있습니다.

Urn의 노드가 Windows PowerShell 경로 노드에서 지원되지 않는 확장 문자가 있는 SQL Server 구분 식별자인 경우 확장 문자는 16진수 표현으로 인코딩됩니다.

예를 들어 테이블 이름 "Main:Table"은 "Main%3ATable"로 인코딩됩니다.

예제

예제 1: 현재 경로가 포함된 문자열 가져오기

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014"
PS SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014> Convert-UrnToPath -Urn (Get-Item .).Urn.ToString()

SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014

이 명령은 현재 경로를 포함하는 문자열을 반환합니다. 이 예제에서는 Urn 속성의 ToString() 함수를 사용하여 Urn을 문자열로 반환합니다.

예제 2: URN에 따라 경로 위치 설정

PS C:\> Set-Location (Convert-UrnToPath -Urn "Server[@Name='MyComputer']/Database[@Name='AdventureWorks']/Table[@Name='Address' and @Schema = 'Person']")

이 명령은 SQL Server 관리 개체 URN에 지정된 위치에 대한 경로를 설정합니다.

예제 3: 데이터베이스 경로 가져오기

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\DEFAULT\Databases"
PS SQLSERVER:\SQL\MyComputer\DEFAULT\Databases> foreach ($Item in Get-ChildItem) { $Item.Urn.ToString() | Convert-UrnToPath }

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2014

이 명령은 기본 인스턴스에서 데이터베이스에 대한 경로를 포함하는 문자열 배열을 반환합니다. 파이프라인 연산자는 현재 노드 URN을 Convert-UrnToPath에 전달하는 데 사용됩니다.

매개 변수

-Urn

SQL Server 계층 구조에서 개체의 위치를 식별하는 SQL Server URN을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

SQL Server 관리 개체 URN을 나타내는 문자열을 지정합니다.

출력

String

SQL Server PowerShell 공급자 경로를 나타내는 문자열을 지정합니다.