如何在PowerShell中声明远程变量并让脚本正确访问？

你遇到的核心问题是：远程执行字符串形式的脚本时，环境变量引用$env:var1未被正确解析为实际值，导致输出变量名而非预期内容。以下是几种可行的解决方式：

方法一：直接使用脚本块执行（推荐） #

将YAML中定义的脚本字符串转换为PowerShell脚本块，传递到远程会话执行，变量会自动在远程环境中解析：

# 注意：YAML中脚本位于step节点下，需修正为$config.step.script
$lines = $config.step.script
foreach($line in $lines){
    # 将字符串转换为可执行的脚本块
    $scriptBlock = [scriptblock]::Create($line)
    Invoke-Command -Session $session -ScriptBlock $scriptBlock
}

这种方式无需依赖Invoke-Expression，脚本块会直接在远程会话中运行，自动展开其中的环境变量引用。

方法二：先展开变量再执行 #

如果必须保留字符串传递的方式，可以在远程会话中先用ExpandString解析变量引用，再执行脚本：

$lines = $config.step.script
foreach($line in $lines){
    Invoke-Command -Session $session -ScriptBlock {
         param([string]$Line)
         # 先展开字符串中的环境变量，再执行
         $expandedContent = $ExecutionContext.InvokeCommand.ExpandString($Line)
         Invoke-Expression $expandedContent
    } -ArgumentList $line
 }

ExpandString会将字符串中的$env:var1替换为远程会话中已设置的环境变量值，确保Invoke-Expression执行的是解析后的内容。

额外优化：批量设置远程环境变量 #

你原代码中逐个调用Invoke-Command设置环境变量的方式可以简化为批量操作，减少远程交互次数：

Invoke-Command -Session $session -ScriptBlock {
    param([hashtable]$EnvVars)
    foreach($key in $EnvVars.Keys){
        Set-Item -Path "env:$key" -Value $EnvVars[$key]
    }
} -ArgumentList $config.env

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