Az FunctionApp配置应用设置时尾随右括号被截断

问题场景 #

我在PowerShell脚本中编写了以下代码，用于批量设置Azure函数应用的配置项：

foreach ($row in $csv) {
    # 将键拆分为密钥保管库名称和机密名称
    $keyParts = $row.key -split '\|'
    $functionAppName = $keyParts[0]
    $settingName = $keyParts[1]
    $value = $row.value
    
    if ($value -match '^https://.*\.vault\.azure\.net/secrets/.*') {
        $value = "@Microsoft.KeyVault(SecretUri=$value)"
    }
    write-host "Setting $settingName for $functionAppName to $value"
    az functionapp config appsettings set --resource-group $rg --name $functionAppName --settings "$settingName=$value"
}

执行脚本时write-host输出正常：

Setting mysetting for myapp to @Microsoft.KeyVault(SecretUri=https://mykv.vault.azure.net/secrets/ServiceBusConnectionString/)

但通过Azure门户查看插入的配置值时，发现尾随的右括号被截断，显示内容为：

@Microsoft.KeyVault(SecretUri=https://mykv.vault.azure.net/secrets/ServiceBusConnectionString/

原因分析 #

PowerShell会将括号视为命令表达式的分隔符，当直接把包含括号的字符串传递给az命令时，右括号会被解析为表达式结束标记，导致最终传递给Azure CLI的内容丢失了右括号。

解决方法 #

需要对包含特殊字符的配置值进行引号转义，确保PowerShell不解析括号这类特殊符号，以下是三种可行方案：

方案1：用单引号包裹配置值 #

修改az命令的--settings参数，用单引号包裹整个键值对，避免PowerShell解析内部括号：

az functionapp config appsettings set --resource-group $rg --name $functionAppName --settings '$settingName=$value'

方案2：转义右括号 #

在拼接$value时，用PowerShell的反引号 对右括号进行转义：

if ($value -match '^https://.*\.vault\.azure\.net/secrets/.*') {
    $value = "@Microsoft.KeyVault(SecretUri=$value`)"
}

方案3：使用--%停止PowerShell解析 #

在az命令前添加--%，让PowerShell直接将后续参数原封不动传递给Azure CLI：

az --% functionapp config appsettings set --resource-group $rg --name $functionAppName --settings "$settingName=$value"

优先推荐方案1，单引号包裹的方式直观且不易出错，能确保完整的配置值被传递到Azure服务端。

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