Commands › Exchange Online
New-UMCallAnsweringRule
Create a call answering rule.
Quick start script
# New-UMCallAnsweringRule — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-UMCallAnsweringRule
$before | Format-List
# 3. Make the change (dry run first)
New-UMCallAnsweringRule -Name <String> -WhatIf
New-UMCallAnsweringRule -Name <String>
# 4. Verify and diff
$after = Get-UMCallAnsweringRule
Compare-Object ($before | Out-String) ($after | Out-String)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>]Parameters (13)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Name | String | yes | The Name parameter specifies the name of the Unified Messaging (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... |
| -CallerIds | 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... | |
| -CallersCanInterruptGreeting | Boolean | The CallersCanInterruptGreeting parameter specifies whether a caller can interrupt the voice mail greeting while it's being played. The default is $null. | |
| -CheckAutomaticReplies | Boolean | The CheckAutomaticReplies parameter specifies an entry for the "If My Automatic Replies are Enabled" condition. The default is $false. | |
| -Confirm | SwitchParameter | The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding. | |
| -DomainController | Fqdn | The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name... | |
| -ExtensionsDialed | 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... | |
| -KeyMappings | 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... | |
| -Mailbox | MailboxIdParameter | The Mailbox parameter specifies the UM-enabled mailbox where the call answering rule is created. You can use any value that uniquely identifies the mailbox. For example: | |
| -Priority | Int32 | The Priority parameter specifies a priority value for the rule that determines the order of rule processing. A lower integer value indicates a higher priority, and rules can't have the same priority value. | |
| -ScheduleStatus | 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... | |
| -TimeOfDay | 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 | SwitchParameter | The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.