---
title: Exchange Online 通过 PowerShell 管理诉讼保留
description: 面向企业 IT 运维，介绍在 Exchange Online 中使用 PowerShell 启用、查询与移除诉讼保留（Litigation Hold）的通用方法，涵盖适用场景、权限与许可准备、风险提示、批量操作、验证方式、回退建议及常见问题，所有环境参数以占位符表示。
url: "https://www.lanever.com/docs/exchange-online-%e9%80%9a%e8%bf%87-powershell-%e7%ae%a1%e7%90%86%e8%af%89%e8%ae%bc%e4%bf%9d%e7%95%99/"
updated: "2026-10-12"
category: Exchange
---

# Exchange Online 通过 PowerShell 管理诉讼保留

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

## 适用场景

诉讼保留（Litigation Hold）用于在邮箱中保留被用户删除的邮件、日历等项目，保留内容存放在“可恢复项目”文件夹中，可由管理员检索。适用于合规调查、法律取证、离职人员邮箱保全等场景。启用后，删除操作不会真正清除数据，保留期限可按需设置。

该功能依赖 Exchange Online 相应许可与角色权限。不同许可与版本对功能支持存在差异，具体请查阅对应版本官方文档确认。

## 准备与风险

- 确认账号具备管理邮箱的相应角色权限，例如收件人管理相关角色。
- 确认目标邮箱许可支持诉讼保留，避免对不支持的对象执行操作。
- 先在测试环境验证命令，再对生产邮箱执行。
- 批量操作前导出当前邮箱保留状态清单，作为回退依据。
- 诉讼保留会长期占用存储配额，需评估容量影响。
- 移除保留前必须确认合规与法律要求，误移除可能导致数据按策略被清除。

> 破坏性操作前务必完成备份与测试环境验证，并保留可回退的状态记录。

## 处理步骤

### 1. 建立远程会话

使用 Exchange Online PowerShell 模块连接，命令形式如下，参数以占位符表示：

```
Connect-ExchangeOnline -UserPrincipalName [管理员账号]
```

若使用较旧的远程会话方式，请参考对应版本官方文档中的连接方法。

### 2. 对单个邮箱启用保留

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

如需指定保留期限（单位：天），可追加参数：

```
Set-Mailbox -Identity [邮箱标识] -LitigationHoldEnabled $true -LitigationHoldDuration [天数]
```

### 3. 批量启用

按收件人类型批量启用：

```
Get-Mailbox -ResultSize Unlimited -Filter {RecipientTypeDetails -eq "UserMailbox"} | Set-Mailbox -LitigationHoldEnabled $true
```

按部门等属性筛选：

```
Get-Recipient -RecipientTypeDetails UserMailbox -ResultSize Unlimited -Filter '(Department -eq "[部门名称]")' | Set-Mailbox -LitigationHoldEnabled $true
```

仅对尚未启用保留的邮箱操作：

```
Get-Mailbox | Where {$_.LitigationHoldEnabled -match "False"} | ForEach-Object { Set-Mailbox -Identity $_.Alias -LitigationHoldEnabled $true }
```

### 4. 查询保留状态

```
Get-Mailbox -Identity [邮箱标识] | Format-List LitigationHold*
```

```
Get-Mailbox -ResultSize Unlimited | Format-List Name,LitigationHold*
```

查看已启用保留邮箱的可恢复项目文件夹大小：

```
Get-Mailbox -ResultSize Unlimited -Filter {LitigationHoldEnabled -eq $true} | Get-MailboxFolderStatistics -FolderScope RecoverableItems | Format-Table Identity,FolderAndSubfolderSize -Auto
```

### 5. 移除保留

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

移除后，保留策略不再阻止数据清除，操作前请再次确认合规要求。

## 验证方法

- 使用查询命令确认目标邮箱的 LitigationHoldEnabled 与 LitigationHoldDuration 值符合预期。
- 在测试邮箱中删除一封邮件，确认其进入可恢复项目并可按保留策略检索。
- 批量操作后抽样核对若干邮箱状态，避免遗漏或误启用。

## 回退建议

- 保留启用状态清单，记录操作前后各邮箱的保留参数。
- 如需撤销，对相应邮箱执行移除保留命令，并核对结果。
- 移除保留后数据是否被清除取决于保留策略与时间，无法保证恢复，操作前应完成必要导出。

## 常见问题

- 命令报权限不足：检查管理员角色分配与连接会话是否正确。
- 部分邮箱无法启用：确认其许可与收件人类型是否支持该功能。
- 保留期限未生效：核对参数单位与取值范围，参考对应版本官方文档。
- 存储增长过快：评估保留范围与期限，必要时调整策略。
