PS Core RunspacePool中InitialSessionState的StartupScripts未执行问题

你踩了一个很容易忽略的细节坑——InitialSessionState.StartupScripts接受的是脚本文件的完整路径，而不是直接的脚本代码或命令字符串！这就是为什么你会收到"The term 'xxx' is not recognized..."的错误：PowerShell把你传入的字符串当成了要执行的命令名，而不是脚本文件路径，自然找不到对应的命令/脚本。

问题根源拆解 #

你之前写的iss.StartupScripts.Add("some PS script here")和iss.StartupScripts.Add("Import-Module 'modulexyz'")都是错误的用法：

• StartupScripts的设计目的是让PowerShell在Runspace初始化时执行指定路径的脚本文件，而不是直接解析执行字符串里的命令。
• 当你传入非路径的字符串时，PowerShell会尝试在系统PATH或当前会话中查找同名的命令、函数或脚本，找不到就会抛出你看到的错误。

正确解决方案 #

方案1：使用外部脚本文件（推荐）

如果你的初始化逻辑比较复杂，建议把它写到一个.ps1脚本文件里，然后传入该文件的绝对路径到StartupScripts中：

// 获取程序运行目录下的startup.ps1完整路径
string startupScriptPath = Path.Combine(AppContext.BaseDirectory, "startup.ps1");

var iss = InitialSessionState.CreateDefault();
iss.ExecutionPolicy = Microsoft.PowerShell.ExecutionPolicy.Unrestricted;
iss.Variables.Add(new SessionStateVariableEntry("testVar", myVar, "no description"));
// 传入脚本文件的绝对路径
iss.StartupScripts.Add(startupScriptPath);

// 后续创建RunspacePool的代码不变
using (RunspacePool RsPool = RunspaceFactory.CreateRunspacePool(iss))
{
    RsPool.Open();
    using (var ps = PowerShell.Create())
    {
        ps.RunspacePool = RsPool;
        // 你的业务代码
    }
}

startup.ps1文件里可以写你的初始化逻辑，比如：

Import-Module modulexyz
Write-Host "Runspace initialized with testVar: $testVar"
# 其他初始化操作

方案2：内嵌脚本代码（无需外部文件）

如果你的初始化逻辑很简短，不想单独写脚本文件，可以通过RunspacePool的RunspaceCreated事件来为每个新创建的Runspace执行初始化代码：

var iss = InitialSessionState.CreateDefault();
iss.ExecutionPolicy = Microsoft.PowerShell.ExecutionPolicy.Unrestricted;
iss.Variables.Add(new SessionStateVariableEntry("testVar", myVar, "no description"));

using (RunspacePool RsPool = RunspaceFactory.CreateRunspacePool(iss))
{
    // 为每个新创建的Runspace添加初始化逻辑
    RsPool.RunspaceCreated += (sender, e) =>
    {
        using (var initPs = PowerShell.Create())
        {
            initPs.Runspace = e.Runspace;
            // 直接写入要执行的脚本代码
            initPs.AddScript(@"
                Import-Module modulexyz
                Write-Host ""Runspace initialized""
            ");
            // 执行初始化代码，捕获可能的错误
            var errors = initPs.Invoke();
            if (initPs.HadErrors)
            {
                // 处理初始化错误
                foreach (var err in initPs.Streams.Error)
                {
                    Console.WriteLine($"Init error: {err.Message}");
                }
            }
        }
    };

    RsPool.Open();
    using (var ps = PowerShell.Create())
    {
        ps.RunspacePool = RsPool;
        // 你的业务代码
    }
}

额外验证点 #

1. 确保你的脚本文件路径正确：可以用File.Exists(startupScriptPath)提前校验路径是否存在，避免路径错误。
2. ExecutionPolicy设置：你已经设置为Unrestricted，这没问题，但如果是生产环境，建议根据实际需求调整为更严格的策略（比如RemoteSigned）。

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