Compartilhar 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

Esse comando usa Join-Path para combinar um caminho com um childpath.

Como o comando é executado do provedor de FileSystem, ele fornece o delimitador \ 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

Separadores de diretório existentes \ e tratados 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

Esse comando exibe os arquivos e pastas referenciados ao unir o caminho C:\Win* e o caminho filho do Sistema*. Ele exibe os mesmos arquivos e pastas que Get-ChildItem, mas exibe o caminho totalmente qualificado para cada item. Nesse comando, os nomes de parâmetro opcional Path e ChildPath 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 ingressado, 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

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

Nota

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

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

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

A saída mostra que as unidades do PowerShell no computador incluíram uma unidade mapeada para o diretório C:\Arquivos de Programas.

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
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Credential

Nota

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

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 é necessário, embora o nome do parâmetro ("Path") seja opcional.

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

-Resolve

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

  • Se caracteres curinga forem usados, o cmdlet retornará todos os caminhos que correspondem ao caminho unido.
  • Se não curingas forem usados, o cmdlet errorá se o caminho não existir.
Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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 canalizar uma cadeia de caracteres que contém um caminho para este cmdlet.

Saídas

String

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

Observações

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