Test-UMConnectivity Primer

Exchange 2007 Ships with a tool called test-umconnectivity that can be used to verify the health of your Exchange Unified Messaging installation.

It has a couple of modes of operation:


Local Voice

In this mode, the task will run on a machine that has the Exchange Unified Messaging role installed. It will run diagnostics against the local UM server.

The way to run this, is to invoke test-umconnectivity without any parameters.


In this mode, the task verifies that the UMService is listening and responding to incoming INVITES.


[PS] D:\users\Administrator> test-umconnectivity

UmserverAcceptingCallAnsweringMessages : True
CallAnswerQueuedMessages               : 0
CurrCalls                              : 0
UmIPAddress                            :
Latency                                : 2121
OutBoundSIPCallSuccess                 : True
EntireOperationSuccess                 : True
ReasonForFailure                       :
Identity                               : 62caff65-7a68-46ab-b2a3-ef52a31e431e
IsValid                                : True


Remote Voice

This is an end-to-end test. It verifies that the connectivity from UMServer to Gateway to PSTN is working fine. In this mode, the task does the following:

1) Makes an outbound call to a given phone number using a gateway.

2) The gateway will then send the call to the PBX.

3) The call will then come back to the gateway from the PBX.

4) The Gateway sends the call to a UM server that is linked to the gateway.

5) UM server will respond to the incoming INVITE with some DTMF tones, that are then verified by the task.


This test can be run from any machine that has the Exchange 2007 admin tools installed. It can also be run from any machine that has the Microsoft Operations Manager (MOM) installed, along with the Exchange Management Pack.

For example, I have a UM server setup with an IPGateway. I also have an autoattendant configured with an extension 74808. I want to make sure that my autoattendant is answering calls.

[PS] D:\users\Administrator> get-umipgateway

Name                 Address       HuntGroups    OutCallsAllowed  Status
----                 -------       ----------    ---------------  ------
UNSECURE_GATEWAY     10.198.250... {74809:UNS... True             Enabled
SECURE_GATEWAY       securegw.e... {}            True             Enabled
sipphonegw  {:UNSECURE... True             Enabled


[PS] D:\users\Administrator> get-umautoattendant

Name              UMDialPlan      PilotIdentifier SpeechEnabled  Status
----              ----------      --------------- -------------  ------
aa1               UNSECURE_DIA... {74808}         True           Enabled


[PS] D:\users\Administrator> test-umconnectivity -UMIPGateway unsecure_gateway -Phone 74808

CurrCalls              : 0
UmIPAddress            :
Latency                : 43236
OutBoundSIPCallSuccess : True
EntireOperationSuccess : True
ReasonForFailure       :
Identity               : 385bbfdf-26fc-460e-9ccb-a1f14b750c0b
IsValid                : True


The output of the command shows which UM server answered the call, the call latency, etc.



In this mode, the task will test that the UM server can connect to a mailbox in a site. This is used to make sure that the UM sever has good connectivity to mailbox servers that have the mailboxes for UM enabled user that the UM server is servicing.

In order to run this command, we need a UM enabled mailbox with an extension. Also, this command needs to be run on a UMServer.


[PS] D:\users\Administrator> test-umconnectivity -tuiLogon:1 -UMDialPlan:unsecure_dialplan -phone:74808 -pin:147258