Partilhar via

Join-Path

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

Combina um caminho e um caminho filho em um único caminho.

Sintaxe

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

Description

O cmdlet Join-Path combina um caminho e um caminho filho em um único caminho. O provedor fornece os delimitadores de caminho.

Exemplos

Exemplo 1: Combinar um caminho com um caminho filho

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Este comando usa Join-Path para combinar um caminho com um caminho filho.

Como o comando é executado a partir do provedor de FileSystem, ele fornece o delimitador de \ para unir os caminhos.

Exemplo 2: Combinar caminhos que já contêm separadores de diretório

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Os separadores de diretório existentes \ e manipulados para que haja apenas um separador entre Path e ChildPath

Exemplo 3: Exibir arquivos e pastas unindo um caminho com um caminho filho

Join-Path "C:\win*" "System*" -Resolve

Este comando exibe os arquivos e pastas que são referenciados unindo o caminho C:\Win* e o caminho filho System*. Ele exibe os mesmos arquivos e pastas que Get-ChildItem, mas exibe o caminho totalmente qualificado para cada item. Neste comando, os nomes de parâmetros Path e ChildPath opcionais são omitidos.

Exemplo 4: Usar Join-Path com o provedor de registro do PowerShell

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Este comando exibe as chaves do Registro na subchave do Registro HKLM\System que incluem ControlSet.

O parâmetro Resolve tenta resolver o caminho associado, incluindo curingas do caminho do provedor atual HKLM:\

Exemplo 5: Combinar várias raízes de caminho com um caminho filho

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Este comando usa Join-Path para combinar várias raízes de caminho com um caminho filho.

Observação

As unidades especificadas por Path devem existir ou a junção dessa entrada falhará.

Exemplo 6: Combinar as raízes de uma unidade do sistema de arquivos com um caminho filho

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Este comando combina as raízes de cada unidade do sistema de arquivos do PowerShell no console com o caminho filho Subdir.

O comando usa o cmdlet Get-PSDrive para obter as unidades do PowerShell suportadas pelo provedor FileSystem. A instrução ForEach-Object seleciona apenas a propriedade Root dos objetos PSDriveInfo e a combina com o caminho filho especificado.

A saída mostra que as unidades do PowerShell no computador incluíam uma unidade mapeada para o diretório C:\Program Files.

Parâmetros

-ChildPath

Especifica os elementos a serem acrescentados ao valor do parâmetro Path. Curingas são permitidos. O parâmetro ChildPath é necessário, embora o nome do parâmetro ("ChildPath") seja opcional.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Credential

Observação

Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Path

Especifica o caminho principal (ou caminhos) ao qual o caminho filho é acrescentado. Curingas são permitidos.

O valor de Path determina qual provedor une os caminhos e adiciona os delimitadores de caminho. O parâmetro Path é obrigatório, embora o nome do parâmetro ("Path") seja opcional.

Tipo:String[]
Aliases:PSPath
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Resolve

Indica que esse cmdlet deve tentar resolver o caminho associado do provedor atual.

  • Se curingas forem usados, o cmdlet retornará todos os caminhos que correspondem ao caminho associado.
  • Se nenhum curinga for usado, o cmdlet errará se o caminho não existir.
Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UseTransaction

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

Entradas

String

Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.

Saídas

String

Este cmdlet retorna uma cadeia de caracteres que contém o caminho resultante.

Notas

Os cmdlets que contêm o substantivo Path (os cmdlets 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 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, Registrye 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.