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
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 FileSystem, ele fornece o delimitador de \ para unir os caminhos.
Exemplo 2: Combinar caminhos que já contêm separadores de diretório
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.
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 Path e ChildPath nomes de parâmetros 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 associado, incluindo curingas do caminho do provedor 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 caminho devem existir ou a junçã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 ficheiros do PowerShell na consola com o subcaminho 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 combina-a 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. O valor de Path determina qual provedor une os caminhos e adiciona os delimitadores de caminho. Curingas são permitidos.
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 você usar curingas, o cmdlet retornará todos os caminhos que correspondem ao caminho associado.
- Se você não usar curingas, o cmdlet retornará 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 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 serem usados onde você deseja exibir todo ou parte de um caminho em um formato específico. Use-os como você usaria Dirname, Normpath, Realpath, Joinou 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.
