Resolve-Path
解析路径中的通配符并显示路径内容。
语法
Resolve-Path [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Resolve-Path [-Path] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
说明
Resolve-Path cmdlet 解释路径中的通配符,并显示由路径指定的位置中的项和容器,如文件和文件夹或注册表项和子项。
参数
-Credential <PSCredential>
指定有权执行此操作的用户帐户。默认值为当前用户。
键入用户名,例如“User01”或“Domain01\User01”。或者,输入 PSCredential 对象,例如由 Get-Credential cmdlet 生成的对象。如果键入用户名,则将提示您输入密码。
随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-LiteralPath <string[]>
指定要解析的路径。LiteralPath 的值严格按照所键入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符,请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。
是否为必需? |
true |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Path <string[]>
指定要解析的 Windows PowerShell 路径。此参数是必需的。还可以通过管道将路径字符串传递给 Resolve-Path。
是否为必需? |
true |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
true (ByValue, ByPropertyName) |
是否接受通配符? |
false |
-Relative
返回相对路径。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-UseTransaction
将命令包含在活动事务中。仅当正在执行事务时,此参数才有效。有关详细信息,请参阅 about_Transactions。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.String 可以通过管道将包含路径的字符串传递给 Resolve-Path。 |
输出 |
System.String Resolve-Path 返回一个包含已解析路径的字符串。 |
说明
包含 Path 名词的 cmdlet (Path cmdlet) 采用路径名称作为参数,以所有 Windows PowerShell 提供程序都能够解释的简明格式返回名称。这些 cmdlet 用于需要在其中以特定格式显示全部或部分路径名称的程序或脚本中。您可以像使用 Dirname、Normpath、Realpath、Join 或其他路径操作程序那样使用这些 cmdlet。
可以将路径 cmdlet 与某些提供程序一起使用,包括 FileSystem、Registry 和 Certificate 提供程序。
Resolve-Path cmdlet 可使用由任何提供程序公开的数据。要列出会话中可用的提供程序,请键入“Get-PSProvider”。有关详细信息,请参阅 about_Providers。
示例 1
C:\PS>resolve-path ~
C:\Users\User01
说明
-----------
此命令解析由颚化符字符 (~) 表示的路径,此字符表示起始路径。
示例 2
C:\PS>resolve-path windows
C:\Windows
说明
-----------
从 C: 驱动器的根目录运行时,此命令将返回 C: 驱动器中 Windows 目录的路径。
示例 3
C:\PS>"C:\windows\*" | resolve-path
说明
-----------
此命令返回 C:\Windows 目录中的所有目录。此命令使用管道运算符 (|) 将路径字符串发送到 Resolve-Path。
示例 4
C:\PS>resolve-path \\Server01\public
说明
-----------
此命令解析通用命名约定 (UNC) 路径并返回路径中的共享部分。
示例 5
C:\PS>resolve-path c:\prog* -relative
..\Program Files
..\Program Files (x86)
..\programs.txt
说明
-----------
此命令返回 C: 驱动器根目录中目录的相对路径。
示例 6
C:\PS>resolve-path -literalPath test[xml]
说明
-----------
此命令解析当前目录的 Test[xml] 子目录的路径。它使用 LiteralPath 参数指示方括号不是正则表达式字符。