Compartir a través de

Convert-Path

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Convierte una ruta de acceso de una ruta de acceso de PowerShell a una ruta de acceso del proveedor de PowerShell.

Sintaxis

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Description

El Convert-Path cmdlet convierte una ruta de acceso de una ruta de acceso de PowerShell a una ruta de acceso del 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, representado por 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 matriz de cadenas, la ruta de acceso 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 contiene caracteres de escape, escríbalos 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 about_Quoting_Rules.

Tipo:String[]
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso de PowerShell que se va a convertir.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, consulte about_transactions.

Tipo:SwitchParameter
Alias:usetx
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

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 los nombres de ruta de acceso 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.

Puede usar los cmdlets de ruta de acceso con varios proveedores, incluidos filesystem, registry y proveedores de certificados.

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.