Convert-UrnToPath

Referencia

Módulo:: SQLServer

Convierte un URN de objeto de administración de SQL Server en una ruta de acceso del proveedor de Windows PowerShell.

Syntax

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

Description

El cmdlet Convert-UrnToPath convierte un nombre uniforme de recursos (URN) de objeto de administración de SQL Server en una ruta de acceso del proveedor de SQL Server.

Los Objetos de administración de SQL Server tienen una propiedad Urn que devuelve una cadena que indica su ubicación en la jerarquía de objetos de SQL Server.

Si los nodos de urn son SQL Server identificadores delimitados con caracteres extendidos que no se admiten en Windows PowerShell nodos de ruta de acceso, los caracteres extendidos se codifican con su representación hexadecimal.

Por ejemplo, un nombre de tabla "Main:Table" se codifica como "Main%3ATable".

Ejemplos

Ejemplo 1: Obtener una cadena que contiene la ruta de acceso actual

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

Este comando devuelve una cadena que contiene la ruta de acceso actual. En el ejemplo se usa la función ToString() de la propiedad Urn para devolver el Urn como una cadena.

Ejemplo 2: Establecimiento de la ubicación de la ruta de acceso basada en un URN

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

Este comando establece la ruta de acceso a la ubicación especificada en un URN de objeto de administración de SQL Server.

Ejemplo 3: Obtener rutas de acceso de base de datos

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

Este comando devuelve una matriz de cadenas que contienen la ruta de acceso a una base de datos en la instancia predeterminada. El operador de canalización se usa para pasar el URN del nodo actual a Convert-UrnToPath.

Parámetros

-Urn

Especifica un SQL Server URN que identifica la ubicación de un objeto en la jerarquía de SQL Server.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

Especifica una cadena que representa un URN de objeto de administración de SQL Server.

Salidas