[This is pre-release documentation and subject to change in future releases. This topic's current status is: Milestone-Ready]

Topic Last Modified: 2010-07-18

This topic describes how to configure Unified Messaging (UM) on a Microsoft Exchange Server for use with Enterprise Voice.

The cmdlet examples in this topic provide syntax for the Exchange 2007 version of Exchange Management Shell. If you are running Exchange Server 2010, see the appropriate documentation as referenced.

To configure a server running Exchange Server UM

  1. Create a UM Session Initiation Protocol (SIP) Uniform Resource Identifier (URI) dial plan for each of your Enterprise Voice location profiles. If you choose to use the Exchange Management Console, create a new dial plan with the security setting Secured (preferred).

    If you set your security setting value to SIP Secured to require encryption for SIP traffic only, as previously recommended, note that this security setting on a dial plan is insufficient if the Front End pool is configured to require encryption, which means the pool requires encryption for both SIP and RTP traffic. When the dial plan and pool security settings are not compatible, all calls to Exchange UM from the Front End pool will fail, resulting an error indicating that you have “Incompatible security setting”.

    If you use the Exchange Management Shell, type:

    Copy Code
    new-umdialplan -name <dial plan name> -UriType "SipName" -VoipSecurity <SIPSecured|Unsecured|Secured> -NumberOfDigitsInExtension <number of digits> -AccessTelephoneNumbers <access number in E.164 format>

    For more information, see:

    Whether you select a security level of SIPSecured or Secured depends on whether Secure Real-time Transport Protocol (SRTP) is activated or deactivated for media encryption. For the Communications Server integration with Exchange UM, this should correspond to the encryption level in the Communications Server media configuration. The Communications Server media configuration can be viewed by running the Get-CsMediaConfiguration cmdlet. For more information, see Get-CsMediaConfiguration in the Communications Server Management Shell documentation.

    For details about selecting the appropriate VoIP Security setting, see Security Levels in Plan for Exchange Server 2007 SP1 Unified Messaging in Office Communications Server.
  2. Run the following cmdlet to obtain the fully qualified domain name (FQDN) for each UM dial plan:

    Copy Code
    (Get-UMDialPlan <dialplanname>).PhoneContext  

    For more information, see:

  3. Record the dialplanname of each UM dial plan. Depending on your version of Exchange Server, you may need to use the FQDN of each dialplanname later as the name of each UM dial plan’s corresponding Communications Server dial plan.

    Communications Server dial plan names must match UM dial plan names only if the UM dial plan is running on a version of Exchange earlier than Exchange 2010 SP1.
  4. Add the dial plan to the server running Exchange UM as follows:

    • If you choose to use the Exchange Management Console, you can add the dial plan from the property sheet for the server. For specific instructions, see the Exchange Server product documentation.

      For Exchange 2007, see How to Add Unified Messaging Server to a Dial Plan.

      For Exchange 2010, see View or Configure the Properties of a UM Server.

    • If you use the Exchange Management Shell, run the following for each of your Exchange UM servers:

      Copy Code
      $dp=get-umdialplan -id <name of dial-plan created in step 1>; 
      $ums[0].DialPlans +=$dp.Identity; 
      set-umserver -instance $ums[0]
    Before you perform the following step, make sure that all Enterprise Voice users have been configured with an Exchange Server mailbox.

    For Exchange 2007, see http://go.microsoft.com/fwlink/?LinkID=129672.

    For Exchange 2010, see http://go.microsoft.com/fwlink/?LinkID=186202.

    When specifying a mailbox policy for each dial plan that you created in step 1, select either the default policy or one that you have created.
  5. Navigate to <Exchange installation directory>\Scripts, and then if Exchange is deployed in a single forest, type:

    Copy Code

    Or, if Exchange is deployed in multiple forests, type:

    Copy Code
    exchucutil.ps1 -Forest:"<forest FQDN>" for multiple forest deployments

    where forest FQDN specifies the forest in which Communications Server is deployed.

    If you have one or more UM dial plans that are associated with multiple IP gateways, continue to step 6. If your dial plans are each associated with only a single IP gateway, skip step 6.

    Be sure to restart the Communication Server Front-End service (rtcsrv.exe) after you run exchucutil.ps1. Otherwise, Communications Server will not detect Unified Messaging in the topology.
  6. Using either the Exchange Management Shell or Exchange Management Console, disable outbound calling for all but one of the IP gateways associated with each of your dial plans.

    This step is necessary to ensure that outbound calls by the server running Exchange Server Unified Messaging to external users (for example, as is the case with play-on-phone scenarios) reliably traverse the corporate firewall.
    When selecting the UM IP gateway through which to allow outgoing calls, choose the one that is likely to handle the most traffic. Do not allow outgoing traffic through an IP gateway that connects to a pool of Communications Server Directors. Also avoid pools in another central site or a branch site. You can use either of the following methods to block outgoing calls from passing through an IP gateway:
    • If you use the Exchange Management Shell, disable each IP gateway by running the following command:

      Copy Code
      Set-UMIPGateway <gatewayname> -OutcallsAllowed $false
      For Exchange 2007, see Set-UMIPGateway Exchange 2007 Help

      For Exchange 2010, see Set-UMIPGateway Exchange 2010 Help.

    • If you use the Exchange Management Console, clear the Allow outgoing calls through this IP gateway check box.

    If your UM SIP URI dial plan is associated with only a single IP gateway, do not disallow outgoing calls through this gateway.
  7. Create a UM auto-attendant for each Communications Server dial plan.

    Do not include any spaces in the name of the auto attendant.
    Copy Code
    New-umautoattendant -name <auto attendant name> -umdialplan < name of dial plan created in step 1> -PilotIdentifierList <auto attendant phone number in E.164 format> -SpeechEnabled $true -Status Enabled

    For more information, see:

    The following step should be performed for each user after you have enabled Communications Server users for Enterprise Voice and know their SIP URIs.

  8. Associate Exchange UM users (each of whom should be configured with an Exchange mail box) with the UM dial plan and create a SIP URI for each user.

    The SIPResourceIdentifier in the following sample must be the SIP address of the Communications Server user.
    Copy Code
    enable-ummailbox -id <user alias> -ummailboxpolicy <name of the mailbox policy for the dial plan created in step 1> -Extensions <extension> -SIPResourceIdentifier "<user alias>@<full domain name>" -PIN <user pin>

    For more information, see: