Test-UMConnectivity
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2008-01-30
Test-UMConnectivity cmdlet 可以用于测试安装了统一消息服务器角色的计算机的运行情况。
语法
test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -ResetPIN <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
详细说明
设计两个诊断测试用于测试 Microsoft Exchange Server 2007 统一消息服务器软件（模式 1）的运行情况以及包括连接的电话组件在内的整个系统（模式 2）的运行情况。
Test-UMConnectivity cmdlet 可以用于测试统一消息 (UM) 服务器的运行情况以及相关的连接电话设备。当管理员运行此 cmdlet 并且包括 UMIPGateway 参数时，统一消息服务器会测试 UM 系统完整的端到端运行情况。这包括连接到统一消息服务器的电话组件，如 IP 网关、专用交换机 (PBX) 和电缆。如果未指定 IPGateway 参数，统一消息服务器将仅测试服务器上安装和配置的 UM 组件的运行情况。
若要运行 Test-UMConnectivity cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组。
有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Phone |
必需 |
System.String |
此参数指定在测试呼叫被重定向时将使用的电话号码或 SIP URI。应当在 PBX 中配置分机号码，才能转移呼叫 UM 智能寻线。 |
PIN |
必需 |
System.String |
此参数可以指定与已启用 UM 的邮箱关联的 PIN。 |
ResetPIN |
必需 |
System.Boolean |
此参数指定是否为当前站点中的所有测试邮箱生成或重新生成新 PIN。 |
TUILogon |
必需 |
System.Boolean |
此参数指定您是否希望 cmdlet 尝试登录到一个或多个启用 UM 的邮箱。这些邮箱必须是启用 UM 的邮箱，并且必须与统一消息服务器所属的 UM 拨号计划相关联。默认设置是 false。 |
TUILogonAll |
必需 |
System.Boolean |
此参数指定是否测试当前 Active Directory 站点中的所有邮箱，然后再测试与每个已启用 UM 的邮箱的连接情况。默认设置是 false。 |
UMDialPlan |
必需 |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
此参数指定将测试的 UM 拨号计划。它必须与 TUILogin 参数结合使用。 |
UMIPGateway |
必需 |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
此参数指定用于进行传出测试呼叫的 UM IP 网关或 IP PBX 的名称。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
此参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。默认值为 $true。 |
DiagDtmfDurationInMilisecs |
可选 |
System.Int32 |
此参数指定所发送的每个位的持续时间。 |
DiagDtmfSequence |
可选 |
System.String |
此参数指定所发送的位序列。 |
DiagInitialSilenceInMilisecs |
可选 |
System.Int32 |
此参数指定 cmdlet 在发送位序列之前将暂停的时间段（毫秒）。 |
DiagInterDtmfDiffGapInMilisecs |
可选 |
System.String |
此参数用于自定义诊断序列中各位之间的间隔时间。这是一个逗号分隔的列表，可以接受空条目。此参数应包含多个值。 |
DiagInterDtmfGapInMilisecs |
可选 |
System.Int32 |
此参数指定位序列中发送的每个位之间的间隔时间（毫秒）。此参数包含单个值。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
此参数指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)。 |
Fax |
可选 |
System.Boolean |
此参数指定所测试的呼叫是传真呼叫。默认设置是 |
From |
可选 |
System.String |
该参数指定发出呼叫的 SIP URI 或 SIP 地址。仅当使用 -Phone 参数时，才会使用它。默认设置是使用 -Phone 参数时指定的 SIP URI。 |
ListenPort |
可选 |
System.Int32 |
此参数指定要侦听的 IP 端口号。如果未指定，则将使用 IP 端口 9000。 |
MediaSecured |
可选 |
System.Boolean |
此参数指定使用安全 RTP 模式还是不安全模式。 |
MonitoringContext |
可选 |
System.Boolean |
此参数指定在命令行运行该 cmdlet，还是将输出对象传递给 Microsoft Operations Manager。默认情况下，将从命令行运行 cmdlet。 |
RemotePort |
可选 |
System.Int32 |
此参数指定呼叫将使用的端口。如果未指定，TCP 的默认端口是 5060，MTLS 的默认端口是 5061。 |
Secured |
可选 |
System.Boolean |
此参数指定是否将在保护模式下运行测试。 |
Timeout |
可选 |
System.Int32 |
此参数指定等待测试操作完成的时间长度（秒）。默认为 180 秒。可以将此参数设置为小于 5 秒的值。但是，建议始终将此参数配置为大于或等于 5 秒的值。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
此参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。默认值为 $true。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
第一个示例对本地统一消息服务器执行连接测试和运行测试，然后显示 IP 语音 (VoIP) 连接信息。
第二个示例测试本地统一消息服务器是否可以使用不安全的传输控制协议 (TCP) 连接（而不是安全的相互传输层安全性 (MTLS) 连接），使用电话号码 56780 通过名为 MyUMIPGateway 的 UM IP 网关发出呼叫。
第三个示例使用 SIP URI 测试拨号计划上的订阅者访问号码。可以在包含 Microsoft Office Communications Server 2007 的环境中使用该示例。
第四个示例使用 SIP URI 测试自动助理。应当在包含 Communications Server 2007 的环境中使用它。
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"