Convert-UrnToPath

참조

모듈:: SQLServer

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

구문

Convert-UrnToPath
       [-Urn] <String>
       [-ProgressAction <ActionPreference>]
       [<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에 전달하는 데 사용됩니다.

매개 변수

-ProgressAction

powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.

형식:	ActionPreference
별칭:	proga
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Urn

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

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

입력

String

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

출력