Export (0) Print
Expand All

Get-MailboxDatabaseCopyStatus

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

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


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


Get-MailboxDatabaseCopyStatus -Server <MailboxServerIdParameter> [-ConnectionStatus <SwitchParameter>] [-DomainController <Fqdn>] [-ExtendedErrorInfo <SwitchParameter>]

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.

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.

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). 

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

Get-MailboxDatabaseCopyStatus -Identity DB2 | Format-List

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.

Get-MailboxDatabaseCopyStatus -Server EXMBX2 | Format-List

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.

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

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.

Get-MailboxDatabaseCopyStatus -Identity DB1\EXMBX2 | Format-List
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft