Resolve-Path
解析路径中的通配符并显示路径内容。
语法
Resolve-Path
[-Path] <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Resolve-Path
-LiteralPath <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
说明
cmdlet Resolve-Path
显示与指定位置处的通配符模式匹配的项和容器。 匹配可以包括文件、文件夹、注册表项或从 PSDrive 提供程序访问的任何其他对象。
示例
示例 1:解析主文件夹路径
平铺字符 (~) 是当前用户主文件夹的速记表示法。 此示例演示如何 Resolve-Path
返回完全限定的路径值。
PS C:\> Resolve-Path ~
Path
----
C:\Users\User01
示例 2:解析 Windows 文件夹的路径
PS C:\> Resolve-Path -Path "windows"
Path
----
C:\Windows
从 C: 驱动器的根目录运行时,此命令返回 C: 驱动器中 Windows 文件夹的路径。
示例 3:获取 Windows 文件夹中的所有路径
PS C:\> "C:\windows\*" | Resolve-Path
此命令返回 C:\Windows 文件夹中的所有文件夹。 命令使用管道运算符 (|) 将路径字符串发送到 Resolve-Path
。
示例 4:解析 UNC 路径
PS C:\> Resolve-Path -Path "\\Server01\public"
此命令解析通用命名约定 (UNC) 路径并返回路径中的共享部分。
示例 5:获取相对路径
PS C:\> Resolve-Path -Path "c:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt
此命令返回 C: 驱动器根目录中目录的相对路径。
示例 6:解析包含括号的路径
此示例使用 LiteralPath 参数解析 Test[xml] 子文件夹的路径。 使用 LiteralPath 会将括号视为普通字符而不是正则表达式。
PS C:\> Resolve-Path -LiteralPath 'test[xml]'
参数
-Credential
指定有权执行此操作的用户帐户。 默认为当前用户。
键入用户名,例如 User01 或 Domain01\User01,或传递 PSCredential 对象。 可以使用 cmdlet 创建 PSCredential 对象 Get-Credential
。 键入用户名时,此 cmdlet 会提示输入密码。
随 PowerShell 一起安装的任何提供程序都不支持此参数。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
指定要解析的路径。 LiteralPath 参数的值完全按类型使用。 不会将任何字符解释为通配字符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
指定要解析的 PowerShell 路径。
此参数是必需的。
还可以通过管道将路径字符串传递给 Resolve-Path
。
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Relative
指示此 cmdlet 返回相对路径。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseTransaction
在活动事务中使用该命令。 仅当正在执行事务时,此参数才有效。 有关详细信息,请参阅 about_transactions。
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将包含路径的字符串传递给此 cmdlet。
输出
System.Management.Automation.PathInfo, System.String
返回 PathInfo 对象。 如果指定 Relative 参数,则返回解析路径的字符串值。
备注
- 这些
*-Path
cmdlet 适用于 FileSystem、注册表和证书提供程序。 Resolve-Path
旨在与任何提供程序配合使用。 若要列出会话中可用的提供程序,请键入Get-PSProvider
。 有关详细信息,请参阅 about_providers。