Join-Path
Combina um caminho e um caminho filho em um único caminho.
Sintaxe
Default (Predefinição)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
O cmdlet Join-Path combina um caminho e um subcaminho 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 subcaminho.
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 registo na subchave do registo HKLM\System que contêm ControlSet.
O parâmetro Resolve tenta resolver o caminho combinado, incluindo carateres universais do caminho do fornecedor atual HKLM:\
Exemplo 5: Combinar vários diretórios 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 utiliza Join-Path para combinar várias raízes de diretório com um subcaminho.
Observação
As unidades especificadas por Path devem existir, caso contrário, a associação dessa entrada falhará.
Exemplo 6: Integrar as raízes de uma unidade do sistema de arquivos com um caminho secundário
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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-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.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Path
Especifica o caminho principal (ou caminhos) ao(s) qual(is) 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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Resolve
Indica que esse cmdlet deve tentar resolver o caminho associado do provedor atual.
- Se forem usados curingas, o cmdlet retornará todos os caminhos que correspondem ao caminho combinado.
- Se não forem usados curingas, o cmdlet apresentará um erro se o caminho não existir.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Usetx |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este 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 percurso 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.