Azure DevOps中PowerShell执行Connect-AzureAD报命令无法识别问题

该报错与权限不足无直接关联，核心诱因按发生概率排序：

• AzureAD/AzureADPreview模块已于2024年3月正式停止维护，Azure DevOps官方托管代理镜像已默认移除该模块预装，新镜像仅内置Microsoft Graph系列模块
• 脚本中Install-Module/Import-Module步骤未生效，通常由三类问题导致：PowerShell会话运行在PowerShell 7（pwsh）环境但AzureAD模块仅兼容Windows PowerShell 5.1、模块安装路径未纳入当前会话PSModulePath、执行策略拦截模块加载但未输出可见报错
• 若使用内置Azure PowerShell任务，任务默认初始化的上下文仅适配Az模块，不会自动加载AzureAD模块依赖

方案1：迁移至Microsoft Graph模块（官方推荐，长期可用） #

AzureAD模块已停止所有更新，所有Connect-AzureAD相关逻辑均可替换为Microsoft Graph模块实现，Azure DevOps托管代理默认预装该模块，不存在命令识别问题：

1. 将原有AzureAD系列命令替换为对应Microsoft Graph命令，连接逻辑可直接复用Az模块已登录上下文，无需额外传入凭据：

# 自托管代理需先执行模块安装，托管代理可跳过该步骤
Install-Module Microsoft.Graph -Scope CurrentUser -Force -AllowClobber
# 复用Az上下文生成访问令牌连接Graph
Connect-MgGraph -AccessToken (Get-AzAccessToken -ResourceTypeName MSGraph).Token

2. 若使用Azure DevOps内置Azure PowerShell任务，脚本类型可选择适配当前Graph模块版本的PowerShell版本即可，无需额外配置模块导入逻辑。

方案2：AzureAD模块兼容方案（仅作临时过渡使用） #

若短期内无法完成脚本迁移，按以下规则调整流水线配置，注意不要将模块安装逻辑与业务执行逻辑拆分为独立PowerShell任务：

1. 任务运行环境必须选择Windows PowerShell 5.1（即powershell.exe），不可使用PowerShell 7（pwsh）或Linux/macOS代理，AzureAD模块仅支持Windows下的PowerShell 5.1环境
2. 将模块安装、导入、业务执行的代码放在同一个PowerShell脚本块内，指定当前用户安装范围（无需管理员权限），强制绕过执行策略加载：

# 强制启用TLS 1.2，避免模块下载失败
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
# 安装AzureAD模块
Install-Module AzureAD -Scope CurrentUser -Force -AllowClobber -Repository PSGallery
# 显式强制导入模块
Import-Module AzureAD -Force
# 复用Az上下文连接AzureAD
$aadToken = Get-AzAccessToken -ResourceUrl "https://graph.windows.net"
Connect-AzureAD -AadAccessToken $aadToken.Token -AccountId $aadToken.UserId -TenantId (Get-AzContext).Tenant.Id

3. 若使用自托管代理，检查代理运行账号的PSModulePath是否包含当前用户模块路径，未包含则在脚本开头手动添加：

$currentUserModulePath = Join-Path $env:USERPROFILE "Documents\WindowsPowerShell\Modules"
if ($env:PSModulePath -notlike "*$currentUserModulePath*") {
    $env:PSModulePath += ";$currentUserModulePath"
}

• 不要将Install-Module放在独立的PowerShell任务中执行：Azure DevOps每个PowerShell任务启动独立进程会话，前序任务安装的模块不会同步到后续任务的会话环境，这是添加安装命令后依然报命令找不到的最常见原因
• 不要在Linux/macOS代理上运行AzureAD模块相关命令，该模块无跨平台支持版本
• 若安装模块时提示找不到PSGallery源，先执行Register-PSRepository -Default初始化默认源后再执行安装操作

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