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[]>
       [<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

Ejemplo 4: Convertir rutas de acceso para elementos ocultos

De forma predeterminada, Convert-Path no devuelve elementos ocultos. En este ejemplo se usa el parámetro Force para buscar elementos ocultos. El Get-Item comando confirma que la .git carpeta está oculta. El uso Convert-Path sin el parámetro Force devuelve solo los elementos visibles. Al agregar el parámetro Force , se devuelven todos los elementos, incluidos los elementos ocultos.

PS> Get-Item .git -Force

    Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d--h-           9/25/2024  4:46 PM                .git

PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

Parámetros

-Force

Permite al cmdlet obtener elementos a los que el usuario no puede acceder de otro modo, como archivos ocultos o del sistema. El parámetro Force no invalida las restricciones de seguridad. La implementación varía en función del proveedor. Para obtener más información, consulte about_Providers.

Este parámetro se agregó en PowerShell 7.5-preview.5.

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

-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, LP
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

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.