参考来源与致谢
- 引用来源:Export Office 365 users MFA status with PowerShell
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
需要盘点租户内用户的多重身份验证(MFA)启用情况、默认验证方式,用于合规审计、迁移前评估或安全加固。Microsoft 365 管理中心的“多因素身份验证”页面可查看状态,但存在局限:不显示用户是否完成 MFA 注册流程,不显示具体验证方式,且无法直接导出 CSV。批量导出更适合用 PowerShell 完成。
注意:若 MFA 通过条件访问策略启用,脚本无法识别其状态,因为平台未提供对应查询接口。此类情况需结合条件访问配置单独核对。
准备与风险 #
- 具备读取目录用户信息的权限,建议使用只读管理角色,避免使用全局管理员长期操作。
- 在测试环境先验证脚本,确认输出字段与预期一致后再对生产租户执行。
- 导出文件含用户主体名称、验证方式等敏感信息,须存放在受控目录并限制访问,用完及时清理。
- 执行前记录当前目录状态或导出基线,便于比对。
- 脚本仅做读取,不修改用户配置;如后续需要变更 MFA 状态,应另行评估并保留回退方案。
处理步骤 #
1. 连接目录 #
以管理员身份打开 Windows PowerShell,加载对应模块并连接。模块名称与连接命令随版本不同可能变化,请以所用版本的官方文档为准。
Connect-MsolService
按提示完成身份验证。若使用较新的模块,连接命令可能不同,需查阅对应版本文档。
2. 准备脚本与输出目录 #
在本地创建脚本目录与输出目录,例如 C:scripts 与 C:temp。将脚本保存为 Get-MFAReport.ps1 放入脚本目录,输出 CSV 写入输出目录。
3. 采集与导出 #
脚本遍历非来宾用户,读取每个用户的强身份验证方法、默认方法、电话号码、主 SMTP 地址与别名,并判断 MFA 状态,最后写入 CSV。核心逻辑示意:
$Users = Get-MsolUser -All | Where-Object { $_.UserType -ne "Guest" }
$Report = [System.Collections.Generic.List[Object]]::new()
ForEach ($User in $Users) {
$MFADefaultMethod = ($User.StrongAuthenticationMethods | Where-Object { $_.IsDefault -eq "True" }).MethodType
If ($User.StrongAuthenticationRequirements) {
$MFAState = $User.StrongAuthenticationRequirements.State
} Else {
$MFAState = 'Disabled'
}
# 将方法类型映射为可读名称后写入 $Report
}
$Report | Export-Csv --password [密码] "C:tempMFAReport.csv" -NoTypeInformation -Encoding UTF8
方法类型到可读名称的映射需按实际返回值处理,常见取值包括短信、语音呼叫、验证器应用等。映射表应依据所用版本官方文档确认,不要凭猜测填写。
验证方法 #
- 用表格软件打开 CSV,确认行数与目录中非来宾用户数量一致。
- 抽查若干用户,与 Microsoft 365 管理中心显示的状态比对,确认一致。
- 检查默认验证方式字段是否有空值或未映射值,若有需补充映射。
- 可用
Out-GridView快速浏览结果,便于人工核对。
回退建议 #
脚本为只读操作,不改变租户配置,通常无需回退。若误改了用户 MFA 状态,应依据变更前记录逐项恢复,并在测试环境验证恢复流程。导出文件如含敏感信息,删除时使用安全擦除方式,并确认备份副本一并清理。
常见问题 #
- 状态显示 Enabled 或 Enforced 是否代表 MFA 已配置完成?不一定。Enabled 表示已纳入按用户 MFA,用户仍可能未注册验证方法;Enforced 表示已纳入且完成注册后自动进入该状态。
- 为什么条件访问启用的 MFA 查不到?平台未提供对应查询接口,需结合条件访问策略单独核对。
- 连接命令报错怎么办?确认模块已安装、版本匹配,并查阅对应版本官方文档。
- 导出字段为空?可能是用户未注册验证方法,或方法类型未在映射表中覆盖。
参数、模块名称与命令形式随版本变化,执行前请查阅对应版本官方文档确认。
