Get-CsVoicemailReroutingConfiguration
Topic Last Modified: 2012-03-23
Retrieves settings that provide public switched telephone network (PSTN) phone numbers to access Exchange Unified Messaging (UM) Subscriber Access and Auto Attendant features.
Syntax
Get-CsVoicemailReroutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoicemailReroutingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Detailed Description
This cmdlet retrieves settings that determine where Auto Attendant and Subscriber Access calls are rerouted to when IP connectivity from Microsoft Lync 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 (dual-tone multifrequency, or DTMF) so that outside callers can navigate a company’s phone system to reach the department or employee they want 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 voice mail messages for Enterprise Voice users (the AutoAttendantNumber setting) and for those users to retrieve voice mail even if the IP connectivity from the Lync Server 2010 deployment at a remote site to Exchange UM in the data center is unavailable (the SubscriberAccessNumber setting).
Calling this cmdlet with no parameters will return all voice mail rerouting configurations.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsVoicemailReroutingConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoicemailReroutingConfiguration"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
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. |
Filter |
Optional |
String |
The Filter parameter allows you to retrieve configuration settings for a particular set of sites based on wildcard matching. |
LocalStore |
Optional |
SwitchParameter |
Retrieves the voice mail rerouting configuration from the local replica of the Central Management store, rather than the Central Management store itself. |
Input Types
None.
Return Types
Retrieves one or more objects of type Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration.
Example
-------------------------- Example 1 --------------------------
Get-CsVoicemailReroutingConfiguration
This example retrieves all of the voice mail rerouting configuration settings defined in this deployment of Lync Server 2010. For example, if there are three branch offices where a Survivable Branch Appliance is deployed, this command will return three voice mail rerouting configuration sets.
-------------------------- Example 2 --------------------------
Get-CsVoicemailReroutingConfiguration -Identity site:BranchOffice_Portland
This example retrieves the voice mail rerouting configuration settings for the site BranchOffice_Portland.
-------------------------- Example 3 --------------------------
Get-CsVoicemailReroutingConfiguration -Filter *:BranchOffice*
This example retrieves all the voice mail rerouting settings for all sites with site names beginning with the string BranchOffice (for example, BranchOffice_Portland, BranchOffice_Sacramento).
-------------------------- Example 4 --------------------------
Get-CsVoicemailReroutingConfiguration | Where-Object {$_.Enabled -eq $False}
This example retrieves all the voice mail 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 voice mail 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.