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

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


Remove-CsVoicemailReroutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The unique identifier of the configuration you want to remove. 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.




Prompts you for confirmation before executing the command.




Suppresses any confirmation prompts that would otherwise be displayed before making changes.




Describes what would happen if you executed the command without actually executing the command.

Detailed Description

This cmdlet allows you to remove settings that determine where Auto-Attendant and Subscriber Access calls are rerouted over PSTN to when IP connectivity is lost.

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.

Note that if you call this cmdlet to remove the Global settings, those settings will simply be reset to their defaults.

Return Types

Removes an object of type Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration.


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

Copy Code
Remove-CsVoicemailReroutingConfiguration -Identity site:Redmond1

This example removes the voicemail rerouting configuration settings for the site Redmond1.

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

Copy Code
Get-CsVoicemailReroutingConfiguration | Remove-CsVoicemailReroutingConfiguration

This example removes all the voicemail rerouting settings for this deployment of Communications Server. The command first retrieves all the voicemail rerouting configuration settings by calling Get-CsVoicemailReroutingConfiguration. The settings retrieved by this call are then passed to Remove-CsVoicemailReroutingConfiguration to delete each one.