Convert-Path
Converte um caminho de um caminho do PowerShell em um caminho de provedor do PowerShell.
Syntax
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
Description
O Convert-Path
cmdlet converte um caminho de um caminho do PowerShell em um caminho de provedor do PowerShell.
Exemplos
Exemplo 1: converter o diretório de trabalho em um caminho padrão do sistema de arquivos
Este exemplo converte o diretório de trabalho atual, que é representado por um ponto (.
), em um caminho padrão do FileSystem.
PS C:\> Convert-Path .
C:\
Exemplo 2: converter um caminho de provedor em um caminho de registro padrão
Este exemplo converte o caminho do provedor do PowerShell em um caminho de registro padrão.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Exemplo 3: Converter um caminho em uma cadeia de caracteres
Este exemplo converte o caminho para o diretório inicial do provedor atual, que é o provedor FileSystem, em uma cadeia de caracteres.
PS C:\> Convert-Path ~
C:\Users\User01
Parâmetros
-LiteralPath
Especifica, como uma matriz de cadeia de caracteres, o caminho a ser convertido. O valor do parâmetro LiteralPath é usado exatamente como ele é 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 convertido.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
Você pode canalizar um caminho, mas não um caminho literal, para este cmdlet.
Saídas
Esse cmdlet retorna uma cadeia de caracteres que contém o caminho convertido.
Observações
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 foram projetados para uso em programas e scripts onde você deseja exibir uma parte ou todo um nome de 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 Path com vários provedores, incluindo os provedores de sistema de arquivos, registro e certificado.
Esse 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
converte apenas caminhos existentes. Ele não pode ser usado para converter um local que ainda não existe.