如何在PowerShell管道中优雅返回单个PSCustomObject对象？

核心优化思路 #

避免先创建哈希表再转换的冗余步骤，直接在管道流程中生成或转换为PSCustomObject，同时解决直接返回哈希表导致数组输出的问题。

方案1：直接在Process块构造PSCustomObject #

适用于为每个管道输入对象生成独立的自定义对象场景，语法简洁且直接输出目标类型：

function Get-FileInfoCustom {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        [System.IO.FileInfo]$InputObject
    )
    process {
        # 直接将哈希表转换为PSCustomObject并输出
        [PSCustomObject]@{
            FileName      = $InputObject.Name
            FileSizeKB    = [math]::Round($InputObject.Length / 1KB, 2)
            LastModified  = $InputObject.LastWriteTime
        }
    }
}

# 使用示例
Get-ChildItem -File | Get-FileInfoCustom

方案2：用Select-Object快速投影属性 #

如果只是需要对输入对象的属性进行选择/转换，无需自定义函数，Select-Object结合计算属性是最简洁的方式，返回结果天然是PSCustomObject：

Get-ChildItem -File | Select-Object `
    @{Name='FileName'; Expression={$_.Name}},
    @{Name='FileSizeKB'; Expression={[math]::Round($_.Length / 1KB, 2)}},
    @{Name='LastModified'; Expression={$_.LastWriteTime}}

方案3：动态添加属性（适用于属性不确定场景） #

当需要根据条件动态添加属性时，直接在空PSCustomObject上用Add-Member添加，比哈希表操作更直观：

function Get-DynamicCustomObject {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        $InputObject
    )
    process {
        $obj = [PSCustomObject]@{}
        $obj | Add-Member -MemberType NoteProperty -Name 'BaseName' -Value $InputObject.BaseName
        
        # 动态添加条件属性
        $obj | Add-Member -MemberType NoteProperty -Name 'IsLargeFile' -Value ($InputObject.Length -gt 1MB)
        $obj
    }
}

方案4：汇总管道输入为单个PSCustomObject #

如果需求是将所有管道输入的信息汇总到一个对象中，优化后无需New-Object，直接在End块转换哈希表：

function Get-FileSummary {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        [System.IO.FileInfo]$InputObject
    )
    begin {
        $totalFiles = 0
        $totalSize = 0
    }
    process {
        $totalFiles++
        $totalSize += $InputObject.Length
    }
    end {
        [PSCustomObject]@{
            TotalFiles  = $totalFiles
            TotalSizeMB = [math]::Round($totalSize / 1MB, 2)
        }
    }
}

# 使用示例
Get-ChildItem -File | Get-FileSummary

为什么直接返回哈希表会得到数组？ #

PowerShell管道中，每个Process块返回的哈希表会被视为独立的输出对象，多输入场景下会自动打包为数组。而[PSCustomObject]@{...}会直接将哈希表转换为自定义对象，输出的是PSCustomObject类型的集合，完全符合需求。

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