Convert-Path
Converte um caminho de um caminho do PowerShell em um caminho de provedor do PowerShell.
Sintaxe
Path (Padrão)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
Description
O cmdlet Convert-Path converte um caminho do PowerShell para 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 filesystem padrão.
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
Exemplo 4: Converter caminhos para itens ocultos
Por padrão, Convert-Path não retorna itens ocultos. Este exemplo usa o parâmetro Force para localizar itens ocultos. O comando Get-Item confirma se a pasta .git está oculta. Usar Convert-Path sem o parâmetro Force retorna apenas os itens visíveis. Adicionar o parâmetro Force retorna todos os itens, incluindo itens ocultos.
PS> Get-Item .git -Force
Directory: D:\Git\PS-Docs\PowerShell-Docs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git
PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
Parâmetros
-Force
Permite que o cmdlet obtenha itens que, de outra forma, não podem ser acessados pelo usuário, como arquivos ocultos ou do sistema. O parâmetro Force não substitui as restrições de segurança. A implementação varia entre os provedores. Para obter mais informações, consulte about_Providers.
Esse parâmetro foi adicionado ao PowerShell 7.5-preview.5.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LiteralPath
Especifica o caminho a ser convertido, como uma matriz de strings. O valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.
Para mais informações, consulte sobre_Regras_de_Citação.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath, LP |
Conjuntos de parâmetros
LiteralPath
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho do PowerShell a ser convertido.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
Path
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 canalizar um caminho, mas não um caminho literal, para esse cmdlet.
Saídas
String
Esse cmdlet retorna uma cadeia de caracteres que contém o caminho convertido.
Observações
O PowerShell inclui os seguintes aliases para Convert-Path:
- Todas as plataformas:
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 em que você deseja exibir todo ou parte de um caminho em um formato específico. Use-os como você usaria Dirname, Normpath, Realpath, Joinou outros manipuladores de caminho.
Você pode usar os cmdlets de caminho com vários provedores, inclusive os provedores de FileSystem, Registro e Certificado.
Esse cmdlet foi projetado para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.
Convert-Path converte apenas os caminhos existentes. Ele não pode ser usado para converter um local que ainda não existe.
