PowerShell函数返回重复对象：除Out-Null外有更佳解决方法吗？

你的问题本质是PowerShell的隐式输出特性：函数中所有未被捕获或抑制的表达式结果都会被自动添加到输出流中。Set-Body和Set-Labels返回的PSBoundParameters没有被处理，和New-Page最终的$returnObj一起组成了输出数组。

1. 直接丢弃不需要的返回值（推荐） #

用$null直接接收Set-Body和Set-Labels的返回值，比Out-Null更高效（避免管道开销）：

function New-Page {
    param(...)
    # 直接用$null接收，丢弃返回值
    $null = Set-Body @PSBoundParameters
    $null = Set-Labels @PSBoundParameters
    
    $returnObj = [PSCustomObject]@{...}
    return $returnObj
}

2. 修改辅助函数，避免不必要的输出 #

如果Set-Body和Set-Labels的设计目的是修改参数集合或执行操作，而非返回值，直接在这些函数中抑制输出：

方式一：用[void]标记不需要输出的表达式 #

function Set-Body {
    param([hashtable]$PSBoundParameters, [string]$Body)
    # 修改参数集合后，用[void]抑制返回
    [void]$PSBoundParameters.Add('Body', $Body)
}

方式二：明确返回空值 #

在函数末尾添加无参数的return，终止输出：

function Set-Labels {
    param([hashtable]$PSBoundParameters, [string[]]$Labels)
    $PSBoundParameters['Labels'] = $Labels
    # 明确不返回任何内容
    return
}

3. 用Out-Null的正确姿势（如果必须用） #

如果你坚持用Out-Null，确保通过管道传递，它会丢弃所有输出：

Set-Body @PSBoundParameters | Out-Null
Set-Labels @PSBoundParameters | Out-Null

但相比$null = ...，这种方式有额外的管道处理开销，性能稍差。

你担心的风险其实源于未明确控制输出流，而非Out-Null本身。只要你明确知道哪些输出需要保留、哪些需要丢弃，无论是用$null还是Out-Null都没问题。但$null = ...是更符合PowerShell最佳实践的写法，既清晰又高效。

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