Remove-MailboxDatabase
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Remove-MailboxDatabase cmdlet to delete a mailbox database object.
Syntax
Remove-MailboxDatabase -Identity <DatabaseIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detailed Description
To run the Remove-MailboxDatabase cmdlet, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators group for the target server
For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.
If the mailbox database has a database copy, the Remove-MailboxDatabase cmdlet will also remove the copy.
The Remove-MailboxDatabase cmdlet removes only the database object from Active Directory. It does not remove the physical database files. You must remove the database files manually after you run the Remove-MailboxDatabase command.
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
The Identity parameter specifies the mailbox database to remove. You can use the following values:
If you do not specify the server name, the cmdlet will search for the database on the local server. If you have multiple databases with the same name, you must specify the storage group |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with the WhatIf parameter. |
Input Types
Return Types
Errors
Error | Description |
---|---|
|
Exceptions
Exceptions | Description |
---|---|
|
Example
The following example shows how to remove the mailbox database named MailboxDatabase01.
Remove-MailboxDatabase -Identity MailboxDatabase01