PowerShell中函数与脚本块处理数组求和结果不同的原因及解决方法

问题场景 #

有如下哈希表数组，需要计算每个项的x属性之和：

$Items = @(
    @{x = 110; y = 108 },
    @{x = 102; y = 100 },
    @{x = 116; y = 114 }
)

对应的函数可以正确计算总和：

function Get-SumXFunction {
    Param($Items)
    $Measured = $Items | Measure-Object -Sum x
    return $Measured.Sum
}

但将逻辑改为脚本块后，调用.Invoke($Items)只返回第一个项的x值，而非总和：

$GetSumXScriptBlock = {
    Param($Items)
    $Measured = $Items | Measure-Object -Sum x
    Write-Output $Measured.Sum
}

调用代码：

Write-Host "Get-SumXFunction:" (Get-SumXFunction $Items)
Write-Host "Get-SumXScriptBlock:" ($GetSumXScriptBlock.Invoke($Items))

输出结果：

Get-SumXFunction: 328
Get-SumXScriptBlock: 110

原因分析 #

脚本块的.Invoke()方法在传递集合参数时，会自动对集合进行枚举，把数组的每个元素作为独立参数传递给脚本块的参数列表。也就是说，原本期望$Items接收整个数组，但实际上脚本块的$Items参数只接收到了数组的第一个元素@{x=110; y=108}，后面的元素被忽略（因为脚本块只定义了一个参数）。这导致Measure-Object仅计算单个哈希表的x值，最终返回110。

而PowerShell函数在接收参数时，默认会将整个集合绑定到单个参数上（除非参数设置了[Parameter(ValueFromPipeline)]或使用特殊参数处理），因此函数能正确拿到完整数组并计算总和。

解决方法 #

有两种可靠方式修正脚本块的调用：

方法1：使用&调用运算符（推荐） #

PowerShell的&调用运算符会遵循常规参数绑定规则处理脚本块，不会自动枚举集合。直接用&执行脚本块并传递参数：

Write-Host "Get-SumXScriptBlock:" (& $GetSumXScriptBlock $Items)

方法2：用数组包裹参数传递给.Invoke() #

如果必须使用.Invoke()方法，需将参数包装在一个数组里，避免自动枚举：

Write-Host "Get-SumXScriptBlock:" ($GetSumXScriptBlock.Invoke(@($Items)))

补充说明：脚本块中使用return和Write-Output的效果本质一致，PowerShell中两者都会输出到管道，你的这部分误解不影响结果，问题核心是参数传递方式的差异。

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