Resolve-Path
Resolve os caracteres curinga em um caminho e exibe o conteúdo do caminho.
Syntax
Resolve-Path
[-Path] <String[]>
[-Relative]
[-Credential <PSCredential>]
[<CommonParameters>]
Resolve-Path
-LiteralPath <String[]>
[-Relative]
[-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 a partir de um provedor PSDrive .
Exemplos
Exemplo 1: Resolver o caminho da pasta base
O caractere til (~
) é a notação abreviada para a pasta base do usuário atual. Este exemplo mostra Resolve-Path
o retorno do valor de 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
Esse comando retorna todos os arquivos e pastas na C:\Windows
pasta. O comando usa um operador de pipeline (|
) para enviar uma cadeia de caracteres 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 Test[xml]
caminho da subpasta.
O uso de 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 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 é suportado por nenhum provedor instalado com o PowerShell.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 ('
). Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Especifica o caminho do PowerShell a ser resolvido. Este parâmetro é obrigatório. Você também pode canalizar uma cadeia de caracteres de caminho para Resolve-Path
. Caracteres curinga são permitidos.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Relative
Indica que esse cmdlet retorna um caminho relativo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode canalizar uma cadeia de caracteres que contém um caminho para esse cmdlet.
Saídas
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.
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
só resolve caminhos existentes. Ele não pode ser usado para resolver um local que ainda não existe.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de