Convierte una ruta de Windows PowerShell a una ruta de proveedor de Windows PowerShell.
Sintaxis
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>] Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Convert-Path convierte una ruta de acceso de Windows PowerShell en una ruta de acceso de un proveedor de Windows PowerShell.
Parámetros
-LiteralPath <string[]>
Especifica la ruta que se va a convertir. El valor del parámetro LiteralPath se usa exactamente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica la ruta de Windows PowerShell que se va a convertir.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String Puede canalizar a Convert-Path una ruta de acceso (que no sea una ruta de acceso literal). |
|
Salidas |
System.String Convert-Path devuelve una cadena que contiene la ruta de acceso convertida. |
Notas
Los cmdlets que contienen el sustantivo Path (cmdlets Path) manipulan los nombres de las rutas de acceso y los devuelven con un formato conciso que todos los proveedores de Windows PowerShell saben interpretar. Se han diseñado para su uso en programas y scripts en los que se desea mostrar una ruta completa o parcial con un formato específico. Puede usarlos de la misma manera que usaría Dirname, Normpath, Realpath, Join u otros manipuladores de rutas.
Puede usar los cmdlets de rutas con varios proveedores, como FileSystem, Registry y Certificate.
El cmdlet Convert-Path está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>convert-path ~ Descripción ----------- Este comando expande el directorio de trabajo actual.
Ejemplo 2
C:\PS>convert-path HKLM:\software\microsoft Descripción ----------- Este comando convierte la ruta del proveedor de Windows PowerShell en una ruta estándar del Registro.
Vea también