Convert-Path

将路径从 Windows PowerShell 路径转换为 Windows PowerShell 提供程序路径。

语法

Path (默认值)

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

LiteralPath

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

说明

Convert-Path cmdlet 将路径从 Windows PowerShell 路径转换为 Windows PowerShell 提供程序路径。

示例

示例 1:将工作目录转换为标准文件系统路径

PS C:\> Convert-Path .

此命令将当前工作目录(由点 (.)表示)转换为标准文件系统路径。

示例 2:将提供程序路径转换为标准注册表路径

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

此命令将 Windows PowerShell 提供程序路径转换为标准注册表路径。

示例 3:将路径转换为字符串

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

此命令将当前提供程序(即 FileSystem 提供程序)的主目录的路径转换为字符串。

参数

-LiteralPath

指定要转换的路径,作为字符串数组。 LiteralPath 参数的值与类型完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符,请将它括在单引号中。 单引号告知 Windows PowerShell 不要将任何字符解释为转义序列。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:PSPath

参数集

LiteralPath
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Path

指定要转换的 Windows PowerShell 路径。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

Path
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-UseTransaction

在活动事务中包含该命令。 此参数仅在事务正在进行时有效。 有关详细信息,请参阅about_Transactions。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:usetx

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

可以通过管道将路径(但不是文本路径)传递给此 cmdlet。

输出

String

此 cmdlet 返回包含转换路径的字符串。

备注

  • 包含 Path 名词的 cmdlet 操作路径名称,并返回所有 Windows PowerShell 提供程序可以解释的简洁格式的名称。 它们旨在用于要以特定格式显示路径名称的所有或部分的程序和脚本。 像使用 Dirname、Normpath、Realpath、Join 或其他路径操控器一样使用它们。

    可以将路径 cmdlet 与多个提供程序一起使用,包括 FileSystem、注册表和证书提供程序。

    此 cmdlet 的设计目的是与任何供应商公开的数据进行协作。 若要列出会话中可用的提供程序,请键入 Get-PSProvider。 有关详细信息,请参阅about_Providers。