Azure Function App(PowerShell)：'Connect-MgGraph' cmdlet未识别问题求助

问题原因 #

1. 模块导入不完整：Microsoft.Graph是元模块，默认导入时不会加载所有子模块，Connect-MgGraph属于Microsoft.Graph.Authentication子模块，未被自动导入。
2. 认证方式不适用：无参数的Connect-MgGraph是交互式登录，Azure Function作为无交互的服务器环境无法使用这种方式。

解决方案 #

步骤1：修正模块导入与认证逻辑 #

修改run.ps1，明确导入所需子模块，并改用托管身份认证（适配无交互环境）：

using namespace System.Net

param($Request, $TriggerMetadata)

# 导入MS Graph认证及用户操作相关子模块
Import-Module Microsoft.Graph.Authentication
Import-Module Microsoft.Graph.Users

# 使用Function App托管身份完成认证
Connect-MgGraph -Identity

# 获取用户列表（-All:$true确保返回全部结果）
$body = Get-MgUser -All:$true

Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $body
})

步骤2：配置托管身份与权限 #

1. 打开Azure Function App的身份设置，启用系统分配的托管身份。
2. 进入Azure Active Directory的企业应用，找到该Function App对应的托管身份。
3. 为该身份添加应用权限：搜索User.Read.All（根据业务需求调整权限范围），授予权限后完成管理员同意操作。

步骤3：确认托管依赖配置 #

保持requirements.psd1的配置不变，Azure Functions会自动下载并安装指定版本的模块：

@{
    'Microsoft.Graph' = '2.*'
}

额外注意事项 #

• 禁止使用交互式登录：Azure Function运行在无界面环境，无参数的Connect-MgGraph调用必然失败，必须采用托管身份或客户端凭据流（应用权限）。
• 权限需匹配操作：Get-MgUser需要至少User.Read.All的应用权限，委托权限在无用户上下文的Function环境中无法生效。

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