Convert-Path
將路徑從 Windows PowerShell 路徑轉換為 Windows PowerShell 提供者路徑。
語法
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>]
Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
描述
Convert-Path Cmdlet 會將路徑由 Windows PowerShell 的形式轉換為 Windows PowerShell 提供者的形式。
參數
-LiteralPath <string[]>
指定要轉換的路徑。LiteralPath 會使用實際輸入的內容做為參數值。任何字元均不被解譯成萬用字元。如果路徑中包含逸出字元，請將其置於單引號內。單引號係告訴 Windows PowerShell 不要將任何字元解譯成逸出序列。
必要? |
true |
位置? |
1 |
預設值 |
|
接受管線輸入? |
true (ByPropertyName) |
接受萬用字元? |
false |
-Path <string[]>
指定要轉換的 Windows PowerShell 路徑。
必要? |
true |
位置? |
1 |
預設值 |
|
接受管線輸入? |
true (ByValue, ByPropertyName) |
接受萬用字元? |
false |
-UseTransaction
將命令加入現用交易中。此參數只有當交易進行中時才有效。如需詳細資訊，請參閱 about_Transactions。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.String 您可以經由管道將路徑 (但不是常值路徑) 輸出至 Convert-Path。 |
輸出 |
System.String Convert-Path 會傳回包含了已轉換之路徑的字串。 |
附註
有 Path 名詞的 Cmdlet (Path Cmdlet) 會處理路徑名稱，並以所有 Windows PowerShell 提供者都能解譯的簡明格式傳回名稱。其設計用意是供程式和指令碼使用，以視需要顯示特定格式的完整或部分路徑名稱。其用法有如 Dirname、Normpath、Realpath、Join 或其他任何路徑操作指令。
路徑 cmdlet 能與多種提供者搭配使用，包括 FileSystem、Registry 以及 Certificate 提供者。
Convert-Path Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PSProvider"。如需詳細資訊，請參閱 about_Providers。
範例 1
C:\PS>convert-path ~
描述
-----------
這個命令會展開目前的工作目錄。
範例 2
C:\PS>convert-path HKLM:\software\microsoft
描述
-----------
這個命令會將 Windows PowerShell 提供者路徑轉換成標準登錄路徑。