参考来源与致谢
- 引用来源:Manage Litigation Hold by using PowerShell | Office 365 – o365info.com
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
诉讼保留(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 值符合预期。
- 在测试邮箱中删除一封邮件,确认其进入可恢复项目并可按保留策略检索。
- 批量操作后抽样核对若干邮箱状态,避免遗漏或误启用。
回退建议 #
- 保留启用状态清单,记录操作前后各邮箱的保留参数。
- 如需撤销,对相应邮箱执行移除保留命令,并核对结果。
- 移除保留后数据是否被清除取决于保留策略与时间,无法保证恢复,操作前应完成必要导出。
常见问题 #
- 命令报权限不足:检查管理员角色分配与连接会话是否正确。
- 部分邮箱无法启用:确认其许可与收件人类型是否支持该功能。
- 保留期限未生效:核对参数单位与取值范围,参考对应版本官方文档。
- 存储增长过快:评估保留范围与期限,必要时调整策略。
