Test-ReplicationHealth

 

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

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>]]

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.

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.

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.

Test-ReplicationHealth