[This topic is in progress.]

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-05-04

Use the Get-MailboxDatabaseCopyStatus cmdlet to view status information about mailbox databases that have been configured with one or more database copies.

Syntax

Get-MailboxDatabaseCopyStatus [-Identity <DatabaseCopyIdParameter>] [-Active <SwitchParameter>] [-ConnectionStatus <SwitchParameter>] [-DomainController <Fqdn>] [-ExtendedErrorInfo <SwitchParameter>] [-Local <SwitchParameter>]
Get-MailboxDatabaseCopyStatus -Server <MailboxServerIdParameter> [-ConnectionStatus <SwitchParameter>] [-DomainController <Fqdn>] [-ExtendedErrorInfo <SwitchParameter>]

Detailed Description

If a database is specified by using the Identity parameter with the command, the status of all copies of the database is returned. If a server is specified by using the Server parameter with the command, information on all database copies on the server is returned.

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 copy" entry in the High Availability Permissions topic.

Parameters

Parameter Required Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter

The Server parameter specifies that a Mailbox server returns status information for all of its mailbox database copies. This parameter cannot be combined with the Identity parameter.

Active

Optional

System.Management.Automation.SwitchParameter

The Active parameter is used to return mailbox database copy status for the active mailbox database copy only.

ConnectionStatus

Optional

System.Management.Automation.SwitchParameter

The ConnectionStatus parameter is used to include details about the in-use replication networks in the output. If you use this parameter, the IncomingLogCopyingNetwork and SeedingNetwork fields will be populated in the task's output.

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.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseCopyIdParameter

The Identity parameter specifies the name of the database copy for which the command should gather information. The Identity parameter can be specified in the form of <database>\<server>. Specifying just <database> will return information for all copies of the database. This parameter cannot be combined with the Server parameter.

Local

Optional

System.Management.Automation.SwitchParameter

The Local parameter is used to return mailbox database copy status information from only the local Mailbox server.

ExtendedErrorInfo

Optional

System.Management.Automation.SwitchParameter

The ExtendedErrorInfo parameter is used to return an output object containing any exception details.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

Errors

Error Description

Parameter set cannot be resolved using the specified named parameters.

The Identity and Server parameters cannot be combined. To query the status of a database copy on a particular server, use the Identity parameter and specify the database and server in the format of <database>\<server> (for example, DB1\EX2). 

Examples

EXAMPLE 1

This example returns status information for all copies of a database named DB2. The status results are displayed in a list format.

Copy Code
Get-MailboxDatabaseCopyStatus -Identity DB2 | Format-List

EXAMPLE 2

This example returns the status for all database copies on a Mailbox server named EXMBX2. The status results are also displayed in a list format.

Copy Code
Get-MailboxDatabaseCopyStatus -Server EXMBX2 | Format-List

EXAMPLE 3

This example returns status and log shipping and seeding network information for a database named DB3 on a Mailbox server named EXMBX3. The status results are displayed in a list format.

Copy Code
Get-MailboxDatabaseCopyStatus -Identity DB3\EXMBX3 -ConnectionStatus | Format-List

EXAMPLE 4

This example returns the status for the copy of database DB1 on a Mailbox server named EXMBX2. The status results are also displayed in a list format.

Copy Code
Get-MailboxDatabaseCopyStatus -Identity DB1\EXMBX2 | Format-List