---
title: 用 PowerShell 导出 Office 365 用户 MFA 状态
description: 面向企业 IT 运维，说明如何用 PowerShell 连接 Azure AD，批量导出 Office 365 用户的 MFA 状态与默认验证方式到 CSV，并给出准备、风险、验证、回退与常见问题。
url: "https://www.lanever.com/docs/%e7%94%a8-powershell-%e5%af%bc%e5%87%ba-office-365-%e7%94%a8%e6%88%b7-mfa-%e7%8a%b6%e6%80%81/"
updated: "2026-10-12"
category: Office365
---

# 用 PowerShell 导出 Office 365 用户 MFA 状态

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Export Office 365 users MFA status with PowerShell](https://www.alitajran.com/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 查不到？平台未提供对应查询接口，需结合条件访问策略单独核对。
- 连接命令报错怎么办？确认模块已安装、版本匹配，并查阅对应版本官方文档。
- 导出字段为空？可能是用户未注册验证方法，或方法类型未在映射表中覆盖。

> 参数、模块名称与命令形式随版本变化，执行前请查阅对应版本官方文档确认。
