Compartilhar via

Resolve-Path

  • Referência
Módulo:
Microsoft.PowerShell.Management

Resolve os caracteres curinga em um caminho e exibe o conteúdo do caminho.

Sintaxe

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

Description

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

Exemplos

Exemplo 1: Resolver o caminho da pasta inicial

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

Resolve-Path ~

Path
----
C:\Users\User01

Exemplo 2: Resolver o caminho da pasta Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

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

Exemplo 3: Obter todos os caminhos na pasta Windows

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

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

Exemplo 4: Resolver um caminho UNC

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

Esse comando resolve um caminho de convenção de nomenclatura Universal (UNC) e retorna os compartilhamentos no caminho.

Exemplo 5: Obter caminhos relativos

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

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

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

Exemplo 6: Resolver um caminho que contém colchetes

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

Resolve-Path -LiteralPath 'test[xml]'

Exemplo 7: Resolver um caminho relativo a outra pasta

Este exemplo usa o parâmetro RelativeBasePath para resolver o caminho do pwsh executável em relação ao $env:TEMP. Quando o comando inclui o parâmetro de opção Relative , ele retorna uma String que representa o caminho relativo de $env:TEMP para o pwsh executável.

$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 uma conta de usuário que tem permissão para executar esta ação. O padrão é o usuário atual.

Digite um nome de usuário, como User01 ou Domain01\User01, ou passe um objeto PSCredential . Você pode criar um objeto PSCredential usando o Get-Credential cmdlet. Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.

Esse parâmetro não tem suporte de nenhum provedor instalado com o PowerShell.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LiteralPath

Especifica os caminhos que serão resolvidos. O valor do parâmetro LiteralPath é usado exatamente como digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples ('). As aspas simples informam ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:String[]
Aliases:PSPath, LP
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho do PowerShell a ser resolvido. Este parâmetro é obrigatório. Você também pode canalizar uma string de caminho para Resolve-Path. Caracteres curinga são permitidos.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Relative

Indica que esse cmdlet retorna um caminho relativo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RelativeBasePath

Especifica um caminho para resolver o caminho relativo. Quando você usa esse parâmetro, o cmdlet retorna o objeto System.Management.Automation.PathInfo para o caminho resolvido.

Quando você usa esse parâmetro com o parâmetro Relative switch, o cmdlet retorna uma cadeia de caracteres que representa o caminho relativo de RelativeBasePath para Path.

Esse parâmetro foi adicionado no PowerShell 7.4.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para esse cmdlet.

Saídas

PathInfo

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

String

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

Observações

O PowerShell inclui os seguintes aliases para Resolve-Path:

  • Todas as plataformas:
    • rvpa

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

Resolve-Path foi projetado para funcionar 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 resolve apenas os caminhos existentes. Ele não pode ser usado para resolver um local que ainda não existe.