Applies to: Exchange Server 2013
Topic Last Modified: 2012-07-12
Use the Get-MailboxDatabaseCopyStatus cmdlet to view health and status information about one or more mailbox database copies.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
Get-MailboxDatabaseCopyStatus -Server
<MailboxServerIdParameter> <COMMON PARAMETERS>
|
Get-MailboxDatabaseCopyStatus [-Identity
<DatabaseCopyIdParameter>] [-Local <SwitchParameter>]
<COMMON PARAMETERS>
|
COMMON PARAMETERS: [-Active <SwitchParameter>]
[-ConnectionStatus <SwitchParameter>] [-DomainController
<Fqdn>] [-ExtendedErrorInfo <SwitchParameter>]
[-UseServerCache <SwitchParameter>]
|
Examples
EXAMPLE 1
This example returns status information for all copies of the database DB1. The status results are displayed in a list format.
 Copy Code |
|
|---|---|
Get-MailboxDatabaseCopyStatus -Identity DB1 | Format-List |
|
EXAMPLE 2
This example returns the status for all database copies on the Mailbox server MBX1. The status results are also displayed in a list format.
| Copy Code |
|
|---|---|
Get-MailboxDatabaseCopyStatus -Server MBX1 | Format-List |
|
EXAMPLE 3
This example returns status and log shipping and seeding network information for the database DB3 on the Mailbox server MBX3. The status results are displayed in a list format.
| Copy Code |
|
|---|---|
Get-MailboxDatabaseCopyStatus -Identity DB3\MBX3 -ConnectionStatus | Format-List |
|
EXAMPLE 4
This example returns the status for the copy of database DB1 on the Mailbox server MBX2. The status results are also displayed in a list format.
| Copy Code |
|
|---|---|
Get-MailboxDatabaseCopyStatus -Identity DB1\MBX2 | Format-List |
|
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 about all database copies on the server is returned. If neither parameter is specified with the command, information about all database copies in the organization 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 "Database availability groups" entry in the High Availability and Site Resilience 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 can't be combined with the Identity parameter. |
|
Active |
Optional |
System.Management.Automation.SwitchParameter |
The Active switch specifies whether to return mailbox database copy status for the active mailbox database copy only. |
|
ConnectionStatus |
Optional |
System.Management.Automation.SwitchParameter |
The ConnectionStatus switch specifies whether to include details about the in-use replication networks in the output. If you use this parameter, the IncomingLogCopyingNetwork and SeedingNetwork fields are 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. |
|
ExtendedErrorInfo |
Optional |
System.Management.Automation.SwitchParameter |
The ExtendedErrorInfo switch specifies whether to return an output object containing any exception details. |
|
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> returns information for all copies of the database. This parameter can't be combined with the Server parameter. |
|
Local |
Optional |
System.Management.Automation.SwitchParameter |
The Local switch specifies whether to return mailbox database copy status information from only the local Mailbox server. |
|
UseServerCache |
Optional |
System.Management.Automation.SwitchParameter |
The UseServerCache switch specifies whether to enable a server-side remote procedure call (RPC) caching of status information for 5 seconds. |
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.