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