Búsqueda de sitios web

Resolve-Path (Microsoft.PowerShell.Management)

Resolve-Path

Módulo:
Microsoft.PowerShell.Management

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

Sintaxis

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

Descripción

El cmdlet Resolve-Path 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 de registro o cualquier otro objeto accesible desde un proveedor de PSDrive.

Ejemplos

Ejemplo 1: resolver la ruta de la carpeta de inicio

El carácter de tilde (~) es una notación abreviada para la carpeta de inicio del usuario actual. Este ejemplo muestra que Resolve-Path devuelve el valor de ruta completo.

Resolve-Path ~

Path
----
C:\Users\User01

Ejemplo 2: resolver la ruta de la carpeta de Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

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

Ejemplo 3: obtener todas las rutas en la carpeta de Windows

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

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

Ejemplo 4: resolver una ruta UNC

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

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

Ejemplo 5: obtener rutas relativas

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

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

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

Ejemplo 6: resolver una ruta que contiene corchetes

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

Resolve-Path -LiteralPath 'test[xml]'

Ejemplo 7: resolver una ruta relativa a otra carpeta

Este ejemplo utiliza el parámetro RelativeBasePath para resolver la ruta del ejecutable pwsh relativa a $env:TEMP. Cuando el comando incluye el parámetro de cambio Relative, devuelve una Cadena que representa la ruta relativa desde $env:TEMP hasta pwsh 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 que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como Usuario01 o Dominio01\Usuario01, o pase un objeto PSCredential. Puede crear un objeto PSCredential utilizando el cmdlet Get-Credential. Si escribe un nombre de usuario, este cmdlet le solicitará una contraseña.

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

Tipo :

PSCredencial

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-LiteralPath

Especifica la ruta a resolver. El valor del parámetro LiteralPath se utiliza exactamente como se escribió. Ningún carácter se interpreta como comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples ('). Las comillas simples le indican a PowerShell que no interprete ningún carácter como secuencia de escape.

Tipo :

String[]

Alias:

PSPath, LP

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Path

Especifica la ruta de PowerShell para resolver. Este parámetro es obligatorio. También puede canalizar una cadena de ruta a Resolve-Path. Se permiten 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 relativa.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-RelativeBasePath

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

Cuando se utiliza este parámetro con el parámetro de cambio Relative, el cmdlet devuelve una cadena que representa la ruta relativa desde RelativeBasePath a Path.

Este parámetro se agregó en PowerShell 7.4.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena

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

Salidas

Información de ruta

De forma predeterminada, este cmdlet devuelve un objeto PathInfo.

Cadena

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

Notas

PowerShell incluye los siguientes alias para Resolve-Path:

  • Todas las plataformas:

      rvpa

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

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

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

Artículos relacionados