本地PowerShell ISE正常的Connect-AzAccount脚本在DevOps流水线报错求解决

核心原因 #

流水线使用的Agent环境未安装Az PowerShell模块，而你的本地环境已预装或手动安装了该模块，因此本地可正常运行。

具体修改步骤 #

1. 在流水线中添加Az模块安装步骤 #

在执行你的认证脚本前，先新增PowerShell任务安装所需的Az模块（微软托管Agent每次运行都是干净环境，必须重复安装；自托管Agent可一次性安装后跳过此步骤）。

示例安装脚本：

# 安装包含Connect-AzAccount的Az.Accounts模块，如需完整Az套件可替换为Az模块
Install-Module -Name Az.Accounts -Force -AllowClobber -Scope CurrentUser
# 安装全量Az模块的命令：
# Install-Module -Name Az -Force -AllowClobber -Scope CurrentUser

2. 优化敏感信息存储（推荐） #

不要在脚本中明文写入凭据，改用流水线的秘密变量存储敏感信息：

• 将AzureTenantId、AzureApplicationId、AzureApplicationSecret设置为流水线秘密变量
• 脚本中通过环境变量调用：

$AzureTenantId = $env:AzureTenantId
$AzureApplicationId = $env:AzureApplicationId
$AzureApplicationSecret = $env:AzureApplicationSecret

$SecuredApplicationSecret = ConvertTo-SecureString $AzureApplicationSecret -AsPlainText -Force
$psCred = New-Object System.Management.Automation.PSCredential($AzureApplicationId, $SecuredApplicationSecret)
Connect-AzAccount -Credential $psCred -TenantId $AzureTenantId -ServicePrincipal

3. 指定PowerShell版本（可选） #

部分旧版PowerShell对Az模块兼容性较差，可在流水线的PowerShell任务中指定使用PowerShell 7（Core版本），提升稳定性。

验证流程 #

1. 先执行模块安装任务，确认模块安装成功
2. 再运行认证脚本，检查Azure账号连接状态

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