Convert-UrnToPath
Convierte un URN de objeto de administración de SQL Server en una ruta de acceso del proveedor de Windows PowerShell.
Sintaxis
Default (Es el valor predeterminado).
Convert-UrnToPath
[-Urn] <String>
[<CommonParameters>]
Description
El cmdlet Convert-UrnToPath convierte un nombre uniforme de recursos (URN) del 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 identificadores delimitados por SQL Server con caracteres extendidos que no se admiten en los nodos de ruta de acceso de Windows PowerShell, 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: Obtención de 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 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 URN de SQL Server que identifica la ubicación de un objeto en la jerarquía de SQL Server.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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 SQL Server PowerShell.