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

PS C:\> Resolve-Path ~

Path
----
C:\Users\User01

Exemplo 2: Resolver o caminho da pasta Windows

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

Path
----
C:\Windows

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

Exemplo 3: Obter todos os caminhos na pasta Windows

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

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

Este 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

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

Propriedades dos parâmetros

Tipo:

String[]

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

Conjuntos de parâmetros

Path
Position:1
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

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.

Notas

  • Os cmdlets *-Path funcionam com os provedores FileSystem, Registry e 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.