Azure DevOps任务模板中如何使用多行字符串作为参数？

1. 模板参数正确定义 #

确保步骤模板中itemPattern参数定义为string类型，无需额外限制，让它能接收多行字符串：

parameters:
  - name: itemPattern
    type: string
    default: '**'

2. 保留多行变量的换行符 #

通过PWSH生成多行过滤规则时，直接将完整的多行字符串输出为任务变量，不要手动转义或去除换行：

# PWSH任务中生成多行pattern
$multiLinePattern = @"
**/bin/**
**/logs/*.log
!**/temp/**
"@
Write-Host "##vso[task.setvariable variable=itemPattern;isOutput=true]$multiLinePattern"

调用模板时直接引用输出变量，确保换行符被完整传递：

- template: filteredDownloadArtifact.yml
  parameters:
    itemPattern: ${{ steps.generatePattern.outputs.itemPattern }}

3. 任务中直接传入参数 #

在模板的DownloadPipelineArtifact@2任务里，直接将参数赋值给itemPattern，不需要用引号包裹（Azure DevOps会自动解析多行内容）：

steps:
  - task: DownloadPipelineArtifact@2
    inputs:
      artifact: 'your-target-artifact'
      path: '$(Build.ArtifactStagingDirectory)'
      itemPattern: ${{ parameters.itemPattern }}

4. 验证过滤规则格式 #

确保多行规则符合Azure DevOps的文件匹配规范：

• 每行一个匹配模式
• 排除规则以!开头
• 规则顺序遵循「先包含、后排除」的逻辑

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