Partilhar via

Resolve-Path

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxe

Path (Predefinição) 

Resolve-Path
    [-Path] <String[]>
    [-Relative]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

LiteralPath 

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 ficheiros, pastas, chaves de registo ou qualquer outro objeto acessível a partir de um fornecedor de PSDrive.

Exemplos

Exemplo 1: Resolver o caminho da pasta base

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

Exemplo 2: Resolver o caminho da pasta Windows

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:.

Exemplo 3: Obter todos os caminhos na pasta Windows

"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.

Exemplo 4: Resolver um caminho UNC

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

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

Exemplo 5: Obter caminhos relativos

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:.

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.

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 . 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.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-LiteralPath

Especifica o caminho a ser resolvido. O valor do parâmetro LiteralPath é usado exatamente como digitado. Nenhum caractere é interpretado como um caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples ('). Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:PSPath

Conjuntos de parâmetros

LiteralPath
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

Path
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Relative

Indica que esse cmdlet retorna um caminho relativo.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UseTransaction

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Usetx

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

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.

Entradas

String

Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este 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.

Notas

O Windows PowerShell inclui os seguintes aliases para Resolve-Path:

  • 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.