Test-UMConnectivity (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-10-02
Test-UMConnectivity cmdlet 可以用于测试安装了统一消息服务器角色的计算机的运行情况。
语法
test-UMConnectivity [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -ResetPIN <$true | $false> [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -TUILogonAll <$true | $false> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
详细说明
设计两个诊断测试用于测试 Microsoft Exchange Server 2007 统一消息服务器软件（模式 1）的运行情况以及包括连接的电话组件在内的整个系统（模式 2）的运行情况。
Test-UMConnectivity cmdlet 可以用于测试统一消息 (UM) 服务器的运行情况以及相关的连接电话设备。当管理员运行此 cmdlet 并且包括 IPGateway 参数时，统一消息服务器测试 UM 系统完整的端到端运行情况。这包括连接到统一消息服务器的电话组件，如 IP 网关、专用交换机 (PBX) 和电缆。如果未指定 IPGateway 参数，统一消息服务器将仅测试服务器上安装和配置的 UM 组件的运行情况。
若要运行 Test-UMConnectivity cmdlet，必须为您使用的帐户委派以下角色：
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Phone |
必需 |
System.String |
此参数指定在测试呼叫被重定向时将使用的电话号码。应当在 PBX 中配置分机号码，才能转移呼叫 UM 智能寻线。 |
PIN |
必需 |
System.String |
此参数可以指定与已启用 UM 的邮箱关联的 PIN。 |
TUILogon |
必需 |
System.Boolean |
此参数指定您是否希望 cmdlet 尝试登录到一个或多个启用 UM 的邮箱。这些邮箱必须是启用 UM 的邮箱，并且必须与统一消息服务器所属的 UM 拨号计划相关联。默认设置是 false。 |
TUILogonAll |
必需 |
System.Boolean |
此参数指定是否测试当前 Active Directory 站点中的所有邮箱，然后再测试与每个已启用 UM 的邮箱的连接情况。默认设置是 false。 |
UMIPGateway |
必需 |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
此参数指定用于进行传出测试呼叫的 UM IP 网关或 IP PBX 的名称。 |
UMDialPlan |
必需 |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
此参数指定将测试的 UM 拨号计划。它必须与 TUILogin 参数结合使用。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
DomainController 参数指定用于将此配置更改写入 Active Directory 的域控制器。请使用要使用的域控制器的完全限定的域名 (FQDN)。 |
Fax |
可选 |
System.Boolean |
此参数指定所测试的呼叫是传真呼叫。默认设置是 |
ListenPort |
可选 |
System.Int32 |
此参数指定要侦听的 IP 端口号。如果未指定，则将使用 IP 端口 9000。 |
MonitoringContext |
可选 |
System.Boolean |
此参数指定是否在命令行运行 cmdlet，或者是否将输出对象传递给 Microsoft Operations Manager。默认情况下，将从命令行运行 cmdlet。 |
Secured |
可选 |
System.Boolean |
此参数指定是否将在保护模式下运行测试。 |
Timeout |
可选 |
System.Int32 |
此参数指定等待测试操作完成的时间长度（秒）。默认为 180 秒。可以将此参数设置为小于 5 秒的值。但是，建议始终将此参数配置为大于或等于 5 秒的值。 |
ResetPIN |
必需 |
System.Boolean |
此参数指定是否为当前站点中的所有测试邮箱生成或重新生成新 PIN。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
DomainController 参数指定用于将此配置更改写入 Active Directory 的域控制器。请使用要使用的域控制器的完全限定的域名 (FQDN)。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
第一个示例对本地统一消息服务器执行连接测试和运行测试，然后显示 IP 语音 (VoIP) 连接信息。
第二个示例测试本地统一消息服务器是否可以使用不安全的传输控制协议 (TCP) 连接（而不是安全的相互传输层安全性 (MTLS) 连接），使用电话号码 56780 通过名为 MyUMIPGateway 的 UM IP 网关发出呼叫。
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false