Resolve-Path

参考

模块:: Microsoft.PowerShell.Management

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

语法

Resolve-Path
       [-Path] <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]

Resolve-Path
       -LiteralPath <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]

说明

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

示例

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

平铺字符（~）是当前用户主文件夹的速记表示法。此示例显示 Resolve-Path 返回完全限定的路径值。

Resolve-Path ~

Path
----
C:\Users\User01

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

Resolve-Path -Path "windows"

Path
----
C:\Windows

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

示例 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]'

参数

-Credential

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

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

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

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-LiteralPath

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

类型:	String[]
别名:	PSPath
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Path

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

类型:	String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-Relative

指示此 cmdlet 返回相对路径。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseTransaction

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

类型:	SwitchParameter
别名:	usetx
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

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

输出

PathInfo

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

String

如果指定 Relative 参数，则此 cmdlet 返回解析路径的字符串值。

备注

Windows PowerShell 包含以下 Resolve-Path别名：

rvpa

*-Path cmdlet 适用于 FileSystem、注册表和证书提供程序。

Resolve-Path 旨在与任何提供程序一起使用。若要列出会话中可用的提供程序，请键入 Get-PSProvider。有关详细信息，请参阅 about_Providers。

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

通过