如何通过Invoke-Command向远程服务器传递预定义函数与对象参数

云原生阿岚

2026-8-27

问题根因

该问题由PowerShell参数绑定的默认逻辑导致：Invoke-Command的-ArgumentList参数会自动展开传入的集合类型值，将集合内的每个元素作为独立的位置参数传递给远程执行的脚本块。
你传入的@('a','b','c')数组会被拆分为3个独立参数，而你定义的testA函数仅声明了$test这1个形参，因此参数绑定时只会取第一个元素'a'赋值给$test，剩余两个元素会被直接忽略，最终只输出第一个元素。

可行解决方案

方案1：最小改动修复，传参时加前置逗号阻止数组展开
在传入的对象参数前加一个英文逗号，将原对象包装为单元素嵌套数组。PowerShell传递参数时仅会展开外层的单元素数组，内层的完整对象就会作为单个参数绑定到$test形参。
修正后代码如下：

$object = @('a','b','c')

function testA {
    [CmdletBinding()]
    param (
        [Parameter()]
        [System.Object]
        $test
    )
    Write-Host $test
}

# 注意-ArgumentList后的前置逗号，是修复的核心
Invoke-Command -Session $session -ScriptBlock ${function:testA} -ArgumentList ,$object

方案2：封装脚本块通过using:作用域传参，彻底规避参数展开问题
如果需要传递多个复杂类型参数，可将函数定义、调用逻辑统一放到远程脚本块内，通过$using:作用域直接读取本地变量，完全绕开-ArgumentList的展开逻辑。如果不想重复编写函数体，可先将本地函数转为脚本块对象传入。
示例代码如下：

$object = @('a','b','c')
# 把本地预定义的testA函数转为脚本块对象
$remoteFunc = [ScriptBlock]::Create(${function:testA}.ToString())

Invoke-Command -Session $session -ScriptBlock {
    # 在远程会话中重建testA函数
    Set-Item -Path Function:testA -Value $using:remoteFunc
    # 直接读取本地$object变量传入函数，不会出现参数拆分问题
    testA -test $using:object
}