Convert-UrnToPath

模块:: SqlServer Module

将 SQL Server 管理对象 URN 转换为 Windows PowerShell 提供程序路径。

语法

Default （默认值）

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

说明

Convert-UrnToPath cmdlet 将 SQL Server 管理对象统一资源名称（URN）转换为 SQL Server 提供程序路径。

SQL Server 管理对象具有 Urn 属性，该属性返回一个字符串，指示其在 SQL Server 对象层次结构中的位置。

如果 Urn 中的节点是具有 Windows PowerShell 路径节点中不支持的扩展字符的 SQL Server 分隔标识符，则扩展字符使用十六进制表示形式进行编码。

例如，表名称“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 作为字符串返回 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 URN，用于标识 SQL Server 层次结构中对象的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。