Azure DevOps Pipeline中jq命令执行失败：$test未定义错误

你在Azure DevOps Pipeline的AzureCLI@2任务（使用PowerShell Core）中执行jq命令时遇到$test is not defined错误，但该命令在Azure Portal CLI中能正常运行，核心原因是PowerShell Core与jq的变量解析逻辑冲突。

问题根源 #

本地运行时，PowerShell会先解析双引号中的$test变量，将实际值传入jq，所以命令正常。但在Pipeline的inlineScript中：

• 如果用单引号包裹jq表达式，PowerShell不会解析$test，jq会把$test当成自身未定义的变量，触发报错；
• 如果用双引号，PowerShell的变量解析和jq的语法会出现冲突，同样导致异常。

解决方案 #

方法一：用jq的--arg参数传递变量（推荐，更稳妥） #

通过--arg参数将PowerShell变量传递给jq，在jq表达式中直接引用该变量即可：

- task: AzureCLI@2
  inputs:
    azureSubscription: $(sub)
    scriptType: 'pscore'
    scriptLocation: 'inlineScript'
    inlineScript: |
       # 可以直接引用Pipeline变量，比如$test = "$(托管标识变量名)"
       $test = "你的托管标识名称"
       az vmss identity show -g group-name -n vmss-name -o json | jq --arg test "$test" '.userAssignedIdentities | with_entries(select(.key | contains($test)))'
    azurePowerShellVersion: 'latestVersion'

方法二：通过PowerShell字符串插值注入变量 #

先构造包含变量的jq表达式字符串，再传递给jq命令：

- task: AzureCLI@2
  inputs:
    azureSubscription: $(sub)
    scriptType: 'pscore'
    scriptLocation: 'inlineScript'
    inlineScript: |
       # 可以直接引用Pipeline变量，比如$test = "$(托管标识变量名)"
       $test = "你的托管标识名称"
       $jqExpr = ".userAssignedIdentities | with_entries(select(.key | contains(`"$test`")))"
       az vmss identity show -g group-name -n vmss-name -o json | jq "$jqExpr"
    azurePowerShellVersion: 'latestVersion'

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