Azure DevOps管道中使用内置系统变量创建PowerShell变量报错如何解决

错误根因分析 #

• 环境变量语法错误：PowerShell中引用环境变量的正确格式是$env:变量名，你的$env:$BRANCH_NAME/${env}:$BRANCH_NAME写法不符合语法规则，会被解析为错误的驱动变量引用。
• 预制变量判断错误：$(System.PullRequest.PullRequestId)是Azure DevOps的预制变量，非PR触发场景下该值为空，直接写在$()中会被PowerShell识别为待执行的命令，从而触发“未找到命令”报错。

完整修正后的流水线配置 #

修正点说明：

1. 修正了env块的缩进位置，放在powershell任务层级而非脚本内部
2. 判断PR时使用Azure DevOps自动注入的环境变量$env:SYSTEM_PULLREQUEST_PULLREQUESTID，ADO会自动将所有预制变量转换为大写、点替换为下划线的环境变量，无需直接引用$(xxx)格式做判断
3. 修正分支名环境变量引用为$env:BRANCH_NAME
4. 优化URI拼接逻辑，避免特殊字符转义问题

- job:
    pool:
      name: 'POEM-GBT-Agent'
    variables:
    - group: SonarQube
    displayName: 'SonarQube API'
    steps:
    - checkout: none
    - powershell: |
        $token = [System.Text.Encoding]::UTF8.GetBytes("$(SONARQUBE_API_TOKEN)" + ":")
        $base64 = [System.Convert]::ToBase64String($token)
        
        $basicAuth = [string]::Format("Basic {0}", $base64)
        $headers = @{ Authorization = $basicAuth }

        if ($env:SYSTEM_PULLREQUEST_PULLREQUESTID) {
           $param = "pullRequest=$($env:SYSTEM_PULLREQUEST_PULLREQUESTID)"
        }
        else {
          $param = "branch=$($env:BRANCH_NAME)"
        }
        
        $uri = "https://sonarqube.tjx.com/api/qualitygates/project_status?projectKey=$(sonarProjectKey)&$param"
        $result = Invoke-RestMethod -Method Get -Uri $uri -Headers $headers
        $result | ConvertTo-Json | Write-Host
        
        if ($result.projectStatus.status -ne "OK") {
          Write-Host "##vso[task.logissue type=error]Quality Gate Failed"
          Write-Host "##vso[task.complete result=Failed]"
        }
      env:
        BRANCH_NAME: $[replace(variables['Build.SourceBranch'], 'refs/heads/', '')]

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