加载PowerShell模块dbatools失败，如何深入排查？

我有一个基于dbatools模块收集SQL Server实例信息的PowerShell脚本，由Web应用触发执行。之前运行完全正常，但Web应用做了一些变更后，现在通过浏览器按F12打开开发者工具能看到报错：

"detail": "{'definition': ErrorDetail(string='QS-Check for the Instance: S-SQL-XXX-03', code='error'), 'errors': ErrorDetail(string='The PowerShell module dbatools could not be loaded.', code='error'), 'result': ErrorDetail(string='Error', code='error')}"

该脚本单独运行无任何问题，报错出现在以下代码段：

try
{
    # Set defaults just for this session
    set-dbatoolsconfig -name import.EncryptionMessageCheck -value $false -PassThru 
    | register-dbatoolsConfig
    Set-DbatoolsConfig -FullName sql.connection.trustcert -Value $true
    Set-DbatoolsConfig -FullName sql.connection.encrypt -Value $false
    Import-Module dbatools -Force    
    Import-Module sqlserver -Force             
}
catch
{
    $error[0].Exception.Message | Out-File  "C:\temp\QSLog.txt" -Append
    $table.result = "Error."
    $table.errors = "The PowerShell module dbatools could not be loaded."
    throw $table
}

请问该如何深入排查此错误？

• 检查Web应用的执行身份权限：脚本单独运行正常说明本地环境有dbatools，但Web应用可能使用了不同的服务账号（比如IIS的ApplicationPoolIdentity或特定域账号）。先确认Web应用的执行账号，然后用该账号登录服务器，手动运行脚本验证是否能加载dbatools——大概率是该账号无模块访问权限。
• 扩展错误日志的详细程度：当前catch块仅记录了$error[0].Exception.Message，加载模块失败可能有更具体的原因（比如模块路径不存在、依赖缺失、版本不兼容）。修改catch块，写入完整错误信息：

  $error[0] | Format-List -Force | Out-File "C:\temp\QSLog.txt" -Append
  

• 确认dbatools的安装范围：如果dbatools安装在当前用户的模块路径（C:\Users\<用户名>\Documents\WindowsPowerShell\Modules），Web应用的执行账号可能无法访问。检查模块是否在全局路径（C:\Program Files\WindowsPowerShell\Modules或C:\Windows\System32\WindowsPowerShell\v1.0\Modules），如果是用户级安装，要么重新安装到全局路径，要么给Web应用账号授权访问用户模块路径。
• 检查PowerShell执行策略：Web应用环境的执行策略可能过严（比如Restricted），导致无法加载模块。可以在脚本开头临时设置执行策略，或先检查当前进程的执行策略：

  Get-ExecutionPolicy -Scope Process
  

  必要时临时调整为RemoteSigned：

  Set-ExecutionPolicy RemoteSigned -Scope Process -Force
  

• 验证模块依赖兼容性：dbatools依赖其他PowerShell模块（比如特定版本的SqlServer模块），Web应用环境可能缺失依赖或版本不匹配。在能正常运行脚本的环境中执行Get-Module dbatools -ListAvailable | Format-List，对比Web应用执行环境的模块版本和依赖情况。
• 核对PowerShell版本：不同版本的PowerShell对模块兼容性不同，dbatools通常需要PowerShell 5.1及以上版本。确认Web应用调用的PowerShell版本和你手动运行的版本一致：

  $PSVersionTable.PSVersion
  

• 检查文件系统权限：确认dbatools模块所在文件夹的安全权限，确保Web应用执行账号有读取和执行权限。

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