PowerShell数组处理疑问：存变量后ConvertTo-Html输出异常的原因与解决

1. 差异原因 #

PowerShell的管道机制和ConvertTo-Html的-InputObject参数处理逻辑存在本质区别：

• 当通过管道传递数组时，PowerShell会自动枚举数组中的每个元素，将单个用户对象依次传给ConvertTo-Html，因此能生成包含用户信息的表格。
• 直接使用-InputObject $userData时，参数会把整个数组当作单个对象传入，ConvertTo-Html会解析数组自身的属性（如Length、Count），而非数组内的用户对象。

至于Write-Host $userData能正常显示所有用户，是因为Write-Host在处理数组时会自动枚举元素并输出，它的行为逻辑和ConvertTo-Html的参数接收逻辑完全不同。

2. 解决方法 #

在保留变量的前提下，有两种可靠方式生成预期的HTML表格：

方式一：通过管道传递变量（推荐） #

利用PowerShell的管道自动枚举特性，直接将变量传给ConvertTo-Html：

# 获取数据并存入变量
$userData = Invoke-RestMethod -Uri "你的API地址"
# 通过管道传递，自动枚举每个用户对象
$userData | ConvertTo-Html | Out-File "users.html"

方式二：手动展开数组传入-InputObject #

如果一定要使用-InputObject参数，可以通过数组索引手动展开元素：

$userData = Invoke-RestMethod -Uri "你的API地址"
# 展开数组所有元素传入参数
ConvertTo-Html -InputObject $userData[0..$($userData.Count-1)] | Out-File "users.html"

或者使用@()确保数组被枚举：

ConvertTo-Html -InputObject @($userData) | Out-File "users.html"

（注：当$userData本身是单元素数组时，@()能确保它被当作数组处理并枚举）

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