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]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]

Description

O cmdlet Resolve-Path 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 de bloco (~) é uma notação abreviada para a pasta inicial do usuário atual. Este exemplo mostra Resolve-Path retornando o valor do caminho totalmente qualificado.

PS C:\> Resolve-Path ~

Path
----
C:\Users\User01

Exemplo 2: Resolver o caminho da pasta do Windows

PS C:\> Resolve-Path -Path "windows"

Path
----
C:\Windows

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

Exemplo 3: Obter todos os caminhos na pasta do Windows

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

Esse comando retorna todas as pastas na pasta C:\Windows. O comando usa um operador de pipeline (|) para enviar uma cadeia de caracteres de caminho para Resolve-Path.

Exemplo 4: Resolver um caminho UNC

PS C:\> Resolve-Path -Path "\\Server01\public"

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

Exemplo 5: Obter caminhos relativos

PS C:\> 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 unidade C:.

Exemplo 6: Resolver um caminho que contém colchetes

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.

PS C:\> Resolve-Path -LiteralPath 'test[xml]'

Parâmetros

-Credential

Especifica uma conta de usuário que tem permissão para executar essa 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 cmdlet Get-Credential. Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.

Esse parâmetro não tem suporte para 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 o caminho a ser resolvido. 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 dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:String[]
Aliases:PSPath
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. Esse parâmetro é necessário. Você também pode canalizar uma cadeia de caracteres de caminho para Resolve-Path.

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

-Relative

Indica que esse cmdlet retorna um caminho relativo.

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

-UseTransaction

Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_transactions.

Tipo:SwitchParameter
Aliases:usetx
Cargo:Named
Valor padrão:False
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 este cmdlet.

Saídas

System.Management.Automation.PathInfo, System.String

Retorna um objeto PathInfo. Retorna um valor de cadeia de caracteres para o caminho resolvido se você especificar o parâmetro Relative.

Observações

  • Os cmdlets *-Path funcionam com os provedores FileSystem, Registry e Certificate.
  • Resolve-Path foi projetado para funcionar com qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_providers.