Convert-UrnToPath
Convierte un URN de objeto de administración de SQL Server en una ruta de acceso del proveedor de Windows PowerShell.
Sintaxis
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 están 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: Obtención de 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 de 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.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
Entradas
String
Especifica una cadena que representa un URN de objeto de administración de SQL Server.
Salidas
String
Especifica una cadena que representa una ruta de acceso del proveedor de PowerShell SQL Server.