Compartir a través de

Convert-Path

Módulo:
Microsoft.PowerShell.Management Module

Convierte una ruta de acceso de una ruta de acceso de Windows PowerShell a una ruta de acceso del proveedor de Windows 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 una ruta de acceso de Windows PowerShell a una ruta de acceso del proveedor de Windows PowerShell.

Ejemplos

Ejemplo 1: Convertir el directorio de trabajo en una ruta de acceso estándar del sistema de archivos

PS C:\> Convert-Path .

Este comando convierte el directorio de trabajo actual, representado por un punto (.), en una ruta de acceso del sistema de archivos estándar.

Ejemplo 2: Conversión de una ruta de acceso de proveedor a una ruta de acceso del Registro estándar

PS C:\> Convert-Path HKLM:\Software\Microsoft

Este comando convierte la ruta de acceso del proveedor de Windows PowerShell a una ruta de acceso del Registro estándar.

Ejemplo 3: Convertir una ruta de acceso a una cadena

PS C:\> Convert-Path ~
C:\Users\User01

Este comando convierte la ruta de acceso al directorio principal del proveedor actual, que es el proveedor FileSystem, en una cadena.

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 Windows PowerShell que no interprete ningún carácter como secuencias de escape.

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 Windows PowerShell que se va a convertir.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
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, consulte 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

  • 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 Windows PowerShell pueden interpretar. Están diseñados para su uso en programas y scripts en los que desea mostrar todo o parte de un nombre de 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.