New-UMCallAnsweringRule

Syntax

New-UMCallAnsweringRule
   -Name <String>
   [-CallerIds <MultiValuedProperty>]
   [-CallersCanInterruptGreeting <Boolean>]
   [-CheckAutomaticReplies <Boolean>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExtensionsDialed <MultiValuedProperty>]
   [-KeyMappings <MultiValuedProperty>]
   [-Mailbox <MailboxIdParameter>]
   [-Priority <Int32>]
   [-ScheduleStatus <Int32>]
   [-TimeOfDay <TimeOfDay>]
   [-WhatIf]
   [<CommonParameters>]

Description

The New-UMCallAnsweringRule cmdlet creates a Unified Messaging (UM) call answering rule stored in a UM-enabled user's mailbox. You can run the cmdlet and create a call answering rule of the user that's logged on or use the Mailbox parameter to specify the mailbox where you want the call answering rule to be created. You can use the New-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 this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Examples

Example 1

New-UMCallAnsweringRule -Mailbox tonysmith -Name MyCallAnsweringRule -Priority 2

This example creates the call answering rule MyCallAnsweringRule in the mailbox for tonysmith with the priority of 2.

Example 2

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

This example creates 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.

Example 3

New-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox [email protected] -ScheduleStatus 0x8

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

Example 4

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

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

• 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.

Example 5

New-UMCallAnsweringRule -Name MyCallAnsweringRule -Priority 2 -Mailbox tonysmith -TimeOfDay "1,0,,"

This example creates 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 during working hours, the caller is asked to call back later.

Example 6

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

This example creates the call answering rule MyCallAnsweringRule in the mailbox for tonysmith with a custom period for the time of day 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.

Parameters

-CallerIds

-CallersCanInterruptGreeting

-CheckAutomaticReplies

-Confirm

-DomainController

-ExtensionsDialed

-KeyMappings

-Mailbox

-Name

-Priority

-ScheduleStatus

-TimeOfDay

-WhatIf

Inputs

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.

Outputs

Output 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.