Azure DevOps Pipeline中如何将含双引号的文本参数转为PowerShell变量

问题原因 #

你的流水线脚本执行失败，是因为参数text包含双引号时，直接用"${{parameters.text}}"会导致PowerShell语法错误。原参数值test1 " test2会被渲染成：

$messageText = "test1 " test2"

这里中间的双引号提前闭合了字符串，后面的test2"变成了无效语法。

解决方案 #

方法1：用单引号包裹参数引用 #

PowerShell中单引号包裹的字符串会原样保留内容，不会解析内部的双引号：

parameters:
- name: text
  type: string
  default: test1 " test2

steps:
- checkout: none
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
          $messageText = '${{parameters.text}}'

方法2：使用PowerShell Here-String #

如果参数包含换行、多种引号等复杂内容，Here-String是更稳妥的选择，它会完整保留文本格式：

parameters:
- name: text
  type: string
  default: test1 " test2

steps:
- checkout: none
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
          $messageText = @"
${{parameters.text}}
"@

注意Here-String的起始@"和结束"@必须单独占一行，不能有多余空格。

方法3：对双引号进行转义 #

通过Azure DevOps表达式将参数中的双引号替换为PowerShell可识别的转义双引号\"：

parameters:
- name: text
  type: string
  default: test1 " test2

steps:
- checkout: none
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
          $messageText = "${{replace(parameters.text, '"', '\"')}}"

这种方式可以兼容参数中同时存在单引号和双引号的场景。

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