Resolve-Path
Resolve os caracteres curinga em um caminho e exibe o conteúdo do caminho.
Sintaxe
Resolve-Path [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Resolve-Path [-Path] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Resolve-Path interpreta os caracteres curinga em um caminho e exibe os itens e contêineres no local especificado pelo caminho, como os arquivos e pastas ou chaves e subchaves do Registro.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com 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 insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-LiteralPath <string[]>
Especifica o caminho a ser resolvido. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica o caminho do Windows PowerShell a ser resolvido. Esse parâmetro é obrigatório. Também é possível enviar uma cadeia de caracteres de caminho para Resolve-Path.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Relative
Retorna um caminho relativo.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
System.String Você pode enviar uma cadeia de caracteres que contém um caminho para Resolve-Path. |
Saídas |
System.String Resolve-Path retorna uma cadeia de caracteres que contém o caminho resolvido. |
Observações
Os cmdlets que contêm o nome Path (os cmdlets Path) manipulam os nomes de caminho e os retornam em um formato conciso que pode ser interpretado por todos os provedores do Windows PowerShell. Eles foram criados para o uso em programas e scripts em que você deseja exibir todo ou parte de um caminho em um determinado formato. Utilize-os como o faria com Dirname, Normpath, Realpath, Join ou outros manipuladores de caminho.
Você pode usar os cmdlets Path com vários provedores, incluindo FileSystem, Registry e Certificate.
O cmdlet Resolve-Path foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PSProvider". Para obter mais informações, consulte about_Providers.
Exemplo 1
C:\PS>resolve-path ~
C:\Users\User01
Descrição
-----------
Esse comando resolve o caminho representado pelo caractere til (~), que significa o caminho de início.
Exemplo 2
C:\PS>resolve-path windows
C:\Windows
Descrição
-----------
Quando executado a partir da raiz da unidade C:, esse comando retorna o caminho para o diretório do Windows na unidade C:.
Exemplo 3
C:\PS>"C:\windows\*" | resolve-path
Descrição
-----------
Esse comando retorna todos os diretórios no diretório C:\Windows. O comando usa um operador de pipeline (|) para enviar uma cadeia de caracteres de caminho para Resolve-Path.
Exemplo 4
C:\PS>resolve-path \\Server01\public
Descrição
-----------
Esse comando resolve um caminho UNC (Convenção de Nomenclatura Universal) e retorna os compartilhamentos no caminho.
Exemplo 5
C:\PS>resolve-path c:\prog* -relative
..\Program Files
..\Program Files (x86)
..\programs.txt
Descrição
-----------
Esse comando retorna caminhos relativos para os diretórios na raiz da unidade C:.
Exemplo 6
C:\PS>resolve-path -literalPath test[xml]
Descrição
-----------
Esse comando resolve o caminho para o subdiretório Test[xml] do diretório atual. Ele usa o parâmetro LiteralPath para indicar que os colchetes não são caracteres de expressão regular.