Join-Path

發行項
10/30/2009

將路徑和子路徑結合成單一路徑。路徑分隔字元是由提供者提供。

語法

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 目錄的磁碟機。

請參閱

概念

about_Providers
Test-Path
Split-Path
Resolve-Path
Convert-Path

共用方式為