参考来源与致谢
- 引用来源:New-MailboxRepairRequest
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
本地部署的 Exchange 环境中,邮箱可能出现搜索文件夹异常、文件夹聚合计数不准、文件夹视图内容显示错误、预置文件夹指向未预置的父文件夹等问题。此时可使用 New-MailboxRepairRequest 对指定邮箱或整个邮箱数据库发起检测与修复请求。该命令仅适用于本地 Exchange,云端版本不适用。
修复对象可以是单个邮箱,也可以是数据库级别。数据库级别修复时,同一时间仅允许一个活动请求;邮箱级别修复时,单台服务器上可同时存在多个活动请求,但存在并发上限。具体上限与版本相关,请查阅对应版本官方文档。
准备与风险 #
- 确认当前账号具备执行邮箱修复请求所需的权限。权限不足时部分参数不可用。
- 明确要处理的损坏类型:
SearchFolder、AggregateCounts、ProvisionedFolder、FolderView。可一次指定多个,用逗号分隔。 - 修复期间仅被修复的邮箱访问会受影响,同数据库其他邮箱保持可用。数据库级别修复同样只中断正在修复的邮箱。
- 请求一旦开始,除非卸载数据库,否则无法停止。执行前应确认时间窗口。
- 建议先在测试环境验证命令与影响范围,并对目标数据库或邮箱做好备份。
- 生产环境执行前,确认数据库副本状态与备份可用性,避免在无回退手段时操作。
处理步骤 #
- 连接本地 Exchange 命令行管理程序,确认目标邮箱或数据库名称。
- 如需先观察不修复,可加
-DetectOnly参数,仅检测并报告。 - 针对单个邮箱修复文件夹视图:
New-MailboxRepairRequest -Mailbox [邮箱地址] -CorruptionType FolderView - 仅检测预置文件夹与搜索文件夹问题:
New-MailboxRepairRequest -Mailbox [邮箱地址] -CorruptionType ProvisionedFolder,SearchFolder -DetectOnly - 针对整个数据库修复聚合计数:
New-MailboxRepairRequest -Database [数据库名称] -CorruptionType AggregateCounts - 同时处理邮箱与存档的多种损坏类型,可加
-Archive:New-MailboxRepairRequest -Mailbox [邮箱地址] -CorruptionType ProvisionedFolder,SearchFolder,AggregateCounts,FolderView -Archive - 如需按存储邮箱精确指定,可先获取邮箱统计信息,再用其数据库与邮箱 GUID 构造请求:
$Mailbox = Get-MailboxStatistics [邮箱地址] New-MailboxRepairRequest -Database $Mailbox.Database -StoreMailbox $Mailbox.MailboxGuid -CorruptionType ProvisionedFolder,SearchFolder,AggregateCounts,FolderView
注意:
-Mailbox与-Database不能同时使用。数据库级别请求同一时间只能有一个处于活动状态。
验证方法 #
- 使用
-DetectOnly先获取检测报告,确认损坏类型与范围。 - 修复完成后,重新检查对应邮箱的搜索文件夹、文件夹视图与计数是否恢复正常。
- 查看修复请求状态与事件日志,确认请求已完成且无异常报错。
- 如问题仍存在,可再次执行检测,确认是否仍有残留损坏。
回退建议 #
- 修复请求开始后无法直接停止,唯一中断方式是卸载对应数据库,此操作影响大,须谨慎评估。
- 若修复导致异常,优先从备份恢复受影响邮箱或数据库,并保留现场日志。
- 生产操作前应在测试环境验证,并确保有可用的数据库副本或备份。
- 卸载数据库属于破坏性操作,执行前必须确认备份可用、影响范围明确,并安排维护窗口。
常见问题 #
- 问:修复会中断整个数据库吗?答:不会,仅被修复的邮箱受影响,其他邮箱保持可用。
- 问:可以同时提交多个数据库级别请求吗?答:不可以,同一时间仅允许一个数据库级别活动请求。
- 问:请求能中途取消吗?答:不能,除非卸载数据库。
- 问:
-Archive作用是什么?答:将修复范围扩展到邮箱的存档。 - 问:参数与权限细节在哪里确认?答:请查阅对应 Exchange 版本的官方文档。
