PowerShell调用自定义函数时如何正确传递字符串数组参数给az cli

问题背景 #

需要封装az tag update命令为PowerShell函数，其中--tags参数接收字符串数组。编写的函数如下：

function Update-ResourceTagsJustForResource {
    [OutputType([string])]
    [CmdletBinding()]
    param (
        [Parameter(Mandatory)][string] $ResourceId,
        [Parameter(Mandatory)][string[]] $ResourceTags
    )
    az tag update --operation merge --resource-id $ResourceId --tags $ResourceTags
}

调用时遇到以下问题：

• 直接传递无逗号分隔的标签：Update-ResourceTagsJustForResource -ResourceId $appPlanId -ResourceTags Tag1=test1 Tag2=test2，报错A positional parameter cannot be found that accepts argument 'Tag2=test2'
• 传递包含空格的单个字符串：Update-ResourceTagsJustForResource -ResourceId $appPlanId -ResourceTags "Tag1=test1 Tag2=test2"，仅添加一个标签"Tag1": "test1 Tag2=test2"
• 尝试多种数组写法均未达到预期效果

正确调用语法 #

方式1：直接用逗号分隔数组元素 #

Update-ResourceTagsJustForResource -ResourceId $appPlanId -ResourceTags "Tag1=test1", "Tag2=test2"

PowerShell中，逗号是数组元素的分隔符，这样传递会将每个Key=Value字符串作为独立的数组元素传入函数。

方式2：先定义数组变量再传递 #

$tagList = "Tag1=test1", "Tag2=test2"
Update-ResourceTagsJustForResource -ResourceId $appPlanId -ResourceTags $tagList

这种方式更清晰，尤其当标签数量较多时。

为什么之前的尝试无效？ #

• 无逗号的写法：PowerShell会将Tag2=test2视为函数的位置参数，而非-ResourceTags参数的一部分，因此报错。
• 单字符串带空格：函数会将整个字符串作为数组的唯一元素传递给az CLI，az CLI会将其解析为一个标签（键为Tag1，值为test1 Tag2=test2）。
• []{"Tag1=test1", "Tag2=test2"}是错误的PowerShell数组语法，正确的数组字面量应为@("Tag1=test1", "Tag2=test2")。
• ("Tag1=test1", "Tag2=test2").Split(',')会将字符串拆分为包含空格的元素（如"Tag1=test1"和" Tag2=test2"），az CLI无法识别带前导空格的标签键。

额外优化：确保参数正确传递给az CLI #

如果函数调用后仍有问题，可以尝试在传递数组时使用PowerShell的数组展开语法（虽然通常不需要，但部分场景下可避免解析问题）：

az tag update --operation merge --resource-id $ResourceId --tags @($ResourceTags)

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