共用方式為

Join-Path

  • 參考
模組:
Microsoft.PowerShell.Management

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

語法

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

Description

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

範例

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

Join-Path -Path "path" -ChildPath "childpath"

path\childpath

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

由於命令是從 fileSystem 提供者 執行，因此它會提供聯結路徑的 \ 分隔符。

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

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 目錄的磁碟驅動器。

範例 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中新增。

類型:String[]
Position:2
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ChildPath

指定要附加至 Path 參數值的專案。 允許通配符。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Credential

注意

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

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Path

指定附加子路徑的主要路徑（或路徑）。 Path 的值會決定哪些提供者會聯結路徑，並新增路徑分隔符。 允許通配符。

類型:String[]
別名:PSPath
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Resolve

表示此 Cmdlet 應該嘗試解析目前提供者的聯結路徑。

  • 如果您使用通配符，Cmdlet 會傳回符合已聯結路徑的所有路徑。
  • 如果您沒有使用通配符，如果路徑不存在，Cmdlet 會傳回錯誤。
類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

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

輸出

String

此 Cmdlet 會傳回包含結果路徑的字串。

備註

包含 Path 名詞的 Cmdlet 會作路徑名稱，並以簡潔的格式傳回名稱，讓所有 PowerShell 提供者都能解譯。 其設計目的是要在您想要以特定格式顯示路徑的所有或部分之處使用。 您可以使用它們，就像使用 Dirname、Normpath、Realpath、Join或其他路徑作工具一樣。

您可以使用路徑 Cmdlet 搭配數個提供者，包括 FileSystem、Registry和 Certificate 提供者。

此 Cmdlet 的設計目的是要處理任何提供者所公開的數據。 若要列出工作階段中可用的提供者，請輸入 Get-PSProvider。 如需詳細資訊，請參閱 about_Providers。