Combina um caminho e um caminho filho em um único caminho. O provedor oferece os delimitadores do caminho.
Sintaxe
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Join-Path combina um caminho e um caminho filho em um único caminho. O provedor oferece os delimitadores do caminho.
Parâmetros
-ChildPath <string>
Especifica os elementos a serem acrescentados ao valor de Path. Os caracteres curinga são permitidos. O parâmetro ChildPath é obrigatório, embora seu nome (“ChildPath”) seja opcional.
|
Necessário? |
true |
|
Posição? |
2 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como “User01” ou “Domain01\User01”. Ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica o caminho principal (ou caminhos) ao qual o caminho filho será acrescentado. Os caracteres curinga são permitidos.
O valor de Path determina que provedor associará os caminhos e adicionará os delimitadores de caminho. O parâmetro Path é obrigatório, embora seu nome (“Path”) seja opcional.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Resolve
Exibe os itens referenciados pelo caminho associado.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
System.String Você pode enviar uma cadeia de caracteres que contém um caminho para Join-Path. |
|
Saídas |
System.String Join-Path retorna uma cadeia de caracteres que contém o caminho resultante. |
Observações
Os cmdlets que contêm o nome Path (os cmdlets Path) manipulam os nomes de caminho e os retornam em um formato conciso que pode ser interpretado por todos os provedores do Windows PowerShell. Eles foram criados para o uso em programas e scripts em que você deseja exibir todo ou parte de um caminho em um determinado formato. Utilize-os como o faria com Dirname, Normpath, Realpath, Join ou outros manipuladores de caminho.
Você pode usar os cmdlets de caminho com vários provedores, incluindo FileSystem, Registry e Certificate.
O cmdlet Join-Path foi desenvolvido 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.
Exemplo 1
C:\PS>join-path -path c:\win* -childpath System* Descrição ----------- Esse comando usa Join-Path para combinar o caminho "c:\Win*" com o caminho filho "System*". O provedor do sistema de arquivos do Windows PowerShell, FileSystem, associa o caminho e adiciona o delimitador "\".
Exemplo 2
C:\PS>join-path c:\win* System* -resolve Descrição ----------- Esse comando exibe os arquivos e as pastas referenciados pela associação do caminho "c:\Win*" e do caminho filho "System*". Ele exibe os mesmos arquivos e pastas que Get-ChildItem, mas exibe o caminho totalmente qualificado para cada item. Nesse comando, os nomes dos parâmetros Path e ChildPath, que são opcionais, são omitidos.
Exemplo 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve Descrição ----------- Esse comando exibe as chaves do Registro na subchave do Registro HKLM\System que inclui "ControlSet". Esse exemplo mostra como usar Join-Path com o provedor de Registro do Windows PowerShell.
Exemplo 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New Descrição ----------- Esse comando usa Join-Path para combinar várias raízes de caminho com um caminho filho.
Exemplo 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Descrição
-----------
Esse comando combina as raízes de cada unidade do sistema de arquivos do Windows PowerShell no console com o caminho filho de Subdir.
O comando usa o cmdlet Get-PSDrive para obter as unidades do Windows PowerShell suportadas pelo provedor FileSystem. A instrução ForEach seleciona apenas a propriedade Root dos objetos PSDriveInfo e a combina com o caminho filho especificado.
A saída mostra que as unidades do Windows PowerShell no computador incluíam uma unidade mapeada para o diretório C:\Arquivos de Programas.
See Also