Convert-Path
将路径从 PowerShell 路径转换为 PowerShell 提供程序路径。
语法
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
说明
Convert-Path
cmdlet 将路径从 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
示例 4:转换隐藏项的路径
默认情况下, Convert-Path
不返回隐藏项。 此示例使用 Force 参数查找隐藏项。 该 Get-Item
命令确认文件夹 .git
已隐藏。 如果不Convert-Path
使用 Force 参数,则仅返回可见项。
添加 Force 参数将返回所有项,包括隐藏项。
PS> Get-Item .git -Force
Directory: D:\Git\PS-Docs\PowerShell-Docs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git
PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
参数
-Force
允许 cmdlet 获取用户非此不能访问的项,例如隐藏文件或系统文件。 Force 参数不会覆盖安全限制。 实现提供程序之间的差异。 有关详细信息,请参阅 about_Providers。
此参数已在 PowerShell 7.5-preview.5 中添加。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LiteralPath
指定要转换的路径(作为一个字符串数组)。 LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
有关详细信息,请参阅 about_Quoting_Rules。
类型: | String[] |
别名: | PSPath, LP |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Path
指定要转换的 PowerShell 路径。
类型: | String[] |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | True |
输入
可以通过管道将路径(但不是文本路径)传递给此 cmdlet。
输出
此 cmdlet 返回一个包含已转换的路径的字符串。
备注
PowerShell 包含 Convert-Path
的以下别名:
- 所有平台:
cvpa
包含 Path 名词的 cmdlet 采用路径名称作为参数,以所有 PowerShell 提供程序都能够解释的简明格式返回名称。 这些 cmdlet 用于需要在其中以特定格式显示全部或部分路径的程序或脚本中。 你可以像使用 Dirname、Normpath、Realpath、Join 或其他路径操作程序那样使用这些 cmdlet。
可以将路径 cmdlet 与某些提供程序一起使用,包括 FileSystem、Registry 和 Certificate 提供程序。
此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序,请键入 Get-PSProvider
。 有关详细信息,请参阅 about_Providers。
Convert-Path
仅转换现有路径。 它不能用于转换尚不存在的位置。