Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2008-03-06
Use the Test-ReplicationHealth cmdlet to check all aspects of replication, cluster services, and storage group replication and replay status to provide a complete overview of the replication system.
Syntax
Test-ReplicationHealth [-ActiveDirectoryTimeout
<Int32>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-MonitoringContext <$true |
$false>] [-TransientEventSuppressionWindow <UInt32>]
[-WhatIf [<SwitchParameter>]]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
ActiveDirectoryTimeout |
Optional |
System.Int32 |
The ActiveDirectoryTimeout parameter specifies the amount of time, in seconds, allowed for each directory service operation to complete before the operation times out. The default value is 15 seconds. |
|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter is used to specify the fully qualified domain name (FQDN) of the domain controller that will be used to retrieve data from the directory service. |
|
MonitoringContext |
Optional |
System.Boolean |
The MonitoringContext parameter specifies whether the results of the command will include monitoring events and performance counters. The two possible values for this parameter are $true or $false. If you specify $true, the results will include monitoring events and performance counters in addition to the information about services. |
|
TransientEventSuppressionWindow |
Optional |
System.UInt32 |
The TransientEventSuppressionWindow parameter specifies the number of minutes the queue lengths can be exceeded before the queue length tests will be considered as failed. This parameter is used to reduce the number of failures due to transient load generation. |
|
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with the WhatIf parameter. |
Detailed Description
Microsoft Exchange Server 2007 Service Pack 1 (SP1) introduces a new cmdlet called Test-ReplicationHealth. This cmdlet is designed for proactive monitoring of continuous replication and the continuous replication pipeline. For more information about monitoring continuous replication using Test-ReplicationHealth and other cmdlets, see Monitoring Continuous Replication.
To run the Test-ReplicationHealth 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 Exchange Server 2007, see Permission Considerations.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Example
In this example, the Test-ReplicationHealth cmdlet is used without parameters to test the health of replication for a clustered mailbox server.
 Copy Code |
|
|---|---|
Test-ReplicationHealth |
|