Convert-Path
Convierte una ruta de acceso de una ruta de acceso de PowerShell a una ruta de acceso del proveedor de PowerShell.
Sintaxis
Path (valor predeterminado)
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<CommonParameters>]
Description
El cmdlet Convert-Path convierte una ruta de acceso de PowerShell en una ruta de acceso de proveedor de PowerShell.
Ejemplos
Ejemplo 1: Convertir el directorio de trabajo en una ruta de acceso estándar del sistema de archivos
En este ejemplo se convierte el directorio de trabajo actual, que se representa mediante un punto (.), en una ruta de acceso de FileSystem estándar.
PS C:\> Convert-Path .
C:\
Ejemplo 2: Conversión de una ruta de acceso de proveedor a una ruta de acceso del Registro estándar
En este ejemplo se convierte la ruta de acceso del proveedor de PowerShell a una ruta de acceso del Registro estándar.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Ejemplo 3: Convertir una ruta de acceso a una cadena
En este ejemplo se convierte la ruta de acceso al directorio principal del proveedor actual, que es el proveedor FileSystem, en una cadena.
PS C:\> Convert-Path ~
C:\Users\User01
Parámetros
-LiteralPath
Especifica, como una matriz de cadenas, la ruta que se va a convertir. El valor del parámetro LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Para obtener más información, consulte sobre_las_normas_de_citación.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSPath |
Conjuntos de parámetros
LiteralPath
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Path
Especifica la ruta de acceso de PowerShell que se va a convertir.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
Path
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea about_Transactions.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | usetx |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| 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
Se puede canalizar una ruta de acceso (pero no una ruta de acceso literal) a este cmdlet.
Salidas
String
Este cmdlet devuelve una cadena que contiene la ruta de acceso convertida.
Notas
Windows PowerShell incluye los siguientes alias para Convert-Path:
cvpa
Los cmdlets que contienen el nombre 'Path' manipulan las rutas y devuelven los nombres en un formato conciso que todos los proveedores de PowerShell pueden interpretar. Están diseñados para su uso en programas y scripts en los que desea mostrar toda o parte de una ruta de acceso en un formato determinado. Úselos como usaría Dirname, Normpath, Realpath, Join u otros manipuladores de ruta de acceso.
Los cmdlets de ruta se pueden usar con varios proveedores, incluidos los proveedores de FileSystem, Registry y Certificate.
Este cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.
Convert-Path solo convierte las rutas de acceso existentes. No se puede usar para convertir una ubicación que aún no existe.
