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

Creates settings that, when enabled, provide phone numbers that Microsoft Communications Server 2010 routes to over public switched telephone network (PSTN) if IP connectivity from Communications Server in the branch site to the Exchange UM Server located in the datacenter is not available.

Syntax


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

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

Parameters

Parameter	Required	Type	Description
Identity	Required	XdsIdentity	This parameter contains a unique identifier specifying the scope at which this configuration is applied. New voicemail rerouting configurations can be created only at the site level, so the Identity would be in the format Site:<site name>, where <site name> is the name of the site to which the settings are applied.
AutoAttendantNumber	Optional	String	Phone number of the auto-attendant to which the voicemail 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 voicemail should be re-routed through PSTN when IP connectivity is down. Default: False
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.
InMemory	Optional	SwitchParameter	Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.
Confirm	Optional	SwitchParameter	Prompts you for confirmation before executing the command.
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.

Detailed Description

This cmdlet allows you to create settings that are applied at either the global or site level 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 (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 these settings are not available unless the Enabled property has been set to True.

Available scopes: Global, Site

Return Types

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

Examples

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

	Copy Code
New-CsVoicemailReroutingConfiguration -Identity site:Redmond1 -Enabled $True -AutoAttendantNumber "+14255551212"

This example creates new voicemail rerouting settings that apply to the site Redmond1. The Enabled parameter is set to True to turn on this configuration, and a phone number (+14255551212) is supplied to specify the Auto-Attendant to which calls will be rerouted.

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

	Copy Code
New-CsVoicemailReroutingConfiguration -Identity site:Redmond1 -SubscriberAccessNumber "+14255551213"

This example creates new voicemail rerouting settings that apply to the site Redmond1. A phone number (+14255551213) is supplied to specify the subscriber access number to which calls will be rerouted. Notice that the Enabled parameter has not been set. Enabled is set to False by default, so subscriber access calls will not be rerouted to this number until the Enabled property is set to True.