Convert-Path

  • 參考
模組:
Microsoft.PowerShell.Management

將路徑從 PowerShell 路徑轉換為 PowerShell 提供者路徑。

Syntax

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Description

Cmdlet 會將 Convert-Path 路徑從 PowerShell 路徑轉換成 PowerShell 提供者路徑。

範例

範例 1：將工作目錄轉換為標準檔案系統路徑

本範例會將以點 （.） 表示的目前工作目錄轉換成標準 FileSystem 路徑。

PS C:\> Convert-Path .
C:\

範例 2：將提供者路徑轉換為標準登錄路徑

此範例會將PowerShell提供者路徑轉換成標準登錄路徑。

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

範例 3：將路徑轉換為字串

這個範例會將路徑轉換為目前提供者的主目錄，也就是 FileSystem 提供者，轉換為字串。

PS C:\> Convert-Path ~
C:\Users\User01

參數

-LiteralPath

指定要轉換的路徑，做為字串陣列。 LiteralPath 參數的值會完全依照其類型一樣使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。

如需詳細資訊，請參閱 about_Quoting_Rules。

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

指定要轉換的 PowerShell 路徑。

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

-UseTransaction

在作用中交易中包含 命令。 只有在交易進行中時，此參數才有效。 如需詳細資訊，請參閱 about_transactions。

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

輸入

String

您可以將路徑管線傳送至此 Cmdlet，但不能使用常值路徑。

輸出

String

此 Cmdlet 會傳回包含已轉換路徑的字串。

備註

Windows PowerShell 包含下列的 Convert-Path別名：

  • cvpa

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

您可以使用路徑 Cmdlet 搭配數個提供者，包括 FileSystem、 登錄和 憑證 提供者。

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

Convert-Path 只會轉換現有的路徑。 它無法用來轉換尚未存在的位置。