[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Retrieves settings that provide public switched telephone network (PSTN) phone numbers to access Exchange Unified Messaging (UM) Subscriber Access and Auto-Attendant features.


Get-CsVoicemailReroutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoicemailReroutingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]


Parameter Required Type Description




The unique identifier of the configuration you want to retrieve. For this cmdlet the Identity will be either Global or Site:<site name>, where <site name> is the name of the site to which the settings are applied.




The Filter parameter allows you to retrieve configuration settings for a particular set of sites based on wildcard matching.




Retrieves the voice mail rerouting configuration from the local replica of the Central Management database, rather than the Central Management database itself.

Detailed Description

This cmdlet retrieves settings that determine where Auto-Attendant and Subscriber Access calls are rerouted to when IP connectivity from Microsoft Communications Server 2010 in the branch site to the Exchange UM Server located in the data center is not available.

Auto-Attendant and Subscriber Access are features of Exchange UM. The Auto-Attendant feature provides voice recognition and touch-tone control (DTMF) for outside callers to navigate a company’s phone system to reach the desired department or employee or, in Message Taking Mode, to accept messages for users. (Voice rerouting for Message Taking Mode is recommended.) Subscriber Access allows internal users to access their Microsoft Outlook mailbox from a phone. The numbers provided by these settings allow callers to leave voicemail messages for Enterprise Voice users and for those users to retrieve voicemail even if the IP connectivity from the Communications Server deployment at a remote site to Exchange UM in the datacenter is unavailable.

Calling this cmdlet with no parameters will return all voicemail rerouting configurations.

Return Types

Retrieves one or more objects of type Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration.


-------------------------- Example 1 --------------------------

Copy Code

This example retrieves all the voicemail rerouting configuration settings defined in this deployment of Communications Server. For example, if there are three branch offices where a Survivable Branch Site is deployed, this command will return three voicemail rerouting configuration sets.

-------------------------- Example 2 --------------------------

Copy Code
Get-CsVoicemailReroutingConfiguration -Identity site:BranchOffice_Portland

This example retrieves the voicemail rerouting configuration settings for the site BranchOffice_Portland.

-------------------------- Example 3 --------------------------

Copy Code
Get-CsVoicemailReroutingConfiguration -Filter *:BranchOffice*

This example retrieves all the voicemail rerouting settings for all sites with site names beginning with the string BranchOffice (i.e., BranchOffice_Portland, BranchOffice_Sacramento).

-------------------------- Example 4 --------------------------

Copy Code
Get-CsVoicemailReroutingConfiguration | Where-Object {$_.Enabled -eq $False}

This example retrieves all the voicemail rerouting configurations that are not enabled. The first part of this command is a call to Get-CsVoicemailReroutingConfiguration, which retrieves a collection of all the voicemail rerouting configurations. That collection is then piped to the Where-Object cmdlet. Where-Object narrows that collection down to include only the configurations that have an Enabled property equal to (-eq) False.