适用场景 #
Exchange 环境在跨版本升级、跨林迁移或邮箱搬迁后,部分账户访问 OWA 时登录失败,页面返回类似 X-OWA-Error: Microsoft.Exchange.Security.Authentication.TokenMungingException 的错误标识。排查后发现这些账户在目录中被识别为链接邮箱(Linked Mailbox),但其实际用途是普通用户邮箱,且 LinkedMasterAccount 属性被错误填充。本文针对该情形给出通用处理流程。
该问题与具体版本号无关,不同 Exchange 版本的行为可能存在差异,涉及具体版本支持范围时请查阅对应版本的官方文档。
原理说明 #
链接邮箱用于资源林与账户林分离的部署模型,邮箱对象通过 LinkedMasterAccount 指向账户林中的主账户。当该属性被意外写入,而环境中并不存在对应的账户林关系时,OWA 在构造身份令牌阶段无法完成账户解析,从而抛出令牌处理异常。将 LinkedMasterAccount 置空后,账户恢复为普通用户邮箱,OWA 登录即可正常进行。
准备与风险 #
- 操作对象为目录中的用户对象属性,属于配置变更,务必先在测试环境验证。
- 执行前记录受影响账户的当前属性值,便于回退。
- 确认账户确实不应为链接邮箱;若环境本身使用资源林模型,禁止执行本操作。
- 使用具备相应管理权限的账户,通过 Exchange 命令行管理程序(EMS)以管理员身份运行。
- 批量操作前先导出账户清单,避免误改范围。
处理步骤 #
- 确认当前属性。执行:
Get-User -Identity "[用户标识]" | Format-List LinkedMasterAccount若输出非空,说明该属性已被填充。
- 记录原值,保存到变更单或本地文件,作为回退依据。
- 清除属性。执行:
Set-User -Identity "[用户标识]" -LinkedMasterAccount $null该命令通常无输出,属正常现象。
- 批量处理时,可先准备仅含用户标识列的 CSV 文件,再通过管道逐条传入,避免手工逐个执行。执行前务必确认 CSV 内容准确。
- 等待目录复制完成。多域或多站点环境中,属性同步需要一定时间,期间结果可能不一致。
验证方法 #
- 再次执行
Get-User -Identity "[用户标识]" | Format-List LinkedMasterAccount,确认输出为空。 - 在邮箱属性中确认邮箱类型已不再显示为链接邮箱。
- 使用受影响账户登录 OWA,确认不再出现令牌处理异常。
- 抽查若干账户,确认未对其他属性造成非预期改动。
回退建议 #
若清除后出现异常,可依据此前记录的原值,将 LinkedMasterAccount 重新设置为原账户标识。回退同样需要等待目录复制生效。若无法确认原值,应从备份或目录还原途径恢复,不要凭猜测填写。
常见问题 #
- 清除后仍报错:先确认目录复制是否完成,再检查账户是否还有其他异常属性。
- 只有部分账户受影响:通常与迁移过程中属性继承或写入逻辑有关,按账户逐一核对。
- 能否直接删除并重建邮箱:不建议,可能造成数据丢失,优先采用属性修正方式。
- 命令无输出是否代表失败:该命令成功执行时通常无输出,以验证步骤的结果为准。
- 生产环境批量执行前,务必在测试环境完整演练并确认回退路径可用。
提示:本文所述命令为通用形式,实际参数名称、可用属性及行为请以所用 Exchange 版本的官方文档为准。
