Linux Docker PowerShell镜像中代码无法识别已装模块及WSMan报错如何解决

• .NET PowerShell SDK提供的嵌入式Runspace默认使用独立的模块搜索路径、原生依赖加载逻辑，不会自动继承系统全局安装的pwsh的环境配置，这就是你手动执行pwsh命令正常、但代码调用报错的核心原因。
• 你看到的This parameter set requires WSMan, and no supported WSMan client library was found报错，本质是嵌入式Runspace没有加载到Linux系统下的WSMan原生依赖，Windows系统自带WSMan栈所以不会触发该报错。

方案1：适配嵌入式Runspace，对齐系统pwsh环境 #

在初始化Runspace前，手动注入系统pwsh的环境变量和模块搜索路径，确保嵌入式实例能找到预安装的依赖和模块：

using System.Runtime.InteropServices;
using System.Management.Automation.Runspaces;

// 初始化前先覆盖PSModulePath，添加系统全局pwsh的模块路径
var originalModulePath = Environment.GetEnvironmentVariable("PSModulePath");
if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
{
    // Linux下pwsh全局模块默认路径，可根据你的镜像实际路径调整
    var globalModulePaths = new[] {
        "/usr/local/share/powershell/Modules",
        "/opt/microsoft/powershell/7/Modules",
        "/root/.local/share/powershell/Modules"
    };
    Environment.SetEnvironmentVariable("PSModulePath", 
        $"{originalModulePath}:{string.Join(":", globalModulePaths)}");
}

// 初始化Runspace时使用系统默认宿主
var runspace = RunspaceFactory.CreateRunspace(new DefaultHost());
runspace.Open();
this._runspace = runspace;

如果修改后还是报WSMan缺失错误，就在Dockerfile中全局注册WSMan组件，确保所有用户都能加载：

RUN pwsh -Command "Install-Module PSWSMan -Force -Scope AllUsers; Install-WSMan -Force"

方案2：直接调用系统pwsh进程（最稳妥，完全复用预装环境） #

如果不想适配嵌入式Runspace的各种差异，直接启动系统预装的pwsh子进程执行脚本，100%继承镜像的所有环境配置：

using System.Diagnostics;

internal const string NewSessionScript = @"
$securePassword = ConvertTo-SecureString '{1}' -AsPlainText -Force
$cred = New-Object System.Management.Automation.PSCredential ('{0}', $securePassword)
New-PSSession -ConfigurationName:Microsoft.Exchange -Authentication:Basic -ConnectionUri:{2} -Credential $cred -AllowRedirection
";

// 替换凭证和连接地址参数，注意转义特殊字符
var escapedUserName = userName.Replace("'", "''");
var escapedPassword = password.Replace("'", "''");
var escapedUri = connectionUri.Replace("'", "''");
var fullScript = string.Format(NewSessionScript, escapedUserName, escapedPassword, escapedUri);

var processStartInfo = new ProcessStartInfo
{
    FileName = "pwsh",
    Arguments = $"-Command \"{fullScript.Replace("\"", "\\\"")}\"",
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = true
};

using var process = Process.Start(processStartInfo);
process.WaitForExit();
var output = process.StandardOutput.ReadToEnd();
var error = process.StandardError.ReadToEnd();

// 解析输出得到PSSession对象信息即可

配置完成后在容器内执行以下命令确认环境正常：
pwsh -Command "Get-Module -ListAvailable; Test-WSMan"
如果没有报错就说明环境配置正确。

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