Azure DevOps YAML中声明字符串列表变量并传递给PowerShell任务

Azure DevOps管道变量本身仅支持字符串类型，无法直接声明数组/列表，以下是几种可行的实现方案及代码示例：

方案1：逗号分隔字符串变量（最常用） #

将列表项用逗号拼接成单个字符串变量，在PowerShell任务中拆分转为数组：

变量声明 #

variables:
  myStringList: 'Item1,Item2,Item3'

PowerShell任务调用 #

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      # 拆分字符串并去除多余空格
      $myList = $(myStringList) -split ',' | ForEach-Object { $_.Trim() }
      # 遍历处理列表项
      foreach ($item in $myList) {
          Write-Host "Processing: $item"
      }

方案2：多行字符串变量（适配含逗号的列表项） #

如果列表项本身包含逗号，改用换行分隔列表，避免拆分错误：

变量声明 #

variables:
  myStringList: |
    Item with comma, example
    Second item
    Third item

PowerShell任务调用 #

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      # 按换行拆分，过滤空行并去除首尾空格
      $myList = $(myStringList) -split "`n" | Where-Object { $_ -notmatch '^\s*$' } | ForEach-Object { $_.Trim() }
      foreach ($item in $myList) {
          Write-Host "Processing: $item"
      }

方案3：管道参数（适合固定全局列表） #

如果列表是管道的固定配置而非动态变量，可直接用parameters声明数组类型，无需额外拆分：

参数声明 #

parameters:
  - name: myStringList
    type: string[]
    default: ['Item1', 'Item2', 'Item3']

PowerShell任务调用 #

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      foreach ($item in ${{ parameters.myStringList }}) {
          Write-Host "Processing: $item"
      }

方案4：变量组（跨管道复用） #

若需在多个管道间复用列表，可将逗号分隔的字符串存入变量组，再在管道中引用：

1. 在Azure DevOps门户创建变量组，添加变量myStringList，值为Item1,Item2,Item3
2. 管道中引用变量组并处理：

variables:
- group: MySharedVariableGroup

steps:
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $myList = $(myStringList) -split ',' | ForEach-Object { $_.Trim() }
      foreach ($item in $myList) {
          Write-Host "Processing: $item"
      }

常见错误说明 #

直接在变量区使用数组语法（如myList: ['a','b']）会被Azure DevOps解析为字符串而非数组，传递给PowerShell时需要手动转JSON：

$myList = $(myList) | ConvertFrom-Json

但这种方式易因列表项含特殊字符（如引号）导致解析失败，不如上述方案可靠。

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