Join-Path
將路徑和子路徑結合成單一路徑。
語法
Default (預設值)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Join-Path Cmdlet 會將路徑和子路徑結合成單一路徑。
提供者會提供路徑分隔符。
範例
範例 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
此命令顯示 HKLM\System 登錄子機碼中包含 ControlSet的登錄機碼。
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 目錄的磁碟驅動器。
參數
-ChildPath
指定要追加至 Path 參數值的元素。
允許使用通配符。
ChildPath 參數是必要的，但參數名稱 （“ChildPath”） 是選擇性的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Credential
備註
任何與 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者，或在執行此 Cmdlet 時提升您的認證，請使用 Invoke-Command。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Path
指定作為子路徑附加對象的主要路徑（或路徑）。 允許使用通配符。
Path 的值會決定哪一個提供者會聯結路徑，並新增路徑分隔符。
Path 參數是必要的，但參數名稱 （“Path”） 是選擇性的。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | PSPath |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Resolve
表示此 Cmdlet 應該嘗試解析目前提供者的聯結路徑。
- 如果使用通配符，Cmdlet 會傳回符合已聯結路徑的所有路徑。
- 如果 未使用任何 通配符，如果路徑不存在，Cmdlet 就會發生錯誤。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseTransaction
在作用中交易中包含 命令。 只有在交易進行中時，此參數才有效。 如需詳細資訊，請參閱 about_Transactions。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | usetx |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
您可以傳送包含路徑的字串到此 Cmdlet。
輸出
String
此 Cmdlet 會傳回包含結果路徑的字串。
備註
包含 Path 名詞的 Cmdlet（這些 Path Cmdlet）操作路徑名稱，並以簡潔的格式回傳路徑名稱，讓所有 PowerShell 提供者都能解譯。 其設計用於您想要以特定格式顯示路徑名稱的所有或部分的程式和腳本中。 使用它們就像使用 Dirname、Normpath、Realpath、Join 或其他路徑操作工具一樣。
您可以將路徑 Cmdlet 用於多個提供者，包括 FileSystem、Registry和 Certificate 等提供者。
此 Cmdlet 的設計目的是要處理任何提供者所公開的數據。
若要列出工作階段中可用的提供者，請輸入 Get-PSProvider。
如需詳細資訊，請參閱 about_Providers。