Resolve-Path

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

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

O cmdlet Resolve-Path exibe os itens e contêineres que correspondem ao padrão curinga no local especificado. A correspondência pode incluir ficheiros, pastas, chaves de registo ou qualquer outro objeto acessível a partir de um fornecedor de PSDrive.

O caractere til (~) é uma notação abreviada para a pasta base do usuário atual. Este exemplo mostra Resolve-Path retornando o valor de caminho totalmente qualificado.

Resolve-Path ~

Path
----
C:\Users\User01

Resolve-Path -Path "windows"

Path
----
C:\Windows

Quando executado a partir da raiz da unidade de C:, este comando retorna o caminho da pasta Windows na unidade C:.

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

Este comando retorna todos os arquivos e pastas na pasta C:\Windows. O comando usa um operador de pipeline (|) para enviar uma cadeia de caracteres de caminho para Resolve-Path.

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

Este comando resolve um caminho UNC (Convenção Universal de Nomenclatura) e retorna os compartilhamentos no caminho.

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

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

Este comando retorna caminhos relativos para os diretórios na raiz da unidade de C:.

Este exemplo usa o parâmetro LiteralPath para resolver o caminho da subpasta Test[xml]. Usar LiteralPath faz com que os colchetes sejam tratados como caracteres normais em vez de uma expressão regular.

Resolve-Path -LiteralPath 'test[xml]'

Este exemplo usa o parâmetro RelativeBasePath para resolver o caminho do executável pwsh relativo a $Env:TEMP. Quando o comando inclui o parâmetro Relative switch, ele retorna um String representando o caminho relativo de $Env:TEMP para o executável pwsh.

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

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

Por padrão, Resolve-Path não retorna itens ocultos. Este exemplo usa o parâmetro Force para resolver itens ocultos. O comando Get-Item confirma que a pasta .git está oculta. Usar Resolve-Path sem o parâmetro Force retorna apenas os itens visíveis. Adicionar o parâmetro Force retorna todos os itens, incluindo itens 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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este cmdlet.

Por padrão, esse cmdlet retorna um objeto PathInfo.

Se você especificar o parâmetro Relative, esse cmdlet retornará um valor de cadeia de caracteres para o caminho resolvido.

O PowerShell inclui os seguintes aliases para Resolve-Path:

• Todas as plataformas:
  • rvpa

Os cmdlets *-Path funcionam com os provedores FileSystem, Registrye Certificate.

Resolve-Path é projetado para trabalhar com qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.

Resolve-Path só resolve caminhos existentes. Ele não pode ser usado para resolver um local que ainda não existe.