了解 Exchange 统一消息疑难解答工具

适用于：Exchange Server 2013、Exchange Server 2016

Microsoft Exchange 2010 统一消息故障排除工具是一个名为 Test-ExchangeUMCallFlow 的 Exchange 命令行管理程序 cmdlet。 可使用该工具对贵组织的统一消息 (UM) 执行一系列诊断测试。 如果有任何测试失败，该工具会报告失败原因以及问题的可能解决方案。 您只能在 Exchange 2010 或更高版本的服务器上使用 UM 故障排除工具。

UM 故障排除工具可用于测试语音邮件在内部部署和跨界部署的环境中是否都能正常运行。 您可以在包括 Microsoft Office Communications Server 2007 R2 或 Microsoft Lync Server 2010 或更高版本的 UM 部署中，或在包括 VoIP 网关、IP 专用交换机 (IP PBX) 或会话边界控制器 (SBC) 的 UM 部署中使用此工具。

概述

UM 故障排除工具可简化 UM 部署中的测试和故障排除。 运行 UM 故障排除工具时，它将自动生成存储在 C：\Users\%UserProfile%\AppData\Roaming\Microsoft Exchange 2010 UM 故障排除文件夹中的一组跟踪文件。 该工具会生成下列跟踪文件：

• UMTool_Collaboration：包括 RTC 堆栈跟踪。
• UMTool_DiagnosticLog：Lists运行的所有测试及其结果。
• UMTool_S4：包括 S4： 信令堆栈跟踪。
• UMTool_SIPMessageLogs：包括所发出的测试调用的完整 SIP 跟踪。

UM 故障排除工具可直接连接到内部部署的会话边界控制器 (SBC)（如果存在），或者连接到数据中心的 SBC 并模拟传入呼叫，就像该呼叫是 PBX 通过 VoIP 网关或 IP PBX 发出的一样。 UM 故障排除工具可用于诊断：

• 部署了 Office Communications Server 2007 R2 或 Microsoft Lync Server 的内部部署或跨界 UM 部署中的不正确设置。
• 包括 VoIP 网关及 PBX 或 IP PBX 的内部部署或跨界电话设备中的不正确设置。
• 域名系统 (DNS) 问题。
• 使用"SIP 安全"或"安全 UM"拨号计划时的证书问题。
• DTMF（也称为按键）和音频的信号及媒体问题。

如果 UM 故障排除工具在配置中检测到故障，该工具会报告错误的原因以及所检测到问题的可能解决方案。 在内部部署中使用 UM 故障排除工具时，可能会报告以下错误：

• 已达到最大呼叫限制。
• 该用户未启用统一消息。
• 无法找到 UM IP 网关、拨号计划或智能寻线信息。
• 安全类型与 UM 拨号计划不匹配。
• 没有可处理呼叫的工作进程。
• UM 服务或 UM 呼叫路由器服务已停止。
• 无法找到 Active Directory 林。
• 没有可用的磁盘空间。
• 请求中使用了无效的 SIP 头。
• 已向 Office Communications Server 2007 R2 服务器或 Lync Server 服务器进行呼叫。
• UM IP 网关已禁用。
• 被叫用户的 URI 无效。

在跨界部署中使用 UM 故障排除工具时，可能会报告以下错误：

• 该用户未启用统一消息。
• UM IP 网关已禁用。
• 该用户的 URI 无效。
• 安全类型与 UM 拨号计划不匹配。
• 请求中使用了无效的 SIP 头。
• 无法找到 UM IP 网关、拨号计划或智能寻线信息。

UM 故障排除工具发送一个时长为 15 秒的示例 .wav 文件。 在发送并播放音频文件和 RTP 音频流之后，该工具会报告用于诊断与网络连接相关的音频质量问题的常规音质指标，如抖动和平均数据包丢失数量。 这些报告包括发往和来自 UM 服务器的媒体流质量及下列项目：

• 网络平均意见得分 (NMOS)
• 编解码器
• 延迟（毫秒）
• 抖动（毫秒）
• 数据包丢失的百分比
• 将使用以下 NMOS 分类和分级来确定音频质量：
  • NMOS 小于 2 = 差
  • NMOS 大于 2 但小于 3 = 一般
  • NMOS 大于 3 但小于 4 = 好
  • NMOS 大于 4 但小于 5 = 极好

UM 故障排除工具支持测试使用"安全"、"SIP 安全"和"不安全"呼叫的 UM 拨号计划。 如果选择"安全"或"SIP 安全"，将检查所用证书的指纹来确定该证书是否过期以及用于 TLS（传输层安全性）通信的证书类型。 该证书用于正确标识及确保远程计算机的标识。 选择"安全"或"SIP 安全"模式后，UM 故障排除工具会确认是否符合下列条件：

• 已在本地计算机存储中找到本地证书。
• 所使用的证书受到信任。
• 证书中指定的目标名称有效。
• 证书已过期。
• 远程计算机信任该证书。
• 证书已被吊销。
• 证书没有所需的增强密钥用法。

UM 故障排除工具可在"网关"或 SIPClient 模式下运行，具体取决于部署的是 Office Communications Server 2007 R2 还是 Lync Server，或者统一消息服务器使用的是 VoIP 网关和 PBX 还是 IP PBX。 当使用"网关"或 SIPClient 模式时，UM 故障排除工具支持使用以下格式进行呼叫。 所使用的格式取决于 UM 拨号计划的 URI 类型：

• 电话分机：425-555-1010
• E.164 电话号码：+1 (425) 555-1010
• SIP 地址： tonysmith@contoso.com

使用 SIPClient 模式时，UM 故障排除工具会呼叫语音备忘录。 在此呼叫中，电话或统一通信 (UC) 终结点不会发出响铃。 而是直接将呼叫发送到语音邮件。 以 SIPClient 模式运行 UM 故障排除工具时，该工具将确定：

• 所呼叫的目标用户。
• SIP 呼叫是否已成功建立。
• SIP 呼叫是否已被 Exchange 2010 统一消息服务器或 Exchange 2013 邮箱服务器接受。
• 接收的 DTMF 序列是否正确。
• Exchange 2010 UM 服务器或 Exchange 2013 邮箱服务器是否已发送和接收诊断 .wav 文件。
• 收到媒体或音频质量流时使用的指标。

UM 故障排除工具将模拟传入呼叫并运行一系列诊断测试，这些测试可帮助内部部署管理员和租户管理员测试呼叫流的呼叫应答并确定配置错误。 尽管可在呼叫应答情形中使用 UM 故障排除工具，但是无法使用其来测试以下类型的呼叫：

• Outlook Voice Access 呼叫，包括访问语音邮件、电子邮件、日历、目录、个人联系人或个人选项的呼叫
• UM 自动助理
• 在电话上播放
• 呼叫应答规则
• 传真
• 提示设置

UM 故障排除体系结构

UM 故障排除工具可帮助您在跨界部署中排查、诊断及修复配置问题，您还可以将其用于内部部署的统一消息部署。 在跨界部署中，此工具还将验证现场 SBC 配置。 管理员可以测试统一消息使用的所有统一消息组件，包括 SBC。

VoIP 网关和 IP PBX 部署

在以下示例中，网关模式被用来测试不包括 Office Communications Server 2007 R2 或 Lync Server 的环境中的呼叫流。 该示例测试电话设备，包括 VoIP 网关、PBX 和 IP PBX 以及统一消息组件。 此示例将 IP 语音 (VoIP) 安全模式设置为"不安全" ，使用 IP 地址 10.1.1.1 作为下一个跃点，并在转换信息中包括分机号码。

Test-ExchangeUMCallFlow -Mode Gateway -VoIPSecurity Unsecured -NextHop 10.1.1.1 -Diversion 12345

Office Communications Server 2007 R2 和 Microsoft Lync Server 部署

设置 SIPClient 模式时，可在包括 Office Communications Server 2007 R2 或 Microsoft Lync Server 的内部部署或跨界部署中使用 UM 故障排除工具。 以下示例使用 SIPClient 模式并在包含 Office Communications Server 2007 R2 或 Lync Server 服务器的环境中采用安全 UM 拨号计划测试呼叫流。 默认情况下，在运行 UM 故障排除工具时，该工具使用当前登录到计算机的用户的凭据。 运行以下示例时，系统将提示您要在运行 UM 故障排除工具时使用的凭据。 有关详细信息，请参阅设置要用于 Exchange UM 疑难解答工具的凭据。

Test-ExchangeUMCallFlow -Mode SIPClient -VoIPSecurity Secured -CallingParty tony@contoso.com -CalledParty david@contoso.com -Credential $get

安装 UM 故障排除工具

可以将 UM 故障排除工具安装在本地统一消息服务器上或运行以下操作系统的其他 64 位计算机上：

• Windows 7 或 Windows 8 操作系统。
• Windows Server 2008 或 Windows Server 2008 R2 操作系统。
• Windows Server 2012 或 Windows Server 2012 R2 操作系统。

如果在 64 位版本的 Windows 7、Windows8，或 64 位版本的 Windows Server 2008 上使用 UM 故障排除工具，必须在安装 UM 故障排除工具之前先安装下列组件：

• Microsoft .NET Framework 3.5 Service Pack 1 (SP1) ：请参阅 Microsoft .NET Framework 3.5 Service Pack 1。

  注意

  如果该工具将在 Windows Vista 或 Windows Server 2008 计算机上运行，请参阅下载 .NET Framework 3.5 SP1。

• Windows 远程管理 (WinRM) 2.0 和 Windows PowerShell 2.0。

• Microsoft Unified Communications Managed API 2.0 Core Runtime (UcmaRuntimeWebDownloadX64.msi)。

Exchange 2010 SP1 DVD、仅包含 Exchange 2010 或 Exchange 2013 安装媒体的下载内容不包括 um 故障排除工具 (Test-ExchangeUMCallFlow cmdlet) 。 但是，可以下载 UM 故障排除工具。

有关详细信息，请参阅安装 Exchange UM 故障排除工具。

Cmdlet 参数

下表显示了可与 Test-ExchangeUMCallFlow cmdlet 一起使用的参数以及这些参数的描述。 还可以使用 Shell 命令 Get-help Test-ExchangeUMCallFlow -detailed 查找可与 Test-ExchangeUMCallFlow cmdlet 配合使用的每个参数的详细信息，以及用法示例。