如何在基于Cmdlet的PowerShell模块当前运行空间中读写变量？

你遇到的核心问题很明确：你代码里用RunspaceFactory.CreateRunspace()创建了一个全新的独立运行空间，而不是用户当前正在使用的那个PowerShell会话运行空间——这就好比你在一个新窗口里存了东西，当然在原来的窗口看不到啦！

下面给你两种最常用的解决方案，完全贴合PowerShell模块的开发规范：

方案一：在自定义Cmdlet中直接操作当前运行空间（推荐） #

如果你是在编写标准的PowerShell Cmdlet（继承自Cmdlet类），根本不需要手动创建运行空间——Cmdlet本身就运行在当前用户的会话上下文中，直接用SessionState属性就能访问当前运行空间的会话状态。

比如写一个用于建立连接的Cmdlet，把认证密钥存在会话级变量里：

using System.Management.Automation;

namespace MyAppModule
{
    // 连接Cmdlet：处理凭证，生成密钥并存储
    [Cmdlet(VerbsCommunications.Connect, "MyApp")]
    public class ConnectMyAppCmdlet : Cmdlet
    {
        [Parameter(Mandatory = true)]
        public PSCredential Credential { get; set; }

        protected override void ProcessRecord()
        {
            // 替换成你实际的认证密钥生成逻辑
            string authKey = GenerateAuthToken(Credential);

            // 把密钥存储到当前会话的变量中（用模块前缀避免命名冲突）
            SessionState.PSVariable.Set("MyApp_AuthKey", authKey);
            SessionState.PSVariable.Set("MyApp_IsConnected", true);

            WriteObject("连接成功！认证密钥已存储在当前会话中");
        }

        private string GenerateAuthToken(PSCredential cred)
        {
            // 示例逻辑，实际替换成你的加密/生成逻辑
            return $"{cred.UserName}_token_{DateTime.UtcNow.Ticks}";
        }
    }

    // 后续调用的Cmdlet：读取存储的密钥
    [Cmdlet(VerbsCommon.Get, "MyAppResource")]
    public class GetMyAppResourceCmdlet : Cmdlet
    {
        protected override void ProcessRecord()
        {
            // 从当前会话获取密钥
            var authKeyVar = SessionState.PSVariable.Get("MyApp_AuthKey");
            if (authKeyVar == null || authKeyVar.Value == null)
            {
                WriteError(new ErrorRecord(
                    new InvalidOperationException("请先运行 Connect-MyApp 建立连接"),
                    "NotAuthenticated",
                    ErrorCategory.InvalidOperation,
                    null));
                return;
            }

            string authKey = authKeyVar.Value.ToString();
            // 这里用密钥调用你的应用API
            WriteObject($"使用密钥 {authKey} 获取到应用资源");
        }
    }
}

这样用户运行Connect-MyApp之后，在当前PowerShell窗口里直接输入$MyApp_AuthKey就能看到变量，后续的Get-MyAppResource也能自动读取这个密钥，不需要重复输入凭证。

方案二：给辅助类传递当前运行空间 #

如果你需要像你写的VariableTest这样的辅助类来处理变量，不要让它自己创建运行空间，而是把Cmdlet里的SessionState传递进去：

using System.Management.Automation;

namespace Test
{
    public class VariableTest
    {
        private readonly SessionState _currentSession;

        // 构造函数接收当前会话的SessionState
        public VariableTest(SessionState sessionState)
        {
            _currentSession = sessionState;
        }

        public bool CreateSessionVariable()
        {
            // 操作当前会话的变量
            _currentSession.PSVariable.Set("item", "FooBar");
            var storedValue = _currentSession.PSVariable.GetValue("item");
            return storedValue.ToString() == "FooBar";
        }
    }
}

然后在你的Cmdlet里调用这个类：

[Cmdlet(VerbsCommon.Test, "SessionVariable")]
public class TestSessionVariableCmdlet : Cmdlet
{
    protected override void ProcessRecord()
    {
        var variableHelper = new VariableTest(SessionState);
        bool success = variableHelper.CreateSessionVariable();
        WriteObject(success ? "变量已成功写入当前会话" : "变量写入失败");
    }
}

运行Test-SessionVariable之后，你在PowerShell里输入$item就能看到FooBar了！

额外的最佳实践 #

如果你不想把敏感的认证密钥暴露给用户（比如用户不小心输错变量名看到密钥），可以用模块私有数据来存储，只有模块内部的Cmdlet能访问：

// 在Connect-MyApp Cmdlet里存储私有数据
var currentModule = MyInvocation.MyCommand.Module;
currentModule.PrivateData["MyApp_SecretAuthKey"] = authKey;

// 在其他Cmdlet里读取私有数据
var storedKey = currentModule.PrivateData["MyApp_SecretAuthKey"].ToString();

这种方式下，用户在PowerShell里看不到这个变量，安全性更高。

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