Compartir vía

Resolve-Path

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxis

Path (Es el valor predeterminado). 

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

LiteralPath 

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

Description

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 del Registro o cualquier otro objeto accesible desde un proveedor de psDrive de.

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 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 unidad de C:, este comando devuelve la ruta de acceso de la carpeta Windows de la unidad C:.

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 carpeta C:\Windows. 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 de 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 unidad de C:.

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 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: Resolución de una ruta de acceso relativa a otra carpeta

En este ejemplo se usa el parámetro relativeBasePath de para resolver la ruta de acceso del archivo ejecutable de pwsh con respecto a $Env:TEMP. Cuando el comando incluye el parámetro de modificador relative , devuelve un string que representa la ruta de acceso relativa de $Env:TEMP al ejecutable de pwsh.

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

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

Ejemplo 8: Resolución de rutas de acceso para elementos ocultos

De forma predeterminada, Resolve-Path no devuelve elementos ocultos. En este ejemplo se usa el parámetro Force para resolver elementos ocultos. El comando Get-Item confirma que la carpeta .git está oculta. El uso de Resolve-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> Resolve-Path .git*

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Resolve-Path .git* -Force

Path
----
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

-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 User01 o Domain01\User01, o pase un objeto de PSCredential. Puede crear un objeto de PSCredential mediante el cmdlet Get-Credential. 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.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-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 entre los proveedores. Para obtener más información, consulte about_Providers.

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath, LP

Conjuntos de parámetros

LiteralPath
Posición:Named
Mandatory: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 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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

Path
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Relative

Indica que este cmdlet devuelve una ruta de acceso relativa.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Path
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
LiteralPath
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 de modificador relative , el cmdlet devuelve una cadena que representa la ruta de acceso relativa de RelativeBasePath a Ruta de acceso.

Este parámetro se agregó en PowerShell 7.4.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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

Puede enviar 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 cmdlets de *-Path funcionan con los proveedores de FileSystem, Registryy 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.