Test-UMConnectivity
此 cmdlet 仅适用于本地 Exchange。
使用 Test-UMConnectivity cmdlet 测试统一消息 (UM) 服务器的作。
注意：此 cmdlet 在 Exchange 2010 中效果最佳。 在 Exchange 的更高版本中，此 cmdlet 的功能将替换为托管可用性。 为了获得最佳结果，请使用 Invoke-MonitoringProbe cmdlet 并指定相关的活动监视器探测，而不是使用此 cmdlet。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
TuiLogonSpecific
Test-UMConnectivity
-Phone <String>
-PIN <String>
-TUILogon <Boolean>
-UMDialPlan <UMDialPlanIdParameter>
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
EndToEnd
Test-UMConnectivity
-Phone <String>
-UMIPGateway <UMIPGatewayIdParameter>
[-DiagDtmfDurationInMilisecs <Int32>]
[-DiagDtmfSequence <String>]
[-DiagInitialSilenceInMilisecs <Int32>]
[-DiagInterDtmfDiffGapInMilisecs <String>]
[-DiagInterDtmfGapInMilisecs <Int32>]
[-From <String>]
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
PinReset
Test-UMConnectivity
-ResetPIN <Boolean>
[-Confirm]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TuiLogonGeneral
Test-UMConnectivity
-TUILogonAll <Boolean>
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
LocalLoop
Test-UMConnectivity
[-CallRouter]
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
说明
设计两个诊断测试用于测试邮箱服务器软件（模式 1）的运行情况以及包括连接的电话组件在内的整个系统（模式 2）的运行情况。
Test-UMConnectivity cmdlet 可以用于测试邮箱服务器的运行情况以及相关的连接电话设备。 运行此 cmdlet 并且包括 UMIPGateway 参数时，邮箱服务器将测试统一消息系统完整的端到端运行情况。 此测试包括连接到邮箱服务器的电话组件，例如 IP 网关、专用分支 eXchanges (PBX) 和布线。 如果未指定 UMIPGateway 参数，则邮箱服务器仅测试在服务器上安装和配置的统一消息组件的运行情况。
在内部部署统一消息部署中运行此 cmdlet 时，需要为此 cmdlet 测试的计算机或服务器创建 UM IP 网关对象。 创建 UM IP 网关对象时，必须为其配置完全限定域名 (FQDN)，并且该 FQDN 必须与运行此 cmdlet 的计算机的名称相匹配。
完成此任务后，cmdlet 测试了邮箱服务器和相关电话组件的作。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Test-UMConnectivity
本示例对本地邮箱服务器执行连接测试和运行测试，然后显示 IP 语音 (VoIP) 连接信息。
示例 2
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false
本示例测试本地邮箱服务器是否可以使用不安全的 TCP 连接（而不是安全的相互 TLS 连接），使用电话号码 56780 通过 UM IP 网关 MyUMIPGateway 发出呼叫。
示例 3
Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true
此示例使用 SIP URI 测试 SIP 拨号计划。 此示例可在包含 Lync Server 或 Skype for Business Server 的环境中使用。
参数
-CallRouter
适用：2013 Exchange Server、Exchange Server 2016
CallRouter 开关指定是否测试Microsoft Exchange 统一消息呼叫路由器服务 (前端) 。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CertificateThumbprint
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
CertificateThumbprint 参数指定用于 SIP 安全和安全模式的证书指纹。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。
- 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiagDtmfDurationInMilisecs
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DiagDtmfDurationInMilisecs 参数指定所发送的每个位的持续时间。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiagDtmfSequence
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DiagDtmfSequence 参数指定所发送的位序列。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiagInitialSilenceInMilisecs
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DiagInitialSilenceInMilisecs 参数指定 cmdlet 在发送位序列之前将暂停的时间段（毫秒）。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiagInterDtmfDiffGapInMilisecs
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DiagInterDtmfDiffGapInMilisecs 参数指定是否自定义诊断序列中各位之间的间隔时间。 这是一个逗号分隔的列表，可以接受空条目。 此参数应包含多个值。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiagInterDtmfGapInMilisecs
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DiagInterDtmfGapInMilisecs 参数指定位序列中发送的每个位之间的间隔时间（毫秒）。 此参数包含单个值。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-From
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
From 参数指定发出呼叫的 SIP URI 或 SIP 地址。 仅当使用 Phone 参数时，才会使用它。 默认设置是在使用 Phone 参数时指定的 SIP URI。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ListenPort
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
ListenPort 参数指定要侦听的 IP 端口号。 如果未指定，则将使用 IP 端口 9000。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
MediaSecured 参数指定使用安全 RTP 模式还是 RTP（不安全）模式。
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MonitoringContext
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
MonitoringContext 参数指定是否在结果中添加相关的监视事件和性能计数器。 有效值包含:
- $true：监视事件和性能计数器包含在命令结果中。 通常，在将输出传递到 Microsoft System Center Operations Manager (SCOM) 时，可以在结果中包含监视事件和性能计数器。
- $false：监视事件和性能计数器不包括在命令结果中。 此值为默认值。
参数属性
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Phone
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Phone 参数指定在重定向测试呼叫时使用的电话号码或会话初始协议 (SIP) 统一资源标识符 (URI)。 应当在 PBX 中配置分机号码，才能向 UM 智能寻线转移呼叫。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PIN
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
PIN 参数指定与启用 UM 的邮箱关联的 PIN。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RemotePort
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
RemotePort 参数指定用于呼叫的端口。 如果未指定，则默认情况下端口 5060 用于传输控制协议 (TCP)，5061 用于相互传输层安全 (TLS)。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ResetPIN
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
ResetPIN 参数指定是否为当前站点中的所有测试邮箱生成或重新生成新 PIN。
参数属性
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PinReset
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Secured
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Secured 参数指定是否在 SIP 安全模式下运行测试。
参数属性
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Timeout
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Timeout 参数指定等待测试操作完成的时间长度（秒）。 默认为 600 秒。 不能将此参数的值设置为小于 60 秒。 但是，建议始终将此参数的值配置为大于或等于 60 秒。 此参数的最大值为 1800 秒。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
EndToEnd
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
LocalLoop
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TUILogon
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
TUILogon 参数指定 cmdlet 是否尝试登录到一个或多个启用 UM 的邮箱。 邮箱必须启用 UM，并与运行 Microsoft Exchange 统一消息服务的邮箱服务器所属的 UM 拨号计划相关联。 默认设置是 $false。
参数属性
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TUILogonAll
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
TUILogonAll 参数指定是否尝试连接到当前 Active Directory 站点中的所有测试邮箱。 默认设置是 $false。 必须通过调用 New-TestCasConnectivityUser.ps1 脚本生成所测试的帐户，并且相应的邮箱必须启用 UM 功能。 否则，不采取任何操作。
参数属性
| 类型: | Boolean
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonGeneral
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UMDialPlan
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
UMDialPlan 参数指定要测试的 UM 拨号计划。 该参数必须与 TUILogon 参数一起使用。
参数属性
| 类型: | UMDialPlanIdParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
TuiLogonSpecific
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UMIPGateway
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
UMIPGateway 参数指定用于进行传出测试呼叫的 UM IP 网关或 IP PBX 的名称。
参数属性
| 类型: | UMIPGatewayIdParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EndToEnd
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。