Convert-Path
Converte um caminho de um caminho do PowerShell para um caminho do provedor do PowerShell.
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<CommonParameters>]
O Convert-Path
cmdlet converte um caminho de um caminho do PowerShell em um caminho do provedor do PowerShell.
Este exemplo converte o diretório de trabalho atual, que é representado por um ponto (.
), em um caminho FileSystem padrão.
PS C:\> Convert-Path .
C:\
Este exemplo converte o caminho do provedor do PowerShell em um caminho do Registro padrão.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Este exemplo converte o caminho para o diretório base do provedor atual, que é o provedor FileSystem, em uma cadeia de caracteres.
PS C:\> Convert-Path ~
C:\Users\User01
Especifica, como uma matriz de cadeia de caracteres, o caminho a ser convertido. O valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como 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.
Para obter mais informações, consulte about_Quoting_Rules.
Tipo: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica o caminho do PowerShell a ser convertido.
Tipo: | String[] |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | True |
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.
Tipo: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Você pode canalizar um caminho, mas não um caminho literal, para esse cmdlet.
Este cmdlet retorna uma cadeia de caracteres que contém o caminho convertido.
O Windows PowerShell inclui os seguintes aliases para Convert-Path
:
cvpa
Os cmdlets que contêm o substantivo Path manipulam nomes de caminho e retornam os nomes em um formato conciso que todos os provedores do PowerShell podem interpretar. Eles são projetados para uso em programas e scripts onde você deseja exibir todo ou parte de um caminho em um formato específico. Use-os como você usaria Dirname, Normpath, Realpath, Join ou outros manipuladores de caminho.
Você pode usar os cmdlets de caminho com vários provedores, incluindo os provedores FileSystem, Registry e Certificate .
Este cmdlet foi projetado para trabalhar 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.
Convert-Path
apenas converte caminhos existentes. Ele não pode ser usado para converter um local que ainda não existe.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: