Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2008-11-13

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.

Note:
This cmdlet is not applicable to public folder copies.
Note:
The basic syntax of the cmdlet provides five fields of output. To get a complete list of all the fields that are available, run the cmdlet piped to either fl (formatted list) or ft (formatted table).

Syntax

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

Parameters

Parameter Required or optional Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter returns information about all storage group copies on the specified server. If no value is specified, you get information for all copies on the local server.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller, include the DomainController parameter in the command.

DumpsterStatistics

Optional

System.Management.Automation.SwitchParameter

The DumpsterStatistics parameter specifies that transport dumpster statistics be returned with the storage group copy status.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

The Identity parameter takes one of the following values:

  • GUID

  • Name of the storage group

If no value is specified, you get information for all copies on the local server.

For LCR, this means the storage group must have LCR enabled.

For CCR, the information is always returned about the target of the replication.

StandbyMachine

Optional

System.String

The StandbyMachine parameter specifies the name of the server that is configured as an SCR target. This parameter must be used when obtaining status information for an SCR target.

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.

Copy Code
Get-StorageGroupCopyStatus

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

Name SummaryCopyStatus CopyQueueLength ReplayQueueLength LastInspectedLogTime

StorageGroup1

Healthy

0

0

6/14/2007 4:42:01 PM

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

Copy Code
Get-StorageGroupCopyStatus |fl

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

Field name Description Type

Identity

The identity of the storage group.

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

StorageGroupName

The name of the storage group.

System.String

SummaryCopyStatus

A summary representation of the general status of the copy.

Enumeration with values: Disabled, Failed, Seeding, Copying, Stopped, and Healthy

Failed

Indicates whether the storage group copy is in a condition where it can successfully replicate and replay log files.

System.Boolean

FailedMessage

The condition that triggered the failed condition.

System.String

Seeding

Indicates whether a seeding operation is currently in progress.

System.Boolean

Suspend

Indicates whether replication is suspended on the copy.

System.Boolean

SuspendComment

The administrator-provided comment given when the storage group copy replication was suspended.

System.String

CopyQueueLength

The number of logs known by the copy that need to be replicated to the copy.

System.Long

ReplayQueueLength

The number of logs available to be replayed into the copy's database.

System.Long

LatestAvailableLogTime

The time associated with the latest available log generated by the active computer. This log is available to be copied.

System.DateTime

LastCopyNotificationedLogTime

The time associated with the last new log generated by the active storage group and known to the copy.

System.DateTime

LastCopiedLogTime

The modification time of the last log that was successfully copied.

System.DateTime

LastInspectedLogTime

The modification time of the last log that was successfully validated by the node hosting the copy.

System.DateTime

LastReplayedLogTime

The modification time of the last log that was successfully replayed by the node hosting the copy.

System.DateTime

LastLogGenerated

The log generation number of the last log known to be generated on the active node.

System.Long

LastLogCopied

The log generation number of the last log copied to the copy.

System.Long

LastLogNotified

The log generation number of the last log generated by the active node and known to the copy.

System.Long

LastLogInspected

The log generation number of the last log inspected by the copy.

System.Long

LastLogReplayed

The log generation number of the last log replayed by the copy.

System.Long

LatestFullBackupTime

The time of last full backup.

System.DateTime

LatestIncrementalBackupTime

The time of the last incremental backup.

System.DateTime

SnapshotBackup

Indicates whether the last full backup taken was a legacy streaming backup or a Volume Shadow Copy Service (VSS) backup snapshot.

System.Boolean

DumpsterStatistics

Transport dumpster statistics from all accessible Hub Transport servers.

System.String

DumpsterStatisticsNotAvailable

Inaccessible Hub Transport servers.

System.String

OutstandingDumpsterRequests

Outstanding requests and the time range (low–high) for the outstanding requests.

System.String

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.

Note:
You can also use the Test-ReplicationHealth cmdlet to verify the heath and status of storage groups enabled for continuous replication. For more information about Test-ReplicationHealth, see Test-ReplicationHealth.

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.

Errors

Error

Description

The specified identity does not exist.

The error occurs because the specified object does not exist, or the object has not been replicated to the referenced domain controller.

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.

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