Compartilhar via

Convert-Path

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

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

Sintaxe

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Description

O cmdlet Convert-Path converte um caminho de um caminho do Windows PowerShell em um caminho de provedor do Windows PowerShell.

Exemplos

Exemplo 1: converter o diretório de trabalho em um caminho padrão do sistema de arquivos

PS C:\> Convert-Path .

Esse comando converte o diretório de trabalho atual, que é representado por um ponto (.), em um caminho padrão do sistema de arquivos.

Exemplo 2: converter um caminho de provedor em um caminho de registro padrão

PS C:\> Convert-Path HKLM:\Software\Microsoft

Esse comando converte o caminho do provedor do Windows PowerShell em um caminho de registro padrão.

Exemplo 3: Converter um caminho em uma cadeia de caracteres

PS C:\> Convert-Path ~
C:\Users\User01

Esse comando converte o caminho para o diretório inicial do provedor atual, que é o provedor FileSystem, em uma cadeia de caracteres.

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 curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao Windows PowerShell para não interpretar nenhum caractere como sequências de escape.

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

-Path

Especifica o caminho do Windows PowerShell a ser convertido.

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

-UseTransaction

Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

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

Entradas

String

Você pode redirecionar um caminho, mas não um caminho literal, para este cmdlet.

Saídas

String

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 Windows PowerShell podem interpretar. Eles são projetados para uso em programas e scripts em que você deseja exibir todo ou parte de 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 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 na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.