將路徑和子路徑結合成單一路徑。路徑分隔字元是由提供者提供。
語法
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
描述
Join-Path Cmdlet 會將路徑和子路徑結合成單一路徑。路徑分隔字元是由提供者提供。
參數
-ChildPath <string>
指定要附加至 Path 值的元素。允許使用萬用字元。ChildPath 參數為必要項，但參數名稱 ("ChildPath") 則為選擇項。
|
必要? |
true |
|
位置? |
2 |
|
預設值 |
|
|
接受管線輸入? |
true (ByPropertyName) |
|
接受萬用字元? |
false |
-Credential <PSCredential>
指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。
請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"。或者輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，將會提示您提供密碼。
所有隨 Windows PowerShell 安裝的提供者都不支援此參數。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
true (ByPropertyName) |
|
接受萬用字元? |
false |
-Path <string[]>
指定要附加子路徑的主路徑 (或多個路徑)。允許使用萬用字元。
Path 的值決定應由哪個提供者結合路徑並加入路徑分隔字元。Path 參數為必要項，但參數名稱 ("Path") 則為選擇項。
|
必要? |
true |
|
位置? |
1 |
|
預設值 |
|
|
接受管線輸入? |
true (ByValue, ByPropertyName) |
|
接受萬用字元? |
false |
-Resolve
顯示結合的路徑所參照的項目。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
-UseTransaction
將命令加入現用交易中。此參數只有當交易進行中時才有效。如需詳細資訊，請參閱 about_Transactions。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
|
輸入 |
System.String 您可經由管道將包含路徑的字串輸出至 Join-Path。 |
|
輸出 |
System.String Join-Path 會傳回包含了產生之路徑的字串。 |
附註
有 Path 名詞的 Cmdlet (Path Cmdlet) 會處理路徑名稱，並以所有 Windows PowerShell 提供者都能解譯的簡明格式傳回名稱。其設計用意是供程式和指令碼使用，以視需要顯示特定格式的完整或部分路徑名稱。其用法有如 Dirname、Normpath、Realpath、Join 或其他任何路徑操作指令。
路徑 cmdlet 能與多種提供者搭配使用，包括 FileSystem、Registry 以及 Certificate 提供者。
Join-Path Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PSProvider"。如需詳細資訊，請參閱 about_Providers。
範例 1
C:\PS>join-path -path c:\win* -childpath System* 描述 ----------- 這個命令會使用 Join-Path 結合 "c:\Win*" 路徑和 "System*" 子路徑。Windows PowerShell FileSystem 提供者 (即 FileSystem) 會結合該路徑並加入 "\" 分隔字元。
範例 2
C:\PS>join-path c:\win* System* -resolve 描述 ----------- 這個命令會顯示結合 "c:\Win*" 路徑和 "System*" 子路徑時所參照的檔案和資料夾。它會顯示與 Get-ChildItem 相同的檔案和資料夾，不過會顯示每個項目的完整路徑。在這個命令中，已省略 Path 和 ChildPath 選擇性參數名稱。
範例 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve 描述 ----------- 這個命令會顯示在 HKLM\System 登錄子機碼中包括 "ControlSet" 的登錄機碼。這個範例會示範如何搭配 Windows PowerShell 登錄提供者使用 Join-Path。
範例 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New 描述 ----------- 這個命令會使用 Join-Path 結合多個路徑根目錄和子路徑。
範例 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
描述
-----------
這個命令會將主控台中每一個 Windows PowerShell 檔案系統磁碟機的根目錄與 Subdir 子路徑結合。
這個命令使用 Get-PSDrive Cmdlet 取得 FileSystem 提供者支援的 Windows PowerShell 磁碟機。ForEach 陳述式只會選取 PSDriveInfo 物件的 Root 屬性，並將該屬性與指定的子路徑結合。
輸出顯示電腦上的 Windows PowerShell 磁碟機包含對應到 C:\Program Files 目錄的磁碟機。
請參閱