Azure Pipeline中AzureCLI任务JSON参数无法解析环境变量怎么办？

数据老陈

2026-8-3

问题解决：Azure Pipeline中AzureCLI任务的环境变量解析异常

问题根源

你当前的arguments字段中，$($env:servicePrincipalId)被外层复杂的引号嵌套（三重单引号+转义双引号）包裹，导致Azure Pipeline将其识别为纯字符串，而没有传递给PowerShell去解析实际的环境变量值。

解决方案

方案1：将JSON构建逻辑移到PowerShell脚本内（推荐）

把servicePrincipalId作为单独参数传递，在脚本内部构建JSON，彻底避免Pipeline层面的引号和变量解析冲突。

修改Pipeline任务：

- task: AzureCLI@2
  displayName: 'Request information'
  inputs:
    azureSubscription: ${{ parameters.subscriptionId }}
    scriptType: pscore
    scriptPath: ${{ parameters.folderName }}/Req-Info.ps1
    arguments: "-urlPath '/api/manageaad/groups/$(groupId)/addowners' -ownerObjectId '$($env:servicePrincipalId)' -urlResource '${{parameters.urlResource}}'"
    addSpnToEnvironment: true

在Req-Info.ps1中添加参数并构建JSON：

param(
    [string]$urlPath,
    [string]$ownerObjectId,
    [string]$urlResource
)

# 直接在脚本内构建JSON，避免外部解析问题
$jsonBody = @{
    owner_object_ids = $ownerObjectId
} | ConvertTo-Json

# 后续使用$jsonBody执行请求逻辑

方案2：调整Pipeline的引号结构

如果必须在Pipeline层面构建JSON，可简化引号嵌套，让PowerShell能正确解析环境变量：

- task: AzureCLI@2
  displayName: 'Request information'
  inputs:
    azureSubscription: ${{ parameters.subscriptionId }}
    scriptType: pscore
    scriptPath: ${{ parameters.folderName }}/Req-Info.ps1
    arguments: "-urlPath '/api/manageaad/groups/$(groupId)/addowners' -jsonBody '{\"owner_object_ids\": \"$env:servicePrincipalId\"}' -urlResource '${{parameters.urlResource}}'"
    addSpnToEnvironment: true

这种方式通过减少引号层级，让$env:servicePrincipalId直接暴露给PowerShell解析，但需注意转义符的正确使用，维护成本较高。