参考来源与致谢
- 引用来源:Office 365: Script to Turn on Litigation Hold – ePhams
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
诉讼保留(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的写法差异。 - 连接失败:检查网络、代理、认证方式与连接地址是否正确。
- 存储增长明显:诉讼保留会持续保留数据,应评估容量并规划归档或保留策略。
- 与保留策略冲突:诉讼保留与保留策略、保留标签的交互较复杂,具体行为请查阅对应版本官方文档。
