Join-Path
Combina um caminho e um caminho filho em um único caminho.
Sintaxe
Default (Default)
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 combinando um caminho com um subcaminho
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 HKLM\System que incluem ControlSet.
O parâmetro Resolve tenta resolver o caminho combinado, incluindo curingas a partir do caminho do provedor atual HKLM:\.
Exemplo 5: combinar múltiplos diretórios raiz com um diretório filho
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Este comando usa o Join-Path para combinar várias raízes de caminho com um caminho filho.
Observação
Se não existirem as unidades especificadas por Path, a união dessa entrada falhará.
Exemplo 6: combinar a raiz 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
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.
Caracteres curinga são permitidos.
O parâmetro ChildPath é necessário, embora o nome do parâmetro ("ChildPath") seja opcional.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Credential
Observação
Esse parâmetro não tem suporte para nenhum provedor instalado com o PowerShell. Para executar este cmdlet em nome de outro usuário ou elevar suas credenciais, use Invoke-Command.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho principal (ou caminhos) ao qual o caminho filho é anexado. Caracteres curinga 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Resolve
Indica que esse cmdlet deve tentar resolver o caminho combinado do provedor atual.
- Se forem usados caracteres curinga, o cmdlet retornará todos os caminhos que correspondem ao caminho combinado.
- Se não forem usados caracteres curingas, o cmdlet gerará um erro se o caminho não existir.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | usetx |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
É possível direcionar 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.
É possível usar os cmdlets de caminho com vários provedores, incluindo os provedores FileSystem, Registry e 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.