如何从YAML向PowerShell函数传递多参数（Azure DevOps场景）

下面分步骤给出具体实现：

1. 配置YAML文件示例 #

先准备你的配置文件（比如命名为config.yaml），把需要的参数按键值对定义：

apiUrl: "https://your-target-api-endpoint.com/post"
requestBody: |
  {
    "key1": "value1",
    "key2": "long string content here that spans multiple lines without issues",
    "key3": "another long text block"
  }
authToken: "your-long-auth-token-string-here"
param4: "value4"
param5: "value5"
param6: "value6"
param7: "value7"
param8: "value8"

注意长字符串可以用|保留换行格式，避免转义麻烦。

2. Azure DevOps Pipeline YAML 配置 #

在你的Pipeline YAML中，先添加步骤读取配置文件，再调用执行POST请求的PowerShell脚本：

trigger:
- main

pool:
  vmImage: 'ubuntu-latest' # 或 windows-latest，根据你的环境选择

steps:
- task: PowerShell@2
  displayName: '读取配置文件并调用POST函数'
  inputs:
    targetType: 'filePath'
    filePath: '$(System.DefaultWorkingDirectory)/Invoke-PostRequest.ps1'
    arguments: >
      -ApiUrl "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).apiUrl)"
      -RequestBody "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).requestBody)"
      -AuthToken "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).authToken)"
      -Param4 "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).param4)"
      -Param5 "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).param5)"
      -Param6 "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).param6)"
      -Param7 "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).param7)"
      -Param8 "$((Get-Content $(System.DefaultWorkingDirectory)/config.yaml | ConvertFrom-Yaml).param8)"

如果是Windows环境，需要先在Pipeline中安装powershell-yaml模块，可添加前置步骤：

- task: PowerShell@2
  displayName: '安装yaml解析模块'
  inputs:
    targetType: 'inline'
    script: 'Install-Module -Name powershell-yaml -Force -Scope CurrentUser'

3. PowerShell脚本（Invoke-PostRequest.ps1） #

编写带参数的函数，接收Pipeline传递的参数并发起POST请求：

param(
    [string]$ApiUrl,
    [string]$RequestBody,
    [string]$AuthToken,
    [string]$Param4,
    [string]$Param5,
    [string]$Param6,
    [string]$Param7,
    [string]$Param8
)

function Invoke-MyPostRequest {
    param(
        [Parameter(Mandatory=$true)][string]$ApiUrl,
        [Parameter(Mandatory=$true)][string]$RequestBody,
        [Parameter(Mandatory=$true)][string]$AuthToken,
        [Parameter(Mandatory=$true)][string]$Param4,
        [Parameter(Mandatory=$true)][string]$Param5,
        [Parameter(Mandatory=$true)][string]$Param6,
        [Parameter(Mandatory=$true)][string]$Param7,
        [Parameter(Mandatory=$true)][string]$Param8
    )

    # 参数校验示例
    if (-not $ApiUrl.StartsWith("https://")) {
        Write-Error "API URL必须以https://开头"
        exit 1
    }

    # 构造请求头
    $headers = @{
        "Authorization" = "Bearer $AuthToken"
        "Content-Type" = "application/json"
    }

    # 发起POST请求
    try {
        $response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $headers -Body $RequestBody
        Write-Host "请求成功，响应内容："
        $response | ConvertTo-Json -Depth 10
    }
    catch {
        Write-Error "请求失败：$($_.Exception.Message)"
        exit 1
    }
}

# 调用函数
Invoke-MyPostRequest -ApiUrl $ApiUrl -RequestBody $RequestBody -AuthToken $AuthToken -Param4 $Param4 -Param5 $Param5 -Param6 $Param6 -Param7 $Param7 -Param8 $Param8

注意事项 #

• 如果配置文件存放在Git仓库，确保Pipeline能访问到该文件（比如和Pipeline YAML同目录）。
• 敏感参数（如authToken）建议改用Azure DevOps变量组存储，不要明文写在配置文件里，引用方式如下：

  variables:
  - group: YourSecretVariableGroup
  

  然后在PowerShell参数中替换为-AuthToken "$(AuthToken)"。
• 长字符串传递时，务必用双引号包裹，避免空格或特殊字符导致参数截断。

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