如何排查PowerShell中Get-Item或Test-Path命令执行失败的原因？

网络上很多关于用Test-Path或[System.IO.File]::Exists()验证文件/文件夹存在性的内容，都没区分关键场景：

• 存在的路径会返回true：

  Test-Path -Path "\\Server\Share\path that exists"
  

• 不存在的路径返回false：

  Test-Path -Path "\\Server\Share\path that doesn't exist"
  

• 但存在却因网络问题无法访问的路径，同样返回false：

  Test-Path -Path "\\Server\Share\path that exists but can't be access because network issues"
  

试过用Get-Item捕获异常区分，但哪怕路径存在不可访问，Get-Item也只抛出ItemNotFoundException，没法区分具体原因。

有没有办法区分「路径真实不存在」和「路径存在但不可访问」的情况？

编辑：Windows本身有区分文件未找到、网络问题、访问被拒的系统错误码，希望在PowerShell里利用这些错误码排查路径不可达的具体原因。

要区分不同错误场景，需要深入捕获Win32级别的原生错误代码，而非仅依赖PowerShell上层的异常类型。可以通过try/catch块捕获操作的错误记录，提取内部异常的错误码来判断具体原因：

function Test-PathDetailed {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Path
    )

    $result = [PSCustomObject]@{
        Path = $Path
        Exists = $false
        ErrorCode = $null
        ErrorMessage = $null
        ErrorType = $null
    }

    try {
        # 强制抛出终止错误，确保进入catch块处理异常
        $null = Get-Item -Path $Path -ErrorAction Stop
        $result.Exists = $true
        return $result
    }
    catch {
        # 提取Win32异常信息
        $win32Error = $_.Exception.InnerException -as [System.ComponentModel.Win32Exception]
        if ($win32Error) {
            $result.ErrorCode = $win32Error.NativeErrorCode
            $result.ErrorMessage = $win32Error.Message
            # 根据Win32错误码分类场景
            switch ($win32Error.NativeErrorCode) {
                2 { $result.ErrorType = "FileNotFound" }
                3 { $result.ErrorType = "PathNotFound" }
                5 { $result.ErrorType = "AccessDenied" }
                53 { $result.ErrorType = "NetworkPathUnreachable" }
                123 { $result.ErrorType = "InvalidFileName" }
                default { $result.ErrorType = "UnknownError" }
            }
        }
        else {
            $result.ErrorMessage = $_.Exception.Message
            $result.ErrorType = "PowerShellException"
        }
        return $result
    }
}

功能说明 #

这个函数返回包含详细诊断信息的对象：

• Exists：路径是否存在且可正常访问
• ErrorCode：对应的Windows原生错误码
• ErrorMessage：错误的具体描述
• ErrorType：分类后的错误场景（如文件未找到、网络不可达、权限拒绝等）

常见Win32错误码对应场景：

• 2：目标文件不存在
• 3：目标路径不存在
• 5：访问被系统权限拒绝
• 53：网络路径不可达（如服务器离线、共享未开启）
• 123：文件名/路径格式无效

使用示例 #

# 测试存在且可访问的路径
Test-PathDetailed -Path "\\Server\Share\existing-folder"

# 测试不存在的路径
Test-PathDetailed -Path "\\Server\Share\non-existent-folder"

# 测试存在但网络不可达的路径
Test-PathDetailed -Path "\\OfflineServer\Share\existing-folder"

通过这种方式，就能精准区分「路径真实不存在」和「路径存在但因网络/权限问题不可访问」的场景，直接利用Windows系统错误码定位问题根源。

内容的提问来源于stack exchange，提问作者Tanaka Saito