Commands › Exchange Online
Set-UMCallAnsweringRule
Change properties of an existing UM call answering rule.
Quick start script
# Set-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)
Set-UMCallAnsweringRule -Identity <UMCallAnsweringRuleIdParameter> -WhatIf
Set-UMCallAnsweringRule -Identity <UMCallAnsweringRuleIdParameter>
# 4. Verify and diff
$after = Get-UMCallAnsweringRule
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-UMCallAnsweringRule [-Identity] <UMCallAnsweringRuleIdParameter>
[-CallerIds <MultiValuedProperty>]
[-CallersCanInterruptGreeting <Boolean>]
[-CheckAutomaticReplies <Boolean>]
[-Confirm]
[-DomainController <Fqdn>]
[-ExtensionsDialed <MultiValuedProperty>]
[-KeyMappings <MultiValuedProperty>]
[-Mailbox <MailboxIdParameter>]
[-Name <String>]
[-Priority <Int32>]
[-ScheduleStatus <Int32>]
[-TimeOfDay <TimeOfDay>]
[-WhatIf]
[<CommonParameters>]Parameters (14)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | UMCallAnsweringRuleIdParameter | yes | The Identity parameter specifies the identifier for a call answering rule being changed. |
| -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 that you want to modify. You can use any value that uniquely identifies the mailbox. For example: | |
| -Name | 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... | |
| -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.