Enable-UMMailbox — usage, script and reference

Quick start script

# Enable-UMMailbox — 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-UMMailbox
$before | Format-List

# 3. Make the change (dry run first)
Enable-UMMailbox -Identity <MailboxIdParameter> -UMMailboxPolicy <MailboxPolicyIdParameter> -EnableCloudVoiceMail <SwitchParameter> -WhatIf
Enable-UMMailbox -Identity <MailboxIdParameter> -UMMailboxPolicy <MailboxPolicyIdParameter> -EnableCloudVoiceMail <SwitchParameter>

# 4. Verify and diff
$after = Get-UMMailbox
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

Identity (Default)

Enable-UMMailbox [-Identity] <MailboxIdParameter> -UMMailboxPolicy <MailboxPolicyIdParameter>
 [-AutomaticSpeechRecognitionEnabled <Boolean>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Extensions <MultiValuedProperty>]
 [-IgnoreDefaultScope]
 [-NotifyEmail <String>]
 [-PilotNumber <String>]
 [-PIN <String>]
 [-PINExpired <Boolean>]
 [-SIPResourceIdentifier <String>]
 [-ValidateOnly]
 [-WhatIf]
 [<CommonParameters>]

CloudVoiceMail

Enable-UMMailbox [-Identity] <MailboxIdParameter>
 [-EnableCloudVoiceMail]
 [-AutomaticSpeechRecognitionEnabled <Boolean>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Extensions <MultiValuedProperty>]
 [-IgnoreDefaultScope]
 [-NotifyEmail <String>]
 [-PilotNumber <String>]
 [-Pin <String>]
 [-PinExpired <Boolean>]
 [-SendWelcomeMail <Boolean>]
 [-SIPResourceIdentifier <String>]
 [-UMMailboxPolicy <MailboxPolicyIdParameter>]
 [-ValidateOnly]
 [-WhatIf]
 [<CommonParameters>]

Parameters (16)

Parameter	Type	Required	What it controls
-Identity	MailboxIdParameter	yes	The Identity parameter specifies the mailbox that you want to enable for Unified Messaging. You can use any value that uniquely identifies the mailbox. For example:
-UMMailboxPolicy	MailboxPolicyIdParameter	yes	The UMMailboxPolicy parameter specifies the UM mailbox policy that you want to associate with the mailbox. You can use any value that uniquely identifies the policy. For example:
-AutomaticSpeechRecognitionEnabled	Boolean		The AutomaticSpeechRecognitionEnabled parameter specifies whether to enable Automatic Speech Recognition (ASR) for the UM mailbox. Valid values are:
-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...
-EnableCloudVoiceMail	SwitchParameter	yes	The EnableCloudVoiceMail switch specifies whether to enable the mailbox for UM in Skype for Business Online. You don't need to specify a value with this switch.
-Extensions	MultiValuedProperty		The Extensions parameter specifies the extension number for the user. Either a single extension number or an array of telephone number extensions can be specified. The user's extension must be unique to the UM dial plan.
-IgnoreDefaultScope	SwitchParameter		The IgnoreDefaultScope switch tells the command to ignore the default recipient scope setting for the Exchange PowerShell session, and to use the entire forest as the scope. You don't need to specify a value with this switch.
-NotifyEmail	String		The NotifyEmail parameter specifies the email address where the Unified Messaging welcome message is sent. By default, the message is sent to the user's SMTP email address.
-PilotNumber	String		The PilotNumber parameter specifies the subscriber access number users can dial to gain access to their mailboxes. The default value is the subscriber access number that's specified on the UM dial plan.
-PIN	String		The PIN parameter specifies the value for the initial PIN that's used for the UM mailbox. The PIN is checked against the UM mailbox policy rules. The PIN value must be from 4 through 24 numeric characters.
-PINExpired	Boolean		The PINExpired parameter specifies whether the PIN is treated as expired. If the PIN isn't supplied, the PIN is treated as expired and users are prompted to reset their PIN the next time they log on.
-SendWelcomeMail	Boolean		The SendWelcomeMail parameter specifies whether you want to send a welcome message after the mailbox is enabled for UM. Valid values are:
-SIPResourceIdentifier	String		The SIPResourceIdentifier parameter specifies the SIP address or E.164 address for the user. This property is compared to the URI type defined on the UM dial plan.
-ValidateOnly	SwitchParameter		The ValidateOnly switch specifies whether to evaluate the potential success or failure of the command without making changes. You don't need to specify a value with this switch.
-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.