.NET 6 Windows Service中PowerShell NuGet包调用异常求助

参数path1的含义 #

从错误堆栈来看，path1是System.IO.Path.Combine方法的第一个参数，在System.Management.Automation.Configuration.PowerShellConfig构造函数中被调用。这个参数原本应该是PowerShell运行时依赖的系统路径（比如PowerShell模块目录、配置文件目录等），由于部署环境下该路径值为空，导致触发ArgumentNullException。

问题根源 #

本地运行正常但部署后报错，核心原因是单文件自包含部署模式与PowerShell SDK的路径解析逻辑冲突：

• 本地开发环境中，PowerShell的环境变量（如PSModulePath）和依赖路径都是完整的，且未打包为单文件，SDK能正常解析所需路径；
• 单文件部署时，.NET将所有依赖打包为单个EXE，PowerShell SDK初始化时无法正确读取系统默认的PowerShell路径或环境变量，导致PowerShellConfig初始化失败。

解决方案 #

方案1：取消单文件发布设置 #

直接去掉发布时的“生成单个文件”选项，改为常规的多文件部署。这种方式能让PowerShell SDK正常解析系统路径，是最直接的解决办法。

方案2：手动初始化PowerShell环境变量 #

在创建PowerShell实例前，手动设置PSModulePath环境变量，确保PowerShell SDK能找到依赖的模块路径：

private void RunPcsScript(string pcsServiceName, string newestVersion, string pcsPath)
{
    // 提前初始化PSModulePath环境变量
    var existingPsModulePath = Environment.GetEnvironmentVariable("PSModulePath");
    if (string.IsNullOrEmpty(existingPsModulePath))
    {
        // 构造Windows 10默认的PowerShell模块路径
        var systemModulePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Windows), "System32", "WindowsPowerShell", "v1.0", "Modules");
        var userModulePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "WindowsPowerShell", "Modules");
        Environment.SetEnvironmentVariable("PSModulePath", $"{systemModulePath};{userModulePath}", EnvironmentVariableTarget.Process);
    }

    _logger.Info("Creating Powershell");
    using var ps = PowerShell.Create();
    // 后续原有代码保持不变...
}

方案3：使用自定义会话状态初始化Runspace #

避免依赖默认的InitialSessionState.CreateDefault()，手动创建仅包含所需命令的会话状态，跳过ExperimentalFeature等不必要的初始化逻辑：

private void RunPcsScript(string pcsServiceName, string newestVersion, string pcsPath)
{
    _logger.Info("Creating Powershell");
    
    // 创建自定义初始会话状态，只添加需要的Cmdlet
    var initialSessionState = InitialSessionState.Create();
    initialSessionState.Commands.Add(new SessionStateCmdletEntry(
        "Remove-Service", 
        typeof(Microsoft.PowerShell.Commands.RemoveServiceCommand), 
        null
    ));
    initialSessionState.Commands.Add(new SessionStateCmdletEntry(
        "New-Service", 
        typeof(Microsoft.PowerShell.Commands.NewServiceCommand), 
        null
    ));

    // 使用自定义会话状态创建Runspace
    using var runspace = RunspaceFactory.CreateRunspace(initialSessionState);
    runspace.Open();

    using var ps = PowerShell.Create();
    ps.Runspace = runspace;

    // 后续原有代码保持不变...
}

额外说明 #

• 不要尝试升级到.NET 7（你已尝试过），因为会丢失Windows.Management.Deployment.PackageManager的访问权限；
• 确保目标机器的Windows 10版本（17763及以上）符合你的目标框架要求。

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