Commands › Exchange Online

Test-MRSHealth

Exchange Online ExchangeOnlineManagement Test-*

Test the health of an instance of the Microsoft Exchange Mailbox Replication service.

Quick start script

# Test-MRSHealth — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Run and inspect
Test-MRSHealth | Format-List

# 3. Export for evidence / drift tracking
Test-MRSHealth | Export-Clixml .\MRSHealth-$(Get-Date -Format yyyyMMdd).xml

Syntax

Test-MRSHealth [[-Identity] <ServerIdParameter>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MaxQueueScanAgeSeconds <Int32>]
 [-MonitoringContext <Boolean>]
 [-MRSProxyCredentials <PSCredential>]
 [-MRSProxyServer <Fqdn>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (8)

ParameterTypeRequiredWhat it controls
-Identity ServerIdParameter The Identity parameter specifies the server on which to perform the health test. You can use any value that uniquely identifies the server. For example:
-Confirm SwitchParameter The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController Fqdn The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-MaxQueueScanAgeSeconds Int32 The MaxQueueScanAgeSeconds parameter specifies the threshold for the last queue scan property. If the time stamp on the last queue scan property is older than the value specified by this parameter, an error event is...
-MonitoringContext Boolean The MonitoringContext parameter specifies whether to include the associated monitoring events and performance counters in the results. Valid values are:
-MRSProxyCredentials PSCredential The MRSProxyCredentials parameter specifies the credentials that are required for the MRSProxyPingCheck test on the server that's specified by the MRSProxyServer parameter.
-MRSProxyServer Fqdn The MRSProxyServer parameter specifies the fully qualified domain name (FQDN) of the target server for the MRSProxyPingCheck test.
-WhatIf SwitchParameter The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.