Commands › Exchange Online

Remove-MailboxUserConfiguration

Exchange Online ExchangeOnlineManagement Remove-*

Remove user configuration items from mailboxes. Typically, after you delete a user configuration item, it's automatically recreated the next time the user uses that feature in their mailbox.

Quick start script

# Remove-MailboxUserConfiguration — 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-MailboxUserConfiguration
$before | Format-List

# 3. Make the change (dry run first)
Remove-MailboxUserConfiguration -Identity <MailboxUserConfigurationIdParameter> -Mailbox <MailboxIdParameter> -WhatIf
Remove-MailboxUserConfiguration -Identity <MailboxUserConfigurationIdParameter> -Mailbox <MailboxIdParameter>

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

Syntax

Remove-MailboxUserConfiguration [-Identity] <MailboxUserConfigurationIdParameter> -Mailbox <MailboxIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (5)

Parameter	Type	Required	What it controls
-Identity	MailboxUserConfigurationIdParameter	yes	The Identity parameter specifies the user configuration item that you want to remove. This parameter uses the syntax MailboxFolder\ItemName:
-Mailbox	MailboxIdParameter	yes	The Mailbox parameter specifies the mailbox that contains the user configuration items you want to remove. You can use any value that uniquely identifies the mailbox. For example:
-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		This parameter is available only in on-premises Exchange.
-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.