PowerShell如何处理属性不一致对象列表的全属性显示/导出

对象列表中不同实例可能存在独有属性，示例数据结构如下：

$list = @(
  [pscustomobject]@{ Name='Pork';   Type='Meat' },
  [pscustomobject]@{ Name='Orange'; Type='Fruit'
    SubType='Berry'  ## 额外属性
  }, 
  [pscustomobject]@{ Name='Peanut'; Type='Nut'
    Salty=$true      ## 额外属性
  },
  [pscustomobject]@{ Name='Gumball'; Type='Candy'
    $Foo.Name = $Foo.Value  ## 属性名未知的额外属性
  }
)

这类结构常见于Add-Member动态加属性、WMI查询返回、多类型相似对象cmdlet输出的场景。

使用Format-Table、Select-Object *、Export-Csv等批量处理cmdlet时，默认仅读取列表第一个对象的属性作为全局列基准，后续对象的独有属性会被遗漏，复现示例：

$list | Format-Table -Property *  ## 仅展示第一个对象的Name、Type属性

Name    Type 
----    ---- 
Pork    Meat 
Orange  Fruit
Peanut  Nut  
Gumball Candy

# 同类问题表现：
$list | Get-Member                ## 仅列出2个NoteProperty
$list | Select-Object -Property * ## 效果和Format-Table一致，遗漏额外属性
$list | Export-Csv test.csv       ## 导出的CSV仅包含前两列

# 仅Format-List可以正常展示所有属性，因为它是逐对象单独渲染，不做全局schema校验
$list | Format-List               

核心思路是先扫描全量对象收集所有存在的属性名，再用统一的属性集合做选择/导出，缺失对应属性的对象会自动留空值。

• 快速处理写法：

# 第一步：收集所有对象的全部唯一属性名
$allProps = $list | ForEach-Object { $_.PSObject.Properties.Name } | Select-Object -Unique

# 第二步：指定全量属性做后续操作
# 导出CSV
$list | Select-Object $allProps | Export-Csv result.csv -NoTypeInformation -Encoding UTF8
# 表格展示
$list | Select-Object $allProps | Format-Table -AutoSize

• 可复用管道函数写法，适合频繁处理这类数据的场景：

function Select-AllProperties {
    begin {
        $items = @()
        $propSet = [System.Collections.Generic.HashSet[string]]::new()
    }
    process {
        $items += $_
        $_.PSObject.Properties.Name | ForEach-Object { $null = $propSet.Add($_) }
    }
    end {
        $items | Select-Object -Property $propSet.ToArray()
    }
}

函数用法：

# 直接管道衔接后续操作即可
$list | Select-AllProperties | Export-Csv test.csv -NoTypeInformation
$list | Select-AllProperties | Format-Table
Get-WmiObject -Class Win32_LogicalDisk | Select-AllProperties | Export-Csv disk.csv

注意：如果列表数据量极大，先全量扫描收集属性会有一定内存开销，绝大多数报表导出场景下这个开销可以忽略。

内容的提问来源于stack exchange，提问作者Cpt.Whale