Export (0) Print
Expand All
Expand Minimize

Remove-CsVoicemailReroutingConfiguration

 

Topic Last Modified: 2012-03-27

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>]]

This cmdlet allows you to remove settings that determine where Auto Attendant and Subscriber Access calls are rerouted to over PSTN 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 (dual-tone multifrequency, or 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 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).

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

Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsVoicemailReroutingConfiguration cmdlet locally: 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 "Remove-CsVoicemailReroutingConfiguration"}

 

Parameter Required Type Description

Identity

Required

XdsIdentity

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.

Force

Optional

SwitchParameter

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

WhatIf

Optional

SwitchParameter

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

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration object. Accepts pipelined input of voice mail rerouting configuration objects.

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

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

Remove-CsVoicemailReroutingConfiguration -Identity site:Redmond1

This example removes the voice mail rerouting configuration settings for the site Redmond1.

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

Get-CsVoicemailReroutingConfiguration | Remove-CsVoicemailReroutingConfiguration

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft