PowerShell管道传递多PSCustomObject仅保留首个对象问题排查

核心原因 #

你遇到的问题本质是PowerShell管道参数绑定与函数执行块的配合问题：

1. 未配置管道绑定属性：如果参数没有添加[Parameter(ValueFromPipeline=$true)]标记，PowerShell不会将管道中的每个对象逐个传递给参数，而是可能将整个输入集合作为单个值传入，导致后续对象无法被正确识别。
2. 缺少process执行块：PowerShell高级函数默认在end块中执行逻辑，只有定义process块时，才会对管道中的每个对象分别执行一次处理逻辑。如果没有process块，即使参数是数组类型，函数也只会在所有管道输入接收完成后执行一次，若你的逻辑仅处理了参数的首个元素，就会出现仅首个对象被处理的情况。

错误示例（导致问题的函数定义） #

比如你的Get-IncorrectResults可能是类似这样的写法：

function Get-IncorrectResults {
    param(
        [pscustomobject[]]$InputObject  # 未添加管道绑定属性
    )
    # 无process块，仅执行一次逻辑
    Write-Output "处理对象：$($InputObject[0].Name)"  # 仅处理第一个元素
}

或者即使加了管道绑定，但没写process块：

function Get-IncorrectResults {
    param(
        [Parameter(ValueFromPipeline=$true)]
        [pscustomobject[]]$InputObject
    )
    # 无process块，所有管道对象被收集为数组，但逻辑仅处理单个元素
    Write-Output "处理对象：$($InputObject.Name)"
}

正确的函数定义 #

要解决问题，需要做两点修改：

1. 给参数添加[Parameter(ValueFromPipeline=$true)]标记，允许从管道接收输入。
2. 将处理逻辑放在process块中，确保每个管道对象都被单独处理；推荐将参数类型定义为单个对象（而非数组），PowerShell会自动适配管道传递的多个对象。

方案一：逐个处理单个对象（推荐） #

这种方式符合PowerShell管道的设计习惯，适合逐个调用REST API的场景：

function Get-CorrectResults {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        [pscustomobject]$InputObject  # 定义为单个对象
    )

    process {
        # 逻辑会对管道中的每个对象执行一次
        Write-Output "处理对象：$($InputObject.Name)"
        # 此处编写针对单个对象的REST API调用逻辑
    }
}

方案二：批量处理所有对象 #

如果需要一次性处理所有管道对象（比如批量API请求），可以保留数组类型参数，通过begin/process/end块收集并批量处理：

function Get-CorrectBatchResults {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        [pscustomobject[]]$InputObject
    )

    begin {
        # 初始化数组收集所有管道对象
        $allObjects = @()
    }

    process {
        # 将每个管道传递的对象添加到收集数组
        $allObjects += $InputObject
    }

    end {
        # 所有对象接收完成后批量处理
        foreach ($obj in $allObjects) {
            Write-Output "批量处理对象：$($obj.Name)"
        }
        # 此处编写批量REST API调用逻辑
    }
}

验证测试 #

用你的Get-MyTest测试两种方案：

# 管道传递，现在会处理所有对象
Get-MyTest | Get-CorrectResults

# 直接传递数组也能正常工作
Get-CorrectResults -InputObject (Get-MyTest)

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