Convert-UrnToPath

構文

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

説明

Convert-UrnToPath コマンドレットは、SQL Server 管理オブジェクトの UNIFORM Resource Name (URN) を 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

-Urn

入力

String

SQL Server 管理オブジェクト URN を表す文字列を指定します。

出力

String

SQL Server PowerShell プロバイダー パスを表す文字列を指定します。