C#调用带模块的PowerShell脚本：调试正常安装后报错

核心错误是Add-Type无法找到WebClient类型，导致BcContainerHelper模块加载失败。这是因为Velopack打包后的执行环境与调试/直接运行环境存在差异，主要涉及.NET程序集引用、PowerShell模块加载路径或执行上下文的问题。

1. 修复Add-Type的程序集引用问题 #

WebClient属于System.Net.WebClient程序集，默认情况下可能未被加载。可以通过两种方式解决：

方案A：在脚本开头显式加载程序集 #

在test.ps1最顶部添加：

Add-Type -AssemblyName System.Net.WebClient

方案B：修改模块中的Add-Type命令 #

找到C:\Program Files\WindowsPowerShell\Modules\BcContainerHelper\6.0.15\HelperFunctions.ps1第27行，修改Add-Type命令添加程序集引用：

Add-Type -TypeDefinition $timeoutWebClientCode -Language CSharp -ReferencedAssemblies System.Net.WebClient

2. 显式指定模块完整路径导入 #

避免依赖PowerShell自动模块查找逻辑，直接用完整路径导入模块：

# 替换原Import-Module命令
Import-Module "C:\Program Files\WindowsPowerShell\Modules\BcContainerHelper\6.0.15\BcContainerHelper.psd1" -Force

3. 检查并修复PSModulePath环境变量 #

打包后的程序可能丢失默认模块路径，在脚本开头验证并修复：

Write-Output "Current PSModulePath: $env:PSModulePath"
# 若路径不包含系统模块目录，手动添加
if (-not $env:PSModulePath.Contains("C:\Program Files\WindowsPowerShell\Modules")) {
    $env:PSModulePath += ";C:\Program Files\WindowsPowerShell\Modules"
}

4. 优化模块安装逻辑 #

避免每次运行都强制安装模块，先检查模块是否存在：

# 替换原Install-Module命令
if (-not (Get-Module -ListAvailable -Name BcContainerHelper)) {
    Install-Module -Name BcContainerHelper -Force -Scope AllUsers -AllowClobber
}

5. 强制使用PowerShell 5.1 #

WebClient在PowerShell 7（基于.NET Core）中已被标记为过时，而BcContainerHelper依赖PowerShell 5.1。在脚本开头添加版本验证：

if ($PSVersionTable.PSVersion.Major -ne 5) {
    Write-Error "此脚本需要PowerShell 5.1环境"
    exit 1
}

6. 验证管理员权限 #

即使清单设置了权限，仍可在脚本开头强制检查：

$currentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
if (-not $currentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
    Write-Error "此脚本需要管理员权限运行"
    exit 1
}

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