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