Resolve-Path

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

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

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

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

Resolve-Path ~

Path
----
C:\Users\User01

Resolve-Path -Path "windows"

Path
----
C:\Windows

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

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

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

Resolve-Path -Path "\\Server01\public"

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

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

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

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

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

Resolve-Path -LiteralPath 'test[xml]'

此示例使用 RelativeBasePath 参数解析 pwsh 可执行文件相对于 $Env:TEMP的路径。 当命令包含 Relative switch 参数时，它将返回表示从 到 $Env:TEMP 可执行文件的相对路径的 pwsh。

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

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

默认情况下，Resolve-Path 不返回隐藏项。 此示例使用 Force 参数解析隐藏项。 Get-Item 命令确认 .git 文件夹已隐藏。 在不使用 Resolve-Path 参数的情况下，使用 只返回可见项。 添加 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> Resolve-Path .git*

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Resolve-Path .git* -Force

Path
----
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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

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

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

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

PowerShell 包含以下与 Resolve-Path相关的别名：

• 所有平台：
  • rvpa

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

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

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