Share via


Set-CsVoicemailReroutingConfiguration

 

Topic Last Modified: 2012-03-27

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

Syntax

Set-CsVoicemailReroutingConfiguration [-Identity <XdsIdentity>] [-AutoAttendantNumber <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-SubscriberAccessNumber <String>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicemailReroutingConfiguration [-AutoAttendantNumber <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SubscriberAccessNumber <String>] [-WhatIf [<SwitchParameter>]]

Detailed Description

This cmdlet allows you to modify settings that determine where Auto Attendant and Subscriber Access calls are rerouted to when IP connectivity to an Exchange UM server 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 these settings are not available unless the Enabled property has been set to True.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsVoicemailReroutingConfiguration cmdlet locally: RTCUniversalServerAdmins. To return a list of all the 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 "Set-CsVoicemailReroutingConfiguration"}

Parameters

Parameter Required Type Description

Identity

Optional

String

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

Instance

Optional

VoicemailReroutingConfiguration

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

This object must be of type Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration (which can be retrieved by calling Get-CsVoicemailReroutingConfiguration).

AutoAttendantNumber

Optional

String

Phone number of the Auto Attendant to which the voice mail deposit attempts should be re-routed.

The number supplied to this parameter must be a LineUri of an existing contact object.

Value must be a number beginning with a digit 1 through 9, optionally preceded by a plus (+), followed by any number of digits.

Enabled

Optional

Boolean

Indicates whether attempts to access voice mail should be re-routed through PSTN when IP connectivity is down.

SubscriberAccessNumber

Optional

String

Subscriber Access number to which the voice mail retrieval attempts should be re-routed.

The number supplied to this parameter must be a LineUri of an existing contact object.

Value must be a number beginning with a digit 1 through 9, optionally preceded by a plus (+), followed by any number of digits.

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.

Input Types

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

Return Types

This cmdlet does not return a value. It modifies an object of type Microsoft.Rtc.Management.WritableConfig.Settings.ExumRouting.VoicemailReroutingConfiguration.

Example

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

Set-CsVoicemailReroutingConfiguration -Identity site:Redmond1 -Enabled $True

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

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

Set-CsVoicemailReroutingConfiguration -Identity site:Redmond1 -SubscriberAccessNumber "+14255551213"

This example modifies the voice mail rerouting settings that apply to the site Redmond1, setting the phone number for Subscriber Access to +14255551213.