Join-Path

參考

模組:: Microsoft.PowerShell.Management

將路徑和子路徑結合成單一路徑。

Syntax

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

Cmdlet 會將 Join-Path 路徑和子路徑結合成單一路徑。提供者會提供路徑分隔符號。

範例

範例 1：結合路徑與子路徑

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

此命令會使用 Join-Path 來結合路徑與子路徑。

由於命令是從 FileSystem 提供者執行，所以它會提供 \ 分隔符以聯結路徑。

範例 2：合併已包含目錄分隔符的路徑

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

現有的目錄分隔符 \ 會處理，因此和之間 Path 只有一個分隔符 ChildPath

範例 3：使用子路徑聯結路徑來顯示檔案和資料夾

Join-Path "C:\win*" "System*" -Resolve

此命令會顯示聯結路徑和子路徑所 C:\Win\* 參考的檔案和 System\* 資料夾。它會顯示與 Get-ChildItem相同的檔案和資料夾，但會顯示每個專案的完整路徑。在此命令中 Path ，會省略和 ChildPath 選擇性參數名稱。

範例 4：搭配 PowerShell 登錄提供者使用 Join-Path

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

此命令會在包含ControlSet的HKLM\System登錄子機碼中顯示登錄機碼。

Resolve參數會嘗試解析聯結的路徑，包括來自目前提供者路徑的通配符HKLM:\

範例 5：將多個路徑根與子路徑結合

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

此命令會使用 Join-Path 來結合多個路徑根目錄與子路徑。

注意

指定的 Path 磁碟驅動器必須存在，否則該專案的聯結將會失敗。

範例 6：將文件系統磁碟驅動器的根目錄與子路徑結合

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

此命令會將控制台中每個 PowerShell 檔案系統磁碟驅動器的根目錄與 Subdir 子路徑結合。

此命令會 Get-PSDrive 使用 Cmdlet 來取得 FileSystem 提供者支援的 PowerShell 磁碟驅動器。 ForEach-Object語句只會選取 PSDriveInfo 物件的 Root 屬性，並將它與指定的子路徑結合。

輸出顯示電腦上的PowerShell磁碟驅動器包含對應至目錄的 C:\Program Files 磁碟驅動器。

範例 7：結合無限數目的路徑

Join-Path a b c d e f g

a\b\c\d\e\f\g

參數 AdditionalChildPath 允許不限數目的路徑聯結。

在此範例中，不會使用任何參數名稱，因此 “a” 會系結至 Path、“b” 至 ChildPath 和 “c-g” AdditionalChildPath

參數

-AdditionalChildPath

指定要附加至 Path 參數值的其他元素。參數 ChildPath 仍是必要參數，而且也必須指定。

這個參數是使用屬性來指定， ValueFromRemainingArguments 這個屬性會啟用無限數目的路徑聯結。

此參數已在PowerShell 6.0中新增。

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ChildPath

指定要附加至參數值的專案 Path 。允許使用萬用字元。參數 ChildPath 是必要的，雖然參數名稱 (“ChildPath”) 是選擇性的。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Credential

注意

任何隨 PowerShell 一起安裝的提供者都不支援此參數。若要模擬其他使用者，或在執行此 Cmdlet 時提高您的認證，請使用 Invoke-Command。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

指定附加子路徑的主要路徑。允許使用萬用字元。

的值 Path 會決定哪些提供者會聯結路徑，並加入路徑分隔符。參數 Path 是必要的，雖然參數名稱 (“Path”) 是選擇性的。

Type:	String[]
Aliases:	PSPath
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Resolve

指出這個 Cmdlet 應該嘗試解析目前提供者的聯結路徑。

如果使用通配符，Cmdlet 會傳回符合聯結路徑的所有路徑。
如果未使用通配符，如果路徑不存在，Cmdlet 就會發生錯誤。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

String

您可以使用管線將包含路徑的字串傳送至此 Cmdlet。

輸出