Export (0) Print
Expand All

Get-MailboxDatabase

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Use the Get-MailboxDatabase cmdlet to retrieve one or more mailbox database objects from a server or organization.


Get-MailboxDatabase [-Identity <DatabaseIdParameter>] [-DomainController <Fqdn>] [-DumpsterStatistics <SwitchParameter>] [-IncludePreExchange2010 <SwitchParameter>] [-Status <SwitchParameter>]


Get-MailboxDatabase -Server <ServerIdParameter> [-DomainController <Fqdn>] [-DumpsterStatistics <SwitchParameter>] [-IncludePreExchange2010 <SwitchParameter>] [-Status <SwitchParameter>]

Parameter Required Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the name of the server from which to retrieve mailbox database information. If you specify this parameter, the command retrieves information about all of the mailbox databases on the server that you specify.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

DumpsterStatistics

Optional

System.Management.Automation.SwitchParameter

The DumpsterStatistics parameter specifies that transport dumpster statistics be returned with the database status.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The Identity parameter specifies a mailbox database. You can use the following values:

  • GUID
  • Distinguished name (DN)
  • Server\database name
  • Database name

If you don't specify the server name, the command searches for databases on the local server. If you have multiple databases with the same name, the command retrieves all databases with the same name in the specified scope.

IncludePreExchange2010

Optional

System.Management.Automation.SwitchParameter

The IncludePreExchange2010 parameter specifies whether to return information about the mailbox databases that reside on computers running Microsoft Exchange Server 2010 and earlier versions of Exchange.

Status

Optional

System.Management.Automation.SwitchParameter

The Status parameter specifies whether to get information about the following attributes:

  • BackupInProgress
  • Mounted
  • OnlineMaintenanceInProgress
  • Available free space in the database root

You don't need to specify any value with this parameter.

If you specify this parameter, you should format the output in such a way that you can view the additional attributes. For example, pipe the output to the Format-List cmdlet.

If you use the Get-MailboxDatabase cmdlet with no parameters, it gets information about all mailbox databases in the Exchange organization.

If you use the Get-MailboxDatabase cmdlet with the Server parameter, it gets information about all mailbox databases on the server that you specify.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Mailbox Database permissions" section in the Mailbox Permissions topic.

Error Description

 

Exceptions Description

 

This example retrieves information about all the mailbox databases in the Exchange organization, including the mailbox databases that reside on computers running Exchange 2010 and earlier versions of Exchange.

Get-MailboxDatabase -IncludePreExchange2010

This example retrieves information about MailboxDatabase01 on Server01. This example also retrieves the status information, and pipes the output to the Format-List cmdlet so that you can view all the information about the mailbox database.

Get-MailboxDatabase -Identity Server01\StorageGroup01\MailboxDatabase01 -Status | Format-List
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft