Applies to: Exchange Server 2013

Topic Last Modified: 2012-10-12

Use the Set-UMCallAnsweringRule cmdlet to change properties of an existing UM call answering rule.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax


`Set-UMCallAnsweringRule -Identity <UMCallAnsweringRuleIdParameter> [-CallerIds <MultiValuedProperty>] [-CallersCanInterruptGreeting <$true \| $false>] [-CheckAutomaticReplies <$true \| $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExtensionsDialed <MultiValuedProperty>] [-KeyMappings <MultiValuedProperty>] [-Mailbox <MailboxIdParameter>] [-Name <String>] [-Priority <Int32>] [-ScheduleStatus <Int32>] [-TimeOfDay <TimeOfDay>] [-WhatIf [<SwitchParameter>]]`

Set-UMCallAnsweringRule -Identity
<UMCallAnsweringRuleIdParameter> [-CallerIds
<MultiValuedProperty>] [-CallersCanInterruptGreeting
<$true | $false>] [-CheckAutomaticReplies <$true |
$false>] [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-ExtensionsDialed <MultiValuedProperty>]
[-KeyMappings <MultiValuedProperty>] [-Mailbox
<MailboxIdParameter>] [-Name <String>] [-Priority
<Int32>] [-ScheduleStatus <Int32>] [-TimeOfDay
<TimeOfDay>] [-WhatIf [<SwitchParameter>]]

Examples

EXAMPLE 1

This example sets the priority to 2 on the existing call answering rule MyCallAnsweringRule that exists in the mailbox for tonysmith.

	Copy Code
Set-UMCallAnsweringRule -Mailbox tonysmith -Name MyCallAnsweringRule -Priority 2

EXAMPLE 2

This example performs the following actions on the call answering rule MyCallAnsweringRule in the mailbox for tonysmith:

Sets the call answering rule to two caller IDs.
Sets the priority of the call answering rule to 2.
Sets the call answering rule to allow callers to interrupt the greeting.

	Copy Code
Set-UMCallAnsweringRule -Name MyCallAnsweringRule -CallerIds "1,4255550100,,","1,4255550123,," -Priority 2 -CallersCanInterruptGreeting $true -Mailbox tonysmith

EXAMPLE 3

This example changes the free/busy status to Out of Office on the call answering rule MyCallAnsweringRule in the mailbox for tonysmith and sets the priority to 2.

	Copy Code
Set-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox tonysmith@contoso.com -ScheduleStatus 0x8

EXAMPLE 4

This example performs the following actions on the call answering rule MyCallAnsweringRule in the mailbox tonysmith:

Sets the priority of the call answering rule to 2.
Creates key mappings for the call answering rule.
If the caller reaches the voice mail for the user and the status of the user is set to Busy, the caller can:

Press the 1 key and be transferred to a receptionist at extension 45678.
Press the 2 key and the Find Me feature will be used for urgent issues and ring extension 23456 first, and then 45671.

	Copy Code
Set-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox tonysmith -ScheduleStatus 0x4 -KeyMappings "1,1,Receptionist,,,,,45678,","5,2,Urgent Issues,23456,23,45671,50,,"

EXAMPLE 5

This example performs the following actions on the call answering rule MyCallAnsweringRule in the mailbox for tonysmith:

Sets the priority of the call answering rule to 2.
If the caller reaches voice mail during working hours, the caller is asked to call back later.

	Copy Code
Set-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox tonysmith -TimeOfDay "1,0,,"

EXAMPLE 6

This example sets a custom period for the time of day on the call answering rule MyCallAnsweringRule in the mailbox for tonysmith and performs the following actions:

Sets the priority of the call answering rule to 2.
If the caller reaches voice mail and the time is between 8:00 A.M. and 12:00 P.M. on Tuesday, ask the caller to call back later.

	Copy Code
Set-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox tonysmith -TimeOfDay "3,4,8:00,12:00"

Detailed Description

The Set-UMCallAnsweringRule cmdlet changes the properties of an existing UM call answering rule stored in a UM enabled user's mailbox. You can use the Set-UMCallAnsweringRule cmdlet to specify the following conditions:

Who the incoming call is from
Time of day
Calendar free/busy status
Whether automatic replies are turned on for email

You can also specify the following actions:

Find me
Transfer the caller to someone else
Leave a voice message

After this task is completed, the cmdlet sets the parameters and the values specified.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "UM call answering rules" entry in the Unified Messaging Permissions topic.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.UMCallAnsweringRuleIdParameter	The Identity parameter specifies the identifier for a call answering rule being changed.
CallerIds	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The CallerIds parameter specifies an entry for the "If the Caller is" condition. Each entry for this parameter can contain a phone number, an Active Directory contact, a personal contact, or the personal Contacts folder. The parameter can contain 50 phone numbers or contact entries and no more than one entry for specifying the default Contacts folder. If the CallerIds parameter doesn't contain a condition, the condition isn't set and is ignored. The default value is `$null`.
CallersCanInterruptGreeting	Optional	System.Boolean	The CallersCanInterruptGreeting parameter specifies whether a caller can interrupt the voice mail greeting while it's being played. The default is `$null`.
CheckAutomaticReplies	Optional	System.Boolean	The CheckAutomaticReplies parameter specifies an entry for the "If My Automatic Replies are Enabled" condition. The default is `$false`.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.
ExtensionsDialed	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The ExtensionsDialed parameter specifies an entry for the "If the Caller Dials" condition. Each entry must be unique per call answering rule. Each extension must correspond to existing extension numbers assigned to UM-enabled users. The default is `$null`.
KeyMappings	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The KeyMappings parameter specifies a key mapping entry for a call answering rule. The key mappings are those menu options offered to callers if the call answering rule is set to `$true`. You can configure a maximum of 10 entries. None of the defined key mappings can overlap. The default is `$null`.
Mailbox	Optional	Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter	The Mailbox parameter specifies the UM-enabled mailbox where the call answering rule will be changed. The default is the user's mailbox that's running the cmdlet.
Name	Optional	System.String	The Name parameter specifies the name of the UM call answering rule or Call Answering Rule ID being modified. The call answering ID or name must be unique per the user's UM-enabled mailbox. The name or ID for the call answering rule can contain up to 255 characters.
Priority	Optional	System.Int32	The Priority parameter specified the order that the call answering rule will be evaluated against other existing call answering rules. Call answering rules are processed in order of increasing priority values. The priority must be unique between all call answering rules in the UM-enabled mailbox. The priority on the call answering rule must be between 1 (highest) and 9 (lowest). The default is 9.
ScheduleStatus	Optional	System.Int32	The ScheduleStatus parameter specifies an entry for the "If my Schedule show that I am" condition. Users can specify their free/busy status to be checked. This parameter can be set from 0 through 15 and is interpreted as a 4-bit mask that represents the calendar status including Free, Tentative, Busy, and Out of Office. The following settings can be used to set the schedule status: None = 0x0 Free = 0x1 Tentative = 0x2 Busy = 0x4 OutOfOffice = 0x8 The default setting is `$null`.
TimeOfDay	Optional	Microsoft.Exchange.Data.TimeOfDay	The TimeOfDay parameter specifies an entry for the "If the Call Arrives During" condition for the call answering rule. You can specify working hours, non-working hours, or custom hours. The default is `$null`.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.