PowerShell中向管道函数传字符串数组时变量未解析如何解决？

问题场景 #

编写了Create-ConfluenceTable函数用于创建表格对象，以及支持管道的AddRow函数用于添加行：

function Create-ConfluenceTable{
    param(
        [Parameter(mandatory=$true)][string]$Title,
        [Parameter(mandatory=$true)][string[]]$Columns
    )

    $rows = [System.Collections.Generic.List[string]]::new()

    $t = [PSCustomObject]@{
        Title = $Title;
        Columns = $Columns;
        Rows = $rows
    }

    return $t
}

function AddRow {
    param(
        [Parameter(mandatory,ValueFromPipeline)]$ConfluenceTable,
        [Parameter(mandatory=$true)][string[]]$RowValues
    )

    process
    {
        foreach($rv in $RowValues) {
            $ConfluenceTable.Rows.Add($rv)
        }
    }
}

执行测试代码时，变量$bar未被正确解析，Rows中显示{"Foo",$bar}而非预期的{"Foo","https://example.com"}：

$bar="https://example.com"
$ct = Create-ConfluenceTable -title "URLs" -Columns {"Type","Url"}
$ct | AddRow -RowValues {"Foo",$bar}
$ct

问题原因 #

PowerShell中{}是**脚本块（ScriptBlock）**的定义符号，并非数组字面量。传递{"Type","Url"}和{"Foo",$bar}时，PowerShell不会将其解析为字符串数组，而是直接把脚本块对象转为字符串，导致变量$bar未被展开。

解决方法 #

1. 修正数组构造方式：将参数中的{}替换为PowerShell数组构造运算符@()，这样能正确解析数组内的变量并生成字符串数组：

$bar="https://example.com"
$ct = Create-ConfluenceTable -title "URLs" -Columns @("Type","Url")
$ct | AddRow -RowValues @("Foo",$bar)
$ct

2. 优化AddRow函数逻辑（可选）：当前AddRow会把RowValues的每个元素单独作为一行添加，若需要将一组值作为完整的表格行存入，可修改函数将数组元素拼接为单个字符串（比如用Confluence表格的分隔符|）：

function AddRow {
    param(
        [Parameter(mandatory,ValueFromPipeline)]$ConfluenceTable,
        [Parameter(mandatory=$true)][string[]]$RowValues
    )

    process
    {
        # 将一行的多列值拼接为单个字符串，适配Confluence表格行格式
        $row = $RowValues -join "|"
        $ConfluenceTable.Rows.Add($row)
    }
}

调整后执行测试代码，Rows会得到预期的解析结果，变量也能正常展开。

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