PowerShell中向Adaptive Card对象的body数组添加元素问题

核心问题拆解 #

1. 固定数组无法直接添加元素：PowerShell默认的Object[]是固定长度数组，没有适配哈希表的Add重载方法，直接调用会触发参数不匹配的错误。
2. 自定义对象转JSON格式偏差：用New-Object+Add-Member创建的PS自定义对象，转JSON时可能出现多余的类型标识或结构错位，无法精准匹配Adaptive Card的嵌套键值对要求。

最优实现方案 #

1. 用哈希表初始化Adaptive Card结构 #

直接通过嵌套哈希表定义Adaptive Card，同时将body初始化为泛型List集合，支持动态添加元素且性能更优：

# 初始化Adaptive Card，body用泛型List存储哈希表
$adaptiveCard = @{
    type = "AdaptiveCard"
    version = "1.5"
    body = [System.Collections.Generic.List[hashtable]]@(
        # 初始默认元素
        @{
            type = "TextBlock"
            text = "主标题"
            size = "Large"
        }
    )
}

2. 循环向body添加元素 #

利用泛型List的原生Add方法，直接传入哈希表格式的Adaptive Card元素即可：

# 模拟循环添加多个文本块元素
for ($i = 1; $i -le 3; $i++) {
    $newItem = @{
        type = "TextBlock"
        text = "动态条目 $i"
        spacing = "Small"
        wrap = $true
    }
    $adaptiveCard.body.Add($newItem)
}

3. 转换为合规的JSON请求体 #

调用ConvertTo-Json时必须指定-Depth参数（Adaptive Card嵌套层级较深，默认深度会导致结构截断）：

$apiRequestBody = $adaptiveCard | ConvertTo-Json -Depth 10
# 输出验证JSON结构
$apiRequestBody

为什么优先用哈希表而非PS自定义对象？ #

哈希表的结构与JSON键值对完全对齐，转JSON时不会额外生成PS对象的元数据；而PS自定义对象在嵌套层级较多时，容易出现键名格式偏差或结构丢失的问题。此外，泛型List的动态添加效率远高于PS数组的+=操作（+=会每次创建新数组，数据量大时性能损耗明显）。

兼容已有数组的临时方案 #

如果你的body已经是Object[]类型，可通过重新赋值的方式添加元素（仅推荐小数据量场景）：

# 向已有数组添加元素
$adaptiveCard.body += @{
    type = "TextBlock"
    text = "通过+=追加的元素"
}

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