如何编写含三参数的Invoke-RestMethod脚本并关联参数组合矩阵

如果你需要遍历多个参数的所有可能组合来调用API，可以按照以下步骤实现：

1. 定义参数值矩阵 #

先把每个参数的所有可选值存入数组，替换为你的实际参数值即可：

$param1Options = @("val1-1", "val1-2")
$param2Options = @("val2-1", "val2-2", "val2-3")
$param3Options = @("val3-1")

2. 遍历参数组合并执行API请求 #

使用嵌套循环覆盖所有参数组合，动态构建完整URL并发起请求：

# 基础API地址（不带查询参数）
$baseUri = "https://xxxxxxxx"

foreach ($p1 in $param1Options) {
    foreach ($p2 in $param2Options) {
        foreach ($p3 in $param3Options) {
            # 对参数值做URL编码，避免特殊字符破坏URL结构
            $encodedP1 = [Uri]::EscapeDataString($p1)
            $encodedP2 = [Uri]::EscapeDataString($p2)
            $encodedP3 = [Uri]::EscapeDataString($p3)

            # 拼接完整请求URL
            $fullUri = "$baseUri?parameter1=$encodedP1&parameter2=$encodedP2&parameter3=$encodedP3"

            # 执行API调用并处理结果
            try {
                $response = Invoke-RestMethod -Uri $fullUri -UseDefaultCredentials
                Write-Host "参数组合 [$p1, $p2, $p3] 请求成功"
                # 可根据需求保存结果：$response | Out-File "result_$p1_$p2_$p3.json"
            }
            catch {
                Write-Host "参数组合 [$p1, $p2, $p3] 请求失败: $_"
            }
        }
    }
}

3. 更规范的查询字符串构建方式 #

如果参数较多或需要灵活调整，推荐用System.Web.HttpUtility.ParseQueryString自动处理参数拼接和编码：

# 加载必要程序集
Add-Type -AssemblyName System.Web

$baseUri = "https://xxxxxxxx"

foreach ($p1 in $param1Options) {
    foreach ($p2 in $param2Options) {
        foreach ($p3 in $param3Options) {
            # 创建查询字符串对象
            $queryParams = [System.Web.HttpUtility]::ParseQueryString([String]::Empty)
            $queryParams["parameter1"] = $p1
            $queryParams["parameter2"] = $p2
            $queryParams["parameter3"] = $p3

            # 拼接完整URL
            $fullUri = "$baseUri?$queryParams"

            # 执行请求
            try {
                $response = Invoke-RestMethod -Uri $fullUri -UseDefaultCredentials
                Write-Host "参数组合 [$p1, $p2, $p3] 请求成功"
            }
            catch {
                Write-Host "参数组合 [$p1, $p2, $p3] 请求失败: $_"
            }
        }
    }
}

关键注意事项 #

• URL编码：必须处理参数值中的特殊字符（如空格、&、=），否则会导致请求失效，上述两种方法都能自动完成编码。
• 错误处理：通过try/catch捕获异常，快速定位请求失败的参数组合。
• 扩展性：后续新增参数时，只需添加对应的参数值数组和嵌套循环即可。

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