Join-Path
Combina um caminho e um caminho filho em um único caminho.
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
O Join-Path
cmdlet combina um caminho e um caminho filho em um único caminho.
O provedor fornece os delimitadores de caminho.
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 FileSystem
provedor, ele fornece o \
delimitador para unir os caminhos.
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Os separadores \
de diretório existentes são manipulados para que haja apenas um separador entre Path
e ChildPath
Join-Path "C:\win*" "System*" -Resolve
Este comando exibe os arquivos e pastas que são referenciados unindo o C:\Win\*
caminho e o System\*
caminho filho. Ele exibe os mesmos arquivos e pastas que Get-ChildItem
o , mas exibe o caminho totalmente qualificado para cada item. Neste comando, os nomes dos Path
parâmetros opcionais são ChildPath
omitidos.
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 HKLM\System
Registro que incluem ControlSet
.
O Resolve
parâmetro tenta resolver o caminho associado, incluindo curingas do caminho do provedor atual HKLM:\
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.
Nota
As unidades especificadas por Path
devem existir ou a junção dessa entrada falhará.
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 Subdir
caminho filho.
O comando usa o Get-PSDrive
cmdlet para obter as unidades do PowerShell suportadas pelo provedor FileSystem. A ForEach-Object
instrução 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 C:\Program Files
diretório.
Especifica os elementos a serem acrescentados ao valor do Path
parâmetro. Curingas são permitidos. O ChildPath
parâmetro é 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 |
Nota
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 |
Especifica o caminho principal (ou caminhos) ao qual o caminho filho é acrescentado. Curingas são permitidos.
O valor de determina qual provedor une os caminhos e adiciona os delimitadores de Path
caminho.
O Path
parâmetro é 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 |
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 |
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 |
Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.
Este cmdlet retorna uma cadeia de caracteres que contém o caminho resultante.
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 o FileSystem
, Registry
e Certificate
provedores.
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.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: