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.

Syntax

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<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.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

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

PowerShell incluye los siguientes alias para Convert-Path:

  • Todas las plataformas:
    • 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.