如何在PowerShell编写的Azure函数HTTP触发器中传递开关参数

问题根因 #

报错核心原因是 $Request.Query 本质是字典类型，Add 是字典内置的方法名，直接用 $Request.Query.Add 读取参数时，返回的是字典的Add方法对象而非你传入的HTTP参数值，类型不匹配导致转换开关参数失败。

修复方案 #

1. 替换开关参数的读取方式，改用字典索引器读取参数，避免命中字典内置方法
2. 补充参数校验逻辑，确保三个操作开关同一时间只有一个生效
3. 调整调用时的参数传值逻辑

修改后的run.ps1参数部分代码 #

param($Request, $TriggerMetadata)
$ErrorActionPreference = 'Stop'

# Write to the Azure Functions log stream.
Write-Host "Function processed a request."

[string]$resourceGroupName = $Request.Query.resourceGroupName ?? $Request.Body.resourceGroupName
[string]$vnetName = $Request.Query.vnetName ?? $Request.Body.vnetName
[string]$loadBalancerName = $Request.Query.loadBalancerName ?? $Request.Body.loadBalancerName
[string]$backendPoolName = $Request.Query.backendPoolName ?? $Request.Body.backendPoolName
[array]$backendIps = $Request.Query.backendIps ?? $Request.Body.backendIps
# GET请求传逗号分隔的IP列表时需补充拆分逻辑
if ($backendIps.Count -eq 1 -and $backendIps[0] -match ',') {
    $backendIps = $backendIps[0] -split ',' | ForEach-Object { $_.Trim() }
}

# 开关参数改用索引器读取，避免命中字典内置方法
[bool]$addVal = [bool]::TryParse(($Request.Query['Add'] ?? $Request.Body['Add']), [ref]$null)
[switch]$Add = $addVal
[bool]$removeVal = [bool]::TryParse(($Request.Query['Remove'] ?? $Request.Body['Remove']), [ref]$null)
[switch]$Remove = $removeVal
[bool]$setVal = [bool]::TryParse(($Request.Query['Set'] ?? $Request.Body['Set']), [ref]$null)
[switch]$Set = $setVal

# 补充操作类型校验
$operationCount = ($Add, $Remove, $Set | Where-Object { $_ }).Count
if ($operationCount -ne 1) {
    Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
        StatusCode = [System.Net.HttpStatusCode]::BadRequest
        Body = "必须且只能指定Add/Remove/Set中的一个操作参数"
    })
    exit
}

调整调用方式 #

GET请求调用时直接传入布尔值，数组类型参数拼接为逗号分隔字符串即可：

$Set = $true
$backendIpsStr = $backendIps -join ','
$iwr = Invoke-WebRequest -Uri "http://localhost:7071/api/modify-lb-backend-pool?resourceGroupName=$resourceGroupName&vnetName=$vnetName&loadBalancerName=$loadBalancerName&backendIps=$backendIpsStr&backendPoolName=$backendPoolName&Set=$Set" -Method Get

如果使用POST请求，直接在请求Body中传入对应键值对即可，示例Body：

{
    "resourceGroupName": "test-rg",
    "loadBalancerName": "test-lb",
    "backendPoolName": "test-pool",
    "backendIps": ["10.0.0.1", "10.0.0.2"],
    "Set": true
}

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