Description

Cmdlet Split-Path 只會傳回路徑的指定部分,例如父資料夾、子資料夾或檔名。 它也可以取得分割路徑所參考的專案,並判斷路徑是否為相對或絕對。

您可以使用此 Cmdlet 來取得或只提交路徑的選取部分。

範例 1:取得路徑的限定符

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

此命令只會傳回路徑的限定符。 限定符是磁碟驅動器。

範例 2:顯示檔名

Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
	

此命令會顯示分割路徑所參考的檔案。 由於此路徑會分割至最後一個專案,也稱為分葉,因此命令只會顯示檔名。

Resolve 參數會告知Split-Path顯示分割路徑參考的專案,而不是顯示分割路徑。

如同所有 Split-Path 命令,此命令會傳回字串。 它不會傳回 代表檔案的 FileInfo 物件。

範例 3:取得父容器

Split-Path -Parent "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0

此命令只會傳回路徑的父容器。 因為它不包含任何參數來指定分割,所以 Split-Path 會使用分割位置預設值,也就是 Parent

範例 4:判斷路徑是否為絕對路徑

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False

此命令會判斷路徑是相對路徑還是絕對路徑。 在這裡情況下,因為路徑是相對於目前資料夾,以點 (.) 表示,所以會傳 $False回 。

範例 5:將位置變更為指定的路徑

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

此命令會將您的位置變更為包含 PowerShell 設定檔的資料夾。

括弧中的命令只會傳 Split-Path 回儲存在內 $Profile 建變數中之路徑的父代。 Parent 參數是預設的分割位置參數。 因此,您可以從 命令中省略它。 括弧會指示PowerShell先執行命令。 這是移至具有完整路徑名稱之資料夾的實用方式。

範例 6:使用管線分割路徑

'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents

這個指令會使用管線運算子 (|) 將路徑傳送至 Split-Path。 路徑會以引弧括住,以指出它是單一標記。

-Credential

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

-Parent

指出此 Cmdlet 只會傳回專案或路徑所指定容器的父容器。 例如,在路徑 C:\Test\Logs\Pass1.log中,它會傳 C:\Test\Logs回 。 Parent 參數是預設的分割位置參數。

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

-Path

指定要分割的路徑。 允許通配符。 如果路徑包含空格,請以引號括住它。 您也可以使用管線將路徑傳送至此 Cmdlet。

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

-Qualifier

表示這個 Cmdlet 只會傳回指定路徑的限定符。 針對 FileSystem 或登錄提供者,限定符是提供者路徑的磁碟驅動器,例如 C:HKCU:

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

-Resolve

指出這個 Cmdlet 會顯示由產生的分割路徑所參考的專案,而不是顯示路徑專案。

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

String

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

String

此 Cmdlet 會傳回文字字串。 當您指定 Resolve 參數時,它會傳回描述專案位置的字串。 它不會傳回代表項目的物件,例如 FileInfoRegistryKey 物件。

Boolean

當您指定 IsAbsolute 參數時,這個 Cmdlet 會 傳回布爾 值。

  • 分割位置參數(限定符代、 延伸模組分葉Leaf、LeafBaseNoQualifier)是獨佔的。 每個指令中只能使用一個 。

  • 包含 Path 名詞 (Path Cmdlet) 的 Cmdlet 會使用路徑名稱,並以簡潔的格式傳回所有 PowerShell 提供者都可以解譯的名稱。 其設計用於您想要以特定格式顯示路徑名稱之所有或部分的程式和腳本中。 以使用 Dirname、NormpathRealpathJoin 或其他路徑操作工具的方式使用它們。

  • 您可以搭配數個提供者使用 Path Cmdlet。 其中包括 FileSystem、登錄和憑證提供者。

  • Split-Path 是設計來使用任何提供者所公開的數據。 若要列出工作階段中可用的提供者,請輸入 Get-PSProvider。 如需詳細資訊,請參閱 about_Providers

    即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱 https://aka.ms/ContentUserFeedback

    提交並檢視相關的意見反應

  •