无法将PSWriteHtml模块导入PowerShell 7的问题求助

问题详情 #

• 在多台设备执行Import-Module PSWriteHtml -UseWindowsPowerShell -WarningAction Ignore将模块导入PowerShell 7时，均报错：

Import-Module: Failed to generate proxies for remote module 'PSWriteHtml'. Cannot process argument because the value of argument "name" is null. Change the value of argument "name" to a non-null value.

• 开发机无需手动导入模块即可运行相关脚本，但Windows Server 2012 R2目标服务器运行脚本时提示cmdlet未被识别。
• 目标服务器的$Env:PSModulePath环境变量中缺少C:\Program Files\WindowsPowerShell\Modules路径，系统环境变量内也无其他相关模块路径。

解决步骤 #

1. 修复PSModulePath环境变量 #

Windows Server 2012 R2的PowerShell 7默认可能未包含Windows PowerShell的模块路径，需手动添加：

• 临时生效（仅当前PowerShell会话）：

$Env:PSModulePath += ";C:\Program Files\WindowsPowerShell\Modules"

• 永久生效（系统级别）：
  打开「系统属性」→「高级」→「环境变量」，在系统变量列表中找到PSModulePath，将;C:\Program Files\WindowsPowerShell\Modules追加到变量值末尾，保存后重启PowerShell 7。

2. 直接在PowerShell 7中安装兼容版本 #

放弃使用-UseWindowsPowerShell代理导入的方式，直接安装支持PowerShell 7的PSWriteHtml模块：

Install-Module -Name PSWriteHtml -Scope CurrentUser -Force

安装完成后直接导入模块：

Import-Module PSWriteHtml -WarningAction Ignore

3. 验证模块状态 #

执行以下命令确认模块是否正常存在并可加载：

# 查看可用模块列表
Get-Module -ListAvailable PSWriteHtml
# 详细导入模块并查看日志
Import-Module PSWriteHtml -Verbose

若仍有问题，检查目标服务器的PowerShell 7版本是否满足要求（建议使用PowerShell 7.0及以上版本，PSWriteHtml对其兼容性更好）。

4. 开发机无需导入的原因说明 #

开发机通常是因为模块已存在于默认模块路径中，或者脚本中包含#Requires -Module PSWriteHtml指令自动触发加载，亦或是模块已被预加载，因此无需手动导入即可运行脚本。

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