--- title: How to Use Remove-Mailbox in Powershell slug: remove-mailbox-powershell published: 2026-04-02T00:17:11.000Z updated: 2026-04-02T00:17:11.000Z feature_image: /blog/images/remove-mailbox-powershell/remove-mailbox-syntax-microsoft-learn.1600.webp feature_image_alt: Microsoft Learn documentation for the Remove-Mailbox cmdlet showing its PowerShell syntax author: James Futhey author_slug: james meta_description: How to use Remove-Mailbox cmdlet in PowerShell to effectively manage mailbox deletions in both Exchange Server and Exchange Online environments status: published --- Managing mailboxes efficiently is a vital task for Exchange administrators. Whether dealing with user mailboxes or public folders, it's essential to know how to properly remove mailboxes without leaving any residual data. The **Remove-Mailbox** cmdlet in PowerShell is a handy tool that allows administrators to remove mailboxes. In Exchange Online, this typically results in deletion of the associated user account, while in on-premises environments the behavior depends on how the mailbox is removed. This article will provide a comprehensive guide on the usage of the **Remove-Mailbox** cmdlet, explaining its syntax, parameters, and practical applications in both on-premises Exchange Server and Exchange Online environments. ## What is the Remove-Mailbox Cmdlet? The [**Remove-Mailbox**](https://learn.microsoft.com/en-us/powershell/module/exchangepowershell/remove-mailbox?view=exchange-ps) cmdlet is a command-line tool used in Exchange Management Shell or Exchange Online PowerShell to delete mailboxes. In Exchange Online, this typically results in deletion of the associated user account, while in on-premises environments the behavior depends on how the mailbox is removed. This cmdlet can disconnect a mailbox from a user, remove both the mailbox and user account depending on context, or permanently delete the mailbox from the database. It's applicable in on-premises Exchange Server environments and Exchange Online, offering flexibility to administrators managing various types of mailboxes, including arbitration, audit log, and public folder mailboxes. If you need to remove a mailbox but keep the user account, use the Disable-Mailbox cmdlet instead. ### Syntax The available parameters differ between Exchange Server (on-premises) and Exchange Online, and the cmdlet uses multiple parameter sets depending on the scenario. **Standard mailbox removal:** ```powershell Remove-Mailbox [-Identity] ``` [-Permanent <Boolean>] (On-premises only) [-PermanentlyDelete] (Exchange Online only) ```powershell [-Arbitration] [-AuditLog] [-AuxAuditLog] [-Confirm] [-DomainController ] [-Force] [-IgnoreDefaultScope] [-IgnoreLegalHold] [-Migration] [-PublicFolder] [-RemoveArbitrationMailboxWithOABsAllowed] [-RemoveLastArbitrationMailboxAllowed] [-SupervisoryReviewPolicy] [-WhatIf] [] ``` **Removing a disconnected mailbox (on-premises only):** Remove-Mailbox \-Database <DatabaseIdParameter> \-StoreMailboxIdentity <StoreMailboxIdParameter> ```powershell [-Arbitration] [-AuditLog] [-AuxAuditLog] [-Confirm] [-DomainController ] [-Force] [-IgnoreDefaultScope] [-IgnoreLegalHold] [-Migration] [-PublicFolder] [-RemoveArbitrationMailboxWithOABsAllowed] [-RemoveLastArbitrationMailboxAllowed] [-SupervisoryReviewPolicy] [-WhatIf] [] ``` ### Parameters - **Identity**: Identifies the mailbox to remove. - **Permanent**: Specifies whether to permanently delete the mailbox. This parameter is only available in on-premises Exchange. - **PermanentlyDelete**: Permanently deletes a soft-deleted mailbox in Exchange Online. This parameter is only available in Exchange Online. - **Arbitration**: Required to remove arbitration mailboxes. - **AuditLog**: Required to remove audit log mailboxes. - **AuxAuditLog**: Required to remove auxiliary audit log mailboxes. - **Confirm**: Shows or hides the confirmation prompt. - **DomainController**: Specifies the domain controller for Active Directory operations. - **Force**: Hides warning or confirmation messages. - **IgnoreDefaultScope**: Uses the entire forest as the scope. - **IgnoreLegalHold**: Ignores the legal hold status of the user. - **Migration**: Required to remove migration mailboxes. - **PublicFolder**: Required to remove public folder mailboxes. - **RemoveArbitrationMailboxWithOABsAllowed**: Bypasses checks for OABs in arbitration mailboxes. - **RemoveLastArbitrationMailboxAllowed**: Removes the last arbitration mailbox. - **SupervisoryReviewPolicy**: Reserved for internal Microsoft use. - **WhatIf**: Simulates the command without applying changes. ## Practical Uses ### 1\. Removing User Mailboxes After Employee Departure After an employee leaves an organization, administrators can use the **Remove-Mailbox** cmdlet to delete their mailbox. In Exchange Online, this typically results in deletion of the associated user account. This ensures that the mailbox is no longer accessible, and data is retained only for the configured retention period, allowing for compliance with organizational policies. ### 2\. Cleaning Up Legacy Arbitration Mailboxes Arbitration mailboxes can accumulate over time, especially in large organizations. Using the **Remove-Mailbox** cmdlet with the **Arbitration** parameter helps administrators manage and remove unnecessary arbitration mailboxes, streamlining the Exchange environment. ### 3\. Permanently Deleting Soft-Deleted Mailboxes in Exchange Online Soft-deleted mailboxes in Exchange Online may need to be permanently deleted to permanently remove data and prevent recovery. The **Remove-Mailbox** cmdlet, along with the **PermanentlyDelete** switch, allows for this permanent removal, ensuring no data remnants remain. ## Prerequisites - **Permissions**: You must have the appropriate permissions assigned to run the cmdlet. - **Environment**: Available in both Exchange Online and on-premises Exchange Server (Exchange 2010 or later). - **Exchange Management Shell**: Must be connected to the Exchange Management Shell or Exchange Online PowerShell module. ## How to Use Remove-Mailbox: 7 Practical Uses Using the **Remove-Mailbox** cmdlet is straightforward, but understanding the context and scenarios where it applies is essential. Below are practical examples demonstrating its usage in various administrative tasks. ### 1\. Deleting a User Mailbox **Command:** ```powershell Remove-Mailbox -Identity "John Rodman" ``` This command removes the mailbox. In Exchange Online, this typically results in deletion of the associated user account. The mailbox is soft-deleted and retained for a limited period (typically 30 days in Exchange Online) before permanent deletion. This use case is common when an employee departs, and their mailbox is no longer needed. ### 2\. Permanently Removing a Mailbox **Command:** ```powershell Remove-Mailbox -Identity "John Rodman" -Permanent $true ``` In an on-premises Exchange environment, this command permanently deletes "John Rodman’s" mailbox from the database. It's useful when immediate deletion is required, and the mailbox should not be recoverable. ### 3\. Removing a Disconnected Mailbox **Command:** ```powershell $Temp = Get-MailboxStatistics -Database Server01Database01 | Where {$_.DisplayName -eq 'John Rodman'} ``` ```powershell Remove-Mailbox -Database Server01Database01 -StoreMailboxIdentity $Temp.MailboxGuid ``` This example removes a disconnected mailbox from the database using its GUID. It's particularly useful for cleaning up orphaned mailboxes after user account deletions. Note that this is only applicable in on-premises Exchange. ### 4\. Deleting a Soft-Deleted Mailbox in Exchange Online **Command:** ```powershell Get-Mailbox -Identity Laura -SoftDeletedMailbox | Remove-Mailbox -PermanentlyDelete ``` This command permanently deletes a soft-deleted mailbox in Exchange Online. The mailbox must already be in a soft-deleted state before this operation can be performed. This is essential for maintaining data hygiene in the cloud. ### 5\. Removing an Arbitration Mailbox **Command:** ```powershell Remove-Mailbox -Identity "ArbitrationMailbox" -Arbitration ``` Arbitration mailboxes are used for system purposes. This command removes an arbitration mailbox, which might be necessary during maintenance or cleanup operations. ### 6\. Deleting a Public Folder Mailbox **Command:** ```powershell Remove-Mailbox -Identity "PublicFolderMailbox" -PublicFolder ``` Public folder mailboxes store public folder data. This command is used when a specific public folder mailbox is no longer required, freeing up space and resources. ### 7\. Removing a Migration Mailbox **Command:** ```powershell Remove-Mailbox -Identity "MigrationMailbox" -Migration ``` Migration mailboxes are used during data migration processes. Once the migration is complete, this command removes the migration mailbox to prevent unnecessary data retention. ## Final Note The **Remove-Mailbox** cmdlet is a vital tool for Exchange administrators, enabling efficient management of mailboxes in both Exchange Server and Exchange Online. Understanding its parameters and practical uses ensures that mailboxes are removed correctly, maintaining a clean and organized Exchange environment. Whether handling user departures or cleaning up legacy data, mastering **Remove-Mailbox** is essential for effective mailbox management.