Convert-Path
Converte um caminho do Windows PowerShell para o caminho de um provedor do Windows PowerShell.
Sintaxe
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>]
Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Convert-Path converte um caminho do Windows PowerShell no caminho de um provedor do Windows PowerShell.
Parâmetros
-LiteralPath <string[]>
Especifica o caminho a ser convertido. O valor do parâmetro 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 que será convertido.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
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 um caminho (mas não um caminho literal) para Convert-Path. |
Saídas |
System.String Convert-Path retorna uma cadeia de caracteres que contém o caminho convertido. |
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 de caminho com vários provedores, incluindo FileSystem, Registry e Certificate.
O cmdlet Convert-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>convert-path ~
Descrição
-----------
Esse comando expande o diretório de trabalho atual.
Exemplo 2
C:\PS>convert-path HKLM:\software\microsoft
Descrição
-----------
Esse comando converte um caminho do Windows PowerShell em um caminho de Registro padrão.