Resolve-Path

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Resuelve los caracteres comodín en una ruta de acceso y muestra el contenido de la ruta de acceso.

Sintaxis

Resolve-Path
       [-Path] <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]

Description

El Resolve-Path cmdlet muestra los elementos y contenedores que coinciden con el patrón comodín en la ubicación especificada. La coincidencia puede incluir archivos, carpetas, claves del Registro o cualquier otro objeto accesible desde un proveedor de PSDrive .

Ejemplos

Ejemplo 1: Resolución de la ruta de acceso de la carpeta principal

El carácter de tilde (~) es una notación abreviada para la carpeta principal del usuario actual. En este ejemplo se muestra Resolve-Path cómo devolver el valor de ruta de acceso completo.

Resolve-Path ~

Path
----
C:\Users\User01

Ejemplo 2: Resolución de la ruta de acceso de la carpeta Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

Cuando se ejecuta desde la raíz de la C: unidad, este comando devuelve la ruta de acceso de la Windows carpeta en la C: unidad.

Ejemplo 3: Obtener todas las rutas de acceso de la carpeta Windows

"C:\windows\*" | Resolve-Path

Este comando devuelve todos los archivos y carpetas de la C:\Windows carpeta . El comando usa un operador de canalización (|) para enviar una cadena de ruta de acceso a Resolve-Path.

Ejemplo 4: Resolución de una ruta de acceso UNC

Resolve-Path -Path "\\Server01\public"

Este comando resuelve una ruta de acceso de convención de nomenclatura universal (UNC) y devuelve los recursos compartidos en la ruta de acceso.

Ejemplo 5: Obtener rutas de acceso relativas

Resolve-Path -Path "c:\prog*" -Relative

.\Program Files
.\Program Files (x86)
.\programs.txt

Este comando devuelve rutas de acceso relativas para los directorios en la raíz de la C: unidad.

Ejemplo 6: Resolución de una ruta de acceso que contiene corchetes

En este ejemplo se usa el parámetro LiteralPath para resolver la ruta de acceso de la Test[xml] subcarpeta. El uso de LiteralPath hace que los corchetes se traten como caracteres normales en lugar de una expresión regular.

Resolve-Path -LiteralPath 'test[xml]'

Ejemplo 7: Resolución de una ruta de acceso relativa a otra carpeta

En este ejemplo se usa el parámetro RelativeBasePath para resolver la ruta de acceso del pwsh archivo ejecutable en relación con $env:TEMP. Cuando el comando incluye el parámetro relative switch, devuelve una cadena que representa la ruta de acceso relativa del $env:TEMP pwsh archivo ejecutable.

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $env:TEMP -Relative

..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe

Parámetros

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o pase un objeto PSCredential . Puede crear un objeto PSCredential mediante el Get-Credential cmdlet . Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.

Este parámetro no es compatible con ningún proveedor instalado con PowerShell.

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

-LiteralPath

Especifica la ruta de acceso que se va a resolver. El valor del parámetro LiteralPath se usa exactamente como se escribe. Ningún carácter se interpreta como carácter 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.

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 resolver. Este parámetro es obligatorio. También puede canalizar una cadena de ruta de acceso a Resolve-Path. Se permite el uso de caracteres comodín.

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

-Relative

Indica que este cmdlet devuelve una ruta de acceso relativa.

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

-RelativeBasePath

Especifica una ruta de acceso desde la que resolver la ruta de acceso relativa. Cuando se usa este parámetro, el cmdlet devuelve el objeto System.Management.Automation.PathInfo para la ruta de acceso resuelta.

Cuando se usa este parámetro con el parámetro relative switch, el cmdlet devuelve una cadena que representa la ruta de acceso relativa de RelativeBasePath a Path.

Este parámetro se agregó en PowerShell 7.4.

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

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.

Salidas

PathInfo

De forma predeterminada, este cmdlet devuelve un objeto PathInfo .

String

Si especifica el parámetro Relative , este cmdlet devuelve un valor de cadena para la ruta de acceso resuelta.

Notas

PowerShell incluye los siguientes alias para Resolve-Path:

  • Todas las plataformas:
    • rvpa

Los *-Path cmdlets funcionan con los proveedores FileSystem, Registry y Certificate .

Resolve-Path está diseñado para trabajar con cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_providers.

Resolve-Path solo resuelve las rutas de acceso existentes. No se puede usar para resolver una ubicación que aún no existe.