Azure Pipeline PowerShell任务中Azure CLI无法识别的问题咨询

问题概述 #

Windows Server代理已安装Azure CLI，本地cmd/PowerShell可正常调用，但Azure Pipeline的PowerShell任务执行az命令时提示'az' 未被识别为内部或外部命令，已检查Path环境变量和Pipeline变量仍未解决。

解决方案 #

1. 直接指定Azure CLI完整路径 #

找到代理服务器上Azure CLI的安装路径（常见路径为C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin或C:\Program Files\Microsoft SDKs\Azure\CLI2\wbin），在任务中用完整路径调用az.cmd：

- powershell: |
        echo "*********" | "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin\az.cmd" devops login --organization https://dev.azure.com/*****
  displayName: 'Login on Azure CLI'

2. 手动为PowerShell会话添加Path变量 #

Pipeline的PowerShell会话可能未加载系统用户的Path配置，手动将Azure CLI路径添加到当前会话的环境变量：

- powershell: |
        $env:Path += ";C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin"
        echo "*********" | az devops login --organization https://dev.azure.com/*****
  displayName: 'Login on Azure CLI'

3. 检查代理服务的启动账户 #

Azure Pipeline代理若使用本地系统账户或非你登录的用户账户运行，该账户的Path变量可能未包含Azure CLI路径：

• 打开服务管理器，找到Azure Pipeline代理服务，查看其登录账户
• 切换到该账户登录服务器，更新其用户或系统级Path变量
• 重启Azure Pipeline代理服务

4. 使用Azure Pipeline内置的Azure CLI任务 #

Pipeline提供专门的Azure CLI任务，会自动处理环境变量和路径依赖，无需手动配置：

- task: AzureCLI@2
  inputs:
    azureSubscription: '<你的Azure服务连接名称>'
    scriptType: 'pscore'
    scriptLocation: 'inlineScript'
    inlineScript: |
        echo "*********" | az devops login --organization https://dev.azure.com/*****
  displayName: 'Login on Azure CLI'

额外提示 #

原任务代码中displayName的引号未闭合，需修正为displayName: 'Login on Azure CLI'，避免任务配置解析错误。

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