Get-StorageGroupCopyStatus

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-StorageGroupCopyStatus cmdlet to return the view status information about storage groups in a cluster continuous replication (CCR), local continuous replication (LCR), or standby continuous replication (SCR) environment.

Syntax

Get-StorageGroupCopyStatus [-Identity <StorageGroupIdParameter>] [-DomainController <Fqdn>] [-DumpsterStatistics <SwitchParameter>] [-StandbyMachine <String>]

Get-StorageGroupCopyStatus -Server <ServerIdParameter> [-DomainController <Fqdn>] [-DumpsterStatistics <SwitchParameter>] [-StandbyMachine <String>]

Detailed Description

To see the complete status of a CCR, LCR, or SCR copy by using the Exchange Management Shell, run the Get-StorageGroupCopyStatus cmdlet. Depending upon the options that you provide, the cmdlet either returns information about a specific copy on a specific server or all copies on a server.

The basic cmdlet syntax is shown in the following example code.

Get-StorageGroupCopyStatus

When you use the basic syntax, the following sample output is provided in table format:

You can use the following example code to return the output in list format.

Get-StorageGroupCopyStatus |fl

The following table provides the type and describes the fields in the output.

You can make a quick assessment of the health of a copy by looking at the results in the SummaryCopyStatus, Failed, CopyQueueLength, and ReplayQueueLength, and LastInspectedLogTime fields. These fields show whether the copy is functioning properly and whether the copy is relatively current in both copying and applying logs. If the LastInspectedLogTime is not current, that can indicate that the replication service is stopped or that there is a low rate of traffic on the storage group. If the copy is ever in an unhealthy state, the reason should be determined and corrected. If the copy queue length value is more than 3, the reason should be determined and corrected. If the replay queue length value in a CCR or LCR environment is more than 20, the reason should be determined and corrected.

To use the Get-StorageGroupCopyStatus cmdlet, the account you use must be delegated the Exchange Server Administrator role and local Administrators group for the target server. For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Parameters

Errors

Example

The first code example is of the Get-StorageGroupCopyStatus command when the storage group name is not ambiguous.

The second code example describes how to get the copy status SG1 on server MBX.

The third code example describes how to get status on all storage groups for the server MBX.

The fourth code example produces copy information for all copies for the local server. On a passive node, it returns information for all copies of the associated active storage group copy.

The fifth example shows how to get status information for an SCR target on Server2 for a storage group named SG1.

The sixth example shows how to get status information for an SCR target on Server2 for a storage group named SG1 that includes transport dumpster statistics, and format the output as a list.

Get-StorageGroupCopyStatus -Identity Storage_Group_1 
Get-StorageGroupCopyStatus -Identity MBX\SG1 
Get-StorageGroupCopyStatus -Server MBX 
Get-StorageGroupCopyStatus
Get-StorageGroupCopyStatus -Identity MBX\SG1 -StandbyMachine Server2
Get-StorageGroupCopyStatus -Identity MBX\SG1 -StandbyMachine Server2 -DumpsterStatistics | fl