Compartilhar via

Convert-Path

  • Referência
Módulo:
Microsoft.PowerShell.Management

Converte um caminho de um caminho do PowerShell em um caminho de provedor do PowerShell.

Sintaxe

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 Sistema de Arquivos.

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 Get-Item comando confirma que a .git pasta está oculta. O uso 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 no PowerShell 7.5-preview.5.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LiteralPath

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 caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples informam 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, LP
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho do PowerShell a ser convertido.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

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

Esse cmdlet foi projetado 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.

Convert-Path converte apenas caminhos existentes. Ele não pode ser usado para converter um local que ainda não existe.