Resolve-Path (Microsoft.PowerShell.Management)

Resolve-Path

解析路径中的通配符，并显示路径内容。

句法

Resolve-Path
       [-Path] <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]

Resolve-Path
       -LiteralPath <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]

描述

Resolve-Path cmdlet 在指定位置显示与通配符模式匹配的项目和容器。匹配项可以包括文件、文件夹、注册表项或可从 PSDrive 提供商访问的任何其他对象。

示例

示例1：解析主文件夹路径

波形符 (~) 是当前用户主文件夹的简写符号。此示例显示 Resolve-Path 返回完全限定的路径值。

Resolve-Path ~

Path
----
C:\Users\User01

示例2：解析Windows文件夹的路径

Resolve-Path -Path "windows"

Path
----
C:\Windows

从 C: 驱动器的根目录运行时，此命令返回 C: 驱动器中 Windows 文件夹的路径。

示例3：获取Windows文件夹中的所有路径

"C:\windows\*" | Resolve-Path

此命令返回 C:\Windows 文件夹中的所有文件和文件夹。该命令使用管道运算符 (|) 将路径字符串发送到 Resolve-Path。

示例 4：解析 UNC 路径

Resolve-Path -Path "\Server01\public"

此命令解析通用命名约定 (UNC) 路径并返回路径中的共享。

示例5：获取相对路径

Resolve-Path -Path "c:\prog*" -Relative

.\Program Files
.\Program Files (x86)
.\programs.txt

此命令返回 C: 驱动器根目录的相对路径。

示例 6：解析包含括号的路径

此示例使用 LiteralPath 参数来解析 Test[xml] 子文件夹的路径。使用 LiteralPath 会使括号被视为普通字符而不是正则表达式。

Resolve-Path -LiteralPath 'test[xml]'

示例 7：解析相对于另一个文件夹的路径

此示例使用 RelativeBasePath 参数来解析 pwsh 可执行文件相对于 $env:TEMP 的路径。当该命令包含 Relative 开关参数时，它会返回一个 String 表示从 $env:TEMP 到 pwsh 可执行文件。

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $env:TEMP -Relative

..\..\..\..\..\Program Files\PowerShell\pwsh.exe

参数

-Credential

指定有权执行此操作的用户帐户。默认为当前用户。

键入用户名，例如 User01 或 Domain01\User01，或传递 PSCredential 对象。您可以使用 Get-Credential cmdlet 创建 PSCredential 对象。如果您键入用户名，此 cmdlet 会提示您输入密码。

随 PowerShell 安装的任何提供程序均不支持此参数。

PS凭证

命名

None

False

True

False

-LiteralPath

指定要解析的路径。 LiteralPath 参数的值完全按照键入的值使用。没有字符被解释为通配符。如果路径包含转义字符，请将其括在单引号 (') 中。单引号告诉 PowerShell 不要将任何字符解释为转义序列。

String[]

PSPath, LP

命名

None

True

True

False

-Path

指定要解析的 PowerShell 路径。此参数是必需的。您还可以通过管道将路径字符串传递给Resolve-Path。允许使用通配符。

String[]

0

None

True

True

True

-Relative

指示此 cmdlet 返回相对路径。

SwitchParameter

命名

False

False

False

False

-RelativeBasePath

指定从中解析相对路径的路径。使用此参数时，cmdlet 将返回已解析路径的 System.Management.Automation.PathInfo 对象。

当您将此参数与 Relative 开关参数一起使用时，cmdlet 将返回一个字符串，表示从 RelativeBasePath 到 Path 的相对路径。

此参数是在 PowerShell 7.4 中添加的。

String

命名

None

False

False

False

输入

字符串

您可以通过管道传输包含此 cmdlet 路径的字符串。

输出

路径信息

默认情况下，此 cmdlet 返回一个 PathInfo 对象。

字符串

如果指定相对参数，此 cmdlet 将返回已解析路径的字符串值。

笔记

PowerShell 包含以下 Resolve-Path 别名：

• 所有平台：

  rvpa

*-Path cmdlet 可与文件系统、注册表 和证书 提供程序配合使用。

Resolve-Path 旨在与任何提供商合作。要列出会话中可用的提供程序，请输入 Get-PSProvider。有关更多信息，请参阅 about_providers。

Resolve-Path 仅解析现有路径。它不能用于解析尚不存在的位置。