Azure DevOps自托管Agent报错：找不到AzureCloud环境

排查及修复方案 #

• 确认环境名称有效性
  在自托管Agent机器上执行Get-AzEnvironment命令，查看返回列表中是否存在AzureCloud。若不存在，说明Az模块存在异常，需彻底卸载重装：

  # 卸载所有Az模块版本
  Get-Module -ListAvailable Az* | Uninstall-Module -Force -AllVersions
  # 重新安装最新版Az模块
  Install-Module -Name Az -AllowClobber -Scope CurrentUser -Force
  

• 检查Agent网络访问能力
  自托管Agent所在机器可能无法访问AzureCloud对应的服务端点，手动测试访问https://management.azure.com（AzureCloud的ARM端点）：

  • 若无法访问，排查防火墙规则，确保允许访问Azure相关域名
  • 若使用代理，在PowerShell中配置代理后再尝试连接：

    [System.Net.WebRequest]::DefaultWebProxy = new-object System.Net.WebProxy('http://你的代理地址:端口')
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    

  也可在Azure DevOps Agent的配置文件（.agent文件）中添加全局代理设置。

• 验证服务主体与租户关联
  确保使用的服务主体属于目标租户，且该租户默认关联的是AzureCloud环境。在能正常连接的场景下（去掉-Environment参数）执行Get-AzContext，查看返回的环境是否为AzureCloud，若不是则需确认租户所属云环境是否正确。

• 通过环境对象指定连接
  若直接使用环境名称报错，尝试先获取环境对象再传入参数：

  $azureEnv = Get-AzEnvironment -Name AzureCloud
  $azureAccount = Connect-AzAccount -ServicePrincipal -Tenant $tenantId -Credential $psCredential -Environment $azureEnv
  

• 检查Agent运行身份权限
  尝试以管理员身份启动自托管Agent服务，或给Agent运行账户赋予本地Az模块安装目录的读取权限，避免因权限不足导致环境配置读取失败。

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