---
title: Exchange Online 批量启用诉讼保留的操作要点
description: 面向企业 IT 运维，说明在 Exchange Online 中批量启用诉讼保留（Litigation Hold）的适用场景、准备与风险、连接会话、筛选目标邮箱、执行与验证、回退建议及常见问题。所有环境参数以中文占位符表示，涉及批量变更前须先备份并在测试环境验证。
url: "https://www.lanever.com/docs/exchange-online-%e6%89%b9%e9%87%8f%e5%90%af%e7%94%a8%e8%af%89%e8%ae%bc%e4%bf%9d%e7%95%99%e7%9a%84%e6%93%8d%e4%bd%9c%e8%a6%81%e7%82%b9/"
updated: "2026-10-12"
category: Exchange
---

# Exchange Online 批量启用诉讼保留的操作要点

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Office 365: Script to Turn on Litigation Hold – ePhams](https://ephams.com/2020/01/office-365-script-to-turn-on-litigation-hold/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

诉讼保留（Litigation Hold）用于在合规调查、法律纠纷或审计要求下，长期保留指定邮箱中的邮件与可恢复项目，防止用户或保留策略提前清除数据。当需要为一批用户邮箱统一开启且不设定自动到期时间时，可通过 Exchange Online PowerShell 批量执行。

该操作面向企业 IT 运维人员。执行前应确认合规要求、保留范围与期限，并明确哪些邮箱属于目标对象。不同租户的权限模型与功能可用性可能不同，具体以对应版本的官方文档为准。

## 准备与风险

- 权限：执行账号需具备相应邮箱管理权限，例如 Recipient Management 或 Organization Management 角色。具体角色名称请查阅当前版本官方文档。
- 环境：建议先在测试租户或测试邮箱验证命令与筛选条件，再对生产环境批量执行。
- 备份：批量变更前导出目标邮箱清单与现有保留状态，便于比对与回退。示例：`Get-Mailbox -ResultSize Unlimited | Export-Csv [导出文件路径] -NoTypeInformation -Encoding UTF8`
- 风险：诉讼保留开启后会持续保留数据，可能显著增加存储占用，并影响用户自行删除数据的预期。请评估存储容量与合规期限。
- 网络：连接 Exchange Online 需可访问对应服务端点，代理或防火墙策略应提前确认。

> 批量变更属于高风险操作。请务必先备份、先在测试环境验证，并准备好回退方案后再对生产环境执行。

## 处理步骤

### 1. 连接 Exchange Online PowerShell

使用管理员账号建立会话。参数中的地址、账号等均以占位符表示，请替换为实际环境值。

```
$UserCredential = Get-Credential [管理员账号]
$Session = New-PSSession -ConfigurationName Microsoft.Exchange `
 -ConnectionUri [Exchange Online PowerShell 连接地址] `
 -Credential $UserCredential -Authentication Basic -AllowRedirection
Import-PSSession $Session -DisableNameChecking
```

若组织已启用新式认证或条件访问，连接方式可能不同，请以官方文档给出的当前推荐方式为准。

### 2. 确认目标邮箱范围

先只读查询，确认将被修改的对象数量与清单。

```
Get-Mailbox -ResultSize Unlimited -Filter "RecipientTypeDetails -eq 'UserMailbox'" |
 Select-Object DisplayName,PrimarySmtpAddress,LitigationHoldEnabled
```

如仅需处理尚未开启的邮箱，可增加筛选条件：

```
Get-Mailbox -ResultSize Unlimited -Filter "RecipientTypeDetails -eq 'UserMailbox' -and LitigationHoldEnabled -eq 'False'" |
 Select-Object DisplayName,PrimarySmtpAddress
```

### 3. 批量开启诉讼保留

确认清单无误后执行。以下命令不设置保留期限，即长期保留。

```
Get-Mailbox -ResultSize Unlimited -Filter "RecipientTypeDetails -eq 'UserMailbox' -and LitigationHoldEnabled -eq 'False'" |
 Set-Mailbox -LitigationHoldEnabled $true
```

如需指定保留期限，应使用对应参数并确认其取值范围，具体请查阅官方文档。执行过程中建议保留输出日志，便于事后审计。

### 4. 关闭会话

```
Remove-PSSession $Session
```

## 验证方法

- 重新查询目标邮箱状态：`Get-Mailbox -ResultSize Unlimited -Filter "LitigationHoldEnabled -eq 'True'" | Select-Object DisplayName,PrimarySmtpAddress`
- 抽查单个邮箱：`Get-Mailbox -Identity [邮箱标识] | Format-List LitigationHoldEnabled,LitigationHoldDuration`
- 在测试邮箱中删除一封邮件，确认其进入可恢复项目而非被立即清除。此验证应在测试环境进行。
- 核对变更前后导出的清单差异，确认无遗漏或误改。

## 回退建议

若误开启或范围有误，可对指定邮箱关闭诉讼保留：

```
Set-Mailbox -Identity [邮箱标识] -LitigationHoldEnabled $false
```

关闭保留不会自动清除已保留的数据，后续是否清理取决于组织的保留策略与合规要求。回退前应确认法律与合规意见，并保留操作记录。批量回退时同样建议先导出清单、先在测试环境验证。

## 常见问题

- 命令报权限不足：确认账号角色与作用域，必要时联系具备相应权限的管理员。
- 筛选结果为空：检查筛选条件拼写与属性值大小写，例如 `False` 与 `$false` 的写法差异。
- 连接失败：检查网络、代理、认证方式与连接地址是否正确。
- 存储增长明显：诉讼保留会持续保留数据，应评估容量并规划归档或保留策略。
- 与保留策略冲突：诉讼保留与保留策略、保留标签的交互较复杂，具体行为请查阅对应版本官方文档。
