参考来源与致谢
- 引用来源:Get-MailboxRepairRequest
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
本地部署的 Exchange Server 2016 环境中,邮箱可能因存储层异常出现损坏。运维人员通常先用 New-MailboxRepairRequest 创建修复请求,再由系统检测并修复损坏项。修复请求创建后处于排队或运行状态,需要持续跟踪进度与结果,此时使用 Get-MailboxRepairRequest 查看请求详情。
该命令仅适用于本地 Exchange Server 2016,其他版本是否支持请查阅对应版本的官方文档。它只读取修复请求信息,不修改邮箱数据,属于查询类操作。
准备与风险 #
- 确认已具备查看邮箱修复请求所需的权限。具体权限条目请查阅对应版本的官方权限文档。
- 明确要查询的对象:单个邮箱、指定数据库,还是某个修复请求标识。
- 查询本身不具破坏性,但不要在同一时间对同一数据库反复创建修复请求,以免增加存储与服务器负载。
- 若后续需要执行修复或删除请求等变更操作,务必先在测试环境验证,并对受影响数据库做好备份,确认可回退后再操作。
- 参数中的服务器地址、账号等一律使用占位符,例如
[服务器地址]、[管理员账号],不要在生产文档中写入真实值。
处理步骤 #
1. 连接环境 #
在装有 Exchange 管理工具的服务器上打开 Exchange 命令行管理程序,使用具备相应权限的账号连接本地环境。
2. 按邮箱查询 #
使用 Mailbox 参数查看指定邮箱的修复请求。该参数支持 GUID、DN、域账号、UPN、LegacyExchangeDN、SMTP 地址、别名等形式。
Get-MailboxRepairRequest -Mailbox [邮箱标识] | Format-List
若修复请求创建时包含关联的存档邮箱,可加 Archive 参数查看存档邮箱信息;不加则只返回主邮箱信息。
3. 按数据库查询 #
使用 Database 参数可查看指定数据库上所有邮箱的修复请求。该参数与 Mailbox 参数不能同时使用。
Get-MailboxRepairRequest -Database [数据库名称或GUID] | Format-List
如需按存储邮箱 GUID 精确定位,可结合 StoreMailbox 参数:
$stats = Get-MailboxStatistics [邮箱标识]
Get-MailboxRepairRequest -Database $stats.Database -StoreMailbox $stats.MailboxGuid | Format-List Identity
4. 按请求标识查询 #
修复请求由复合 GUID 标识,格式为 <DatabaseGuid><RequestGuid><JobGuid>。已知标识时可直接查询:
Get-MailboxRepairRequest -Identity [请求标识] | Format-List
加 Detailed 参数可显示与请求关联的邮箱级修复任务。
5. 批量列出 #
需要总览时,可先列出数据库再逐条查询,仅取 Identity 属性便于后续定位:
Get-MailboxDatabase | Get-MailboxRepairRequest | Format-Table Identity
验证方法 #
返回结果通常包含以下信息,可据此判断修复请求状态:
- 邮箱 GUID。
- 创建请求时指定的损坏类型。
- 完成百分比形式的进度。
- 检测到并已修复的损坏数量。
- 状态值:
Queued、Running、Succeeded、Failed。 - 请求的创建时间与完成时间。
状态为 Succeeded 表示请求已完成;Failed 需结合事件日志与详细输出进一步排查。若进度长时间不变,检查服务器负载与存储状态。
回退建议 #
查询操作不改变数据,无需回退。若在排查过程中执行了创建或删除修复请求等变更操作,应依据变更前的备份与记录恢复:先在测试环境复现,再评估生产影响;必要时从数据库备份还原,并核对邮箱可访问性。
常见问题 #
- 命令不可用:确认当前环境为本地 Exchange Server 2016,该命令不适用于其他部署形态。
- 参数冲突:
Database与Mailbox互斥,Archive也不能与Database同用。 - 查不到请求:核对邮箱标识或请求标识是否正确,确认请求是否已创建成功。
- 需要指定域控制器:可用
DomainController参数指定 FQDN,例如[域控制器FQDN]。 - 权限不足:部分参数可能因权限未授予而不可用,请查阅对应版本的权限文档。
提示:不同版本对命令与参数的支持范围可能不同,实际使用前请查阅对应版本的官方文档,并以官方说明为准。
