Convert-UrnToPath
將 SQL Server 管理物件 URN 轉換成 Windows PowerShell 提供者路徑。
語法
Convert-UrnToPath
-Urn <String>
[<CommonParameters>]
Description
Convert-UrnToPath Cmdlet 會將 SQL Server 管理物件統一資源名稱 (URN) 轉換為 SQL Server 提供者路徑。 SQL Server 管理物件具有 Urn 屬性,這個屬性會傳回字串,指出這些物件在 SQL Server 物件階層中的位置。 如果 Urn 中的節點 SQL Server 分隔標識符,且路徑節點不支援擴充 Windows PowerShell 字元,則擴充字元會使用其十六進位表示法編碼。 例如,數據表名稱 「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 |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
輸入
String
指定字串,表示管理物件 URN SQL Server。
輸出
String
指定字串,表示 SQL Server PowerShell 提供者路徑。