远程调用SetEnvironmentVariable遇参数数量3的重载找不到问题求助

尝试通过以下脚本片段在目标机器上设置全局环境变量：

Invoke-Command -ScriptBlock ${function:SetEnvironmentVariableOnTarget} -ArgumentList $location
...
function SetEnvironmentVariableOnTarget($location) 
{
try
{
    [System.Environment]::SetEnvironmentVariable($environmentVarName, $environmentVarValue, $envVarTarget)
    Write-Host "$location - Successfully set $environmentVarName=$env:environmentVarValue in $environmentVarTarget"
}
catch
{
    Write-Host "$location : ERROR: $($Error[0].Exception)"
}    
}

其中$environmentVarName和$environmentVarValue均为字符串，$envVarTarget设为整数2（对应Machine）。但遇到如下错误：

ERROR: System.Management.Automation.MethodException: Cannot find an overload for "SetEnvironmentVariable" and the argument count: "3".

已远程登录目标机器，通过PowerShell命令行执行[System.Environment]::SetEnvironmentVariable("TEST","DEMO", 2)可成功；尝试用[System.EnvironmentVariableTarget]::Machine远程调用也报相同错误。

原因与解决方法 #

核心原因 #

远程执行的脚本块运行在目标机器的独立会话中，本地定义的$environmentVarName、$environmentVarValue、$envVarTarget这三个变量默认不会传递到远程会话里。导致调用SetEnvironmentVariable方法时，实际传入的参数存在缺失或无效值，PowerShell无法匹配到接收3个参数的方法重载，因此报错。

解决方法 #

有两种可行的修正方式：

方式1：将所有需要的变量作为参数传递

修改函数参数列表，让它接收所有必要的变量，然后在调用Invoke-Command时将这些变量一并传入：

# 修正后的函数
function SetEnvironmentVariableOnTarget($location, $environmentVarName, $environmentVarValue, $envVarTarget) 
{
    try
    {
        [System.Environment]::SetEnvironmentVariable($environmentVarName, $environmentVarValue, $envVarTarget)
        Write-Host "$location - Successfully set $environmentVarName=$environmentVarValue in $envVarTarget"
    }
    catch
    {
        Write-Host "$location : ERROR: $($Error[0].Exception)"
    }    
}

# 修正后的调用
Invoke-Command -ScriptBlock ${function:SetEnvironmentVariableOnTarget} -ArgumentList $location, $environmentVarName, $environmentVarValue, $envVarTarget

方式2：使用Using:作用域引用本地变量

在远程脚本块中，通过Using:前缀直接引用本地会话中的变量，无需修改函数参数结构：

Invoke-Command -ScriptBlock {
    try
    {
        [System.Environment]::SetEnvironmentVariable($Using:environmentVarName, $Using:environmentVarValue, $Using:envVarTarget)
        Write-Host "$($Using:location) - Successfully set $($Using:environmentVarName)=$($Using:environmentVarValue) in $($Using:envVarTarget)"
    }
    catch
    {
        Write-Host "$($Using:location) : ERROR: $($Error[0].Exception)"
    }    
} -ComputerName <目标机器名>

补充说明 #

本地直接执行命令成功，是因为所有变量都在当前会话的作用域内，方法调用能获取到完整的3个有效参数；而远程会话默认隔离了本地变量，导致参数异常，触发重载匹配错误。

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