Commands › Exchange Online
Test-AssistantHealth
Verify that the Microsoft Exchange Mailbox Assistants service (MSExchangeMailboxAssistants) is healthy, to recover from health issues, and to report the status of the diagnosis or recovery action.
Quick start script
# Test-AssistantHealth — 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-AssistantHealth | Format-List
# 3. Export for evidence / drift tracking
Test-AssistantHealth | Export-Clixml .\AssistantHealth-$(Get-Date -Format yyyyMMdd).xmlSyntax
Test-AssistantHealth [[-ServerName] <ServerIdParameter>]
[-Confirm]
[-IncludeCrashDump]
[-MaxProcessingTimeInMinutes <UInt32>]
[-MonitoringContext]
[-ResolveProblems]
[-WatermarkBehindWarningThreholdInMinutes <UInt32>]
[-WhatIf]
[<CommonParameters>]Parameters (8)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -ServerName | ServerIdParameter | The ServerName parameter specifies the Mailbox server where you want to run this command. 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. | |
| -IncludeCrashDump | SwitchParameter | The IncludeCrashDump switch specifies that the command should take an error report prior to taking any recovery actions. You don't need to specify a value with this switch. | |
| -MaxProcessingTimeInMinutes | UInt32 | The MaxProcessingTimeInMinutes parameter specifies the maximum amount of time the MSExchangeMailboxAssistants service is allowed to process an event without responding. You can specify a value from 1 through 3600... | |
| -MonitoringContext | SwitchParameter | The MonitoringContext switch includes the associated monitoring events and performance counters in the results. You don't need to specify a value with this switch. | |
| -ResolveProblems | SwitchParameter | This ResolveProblems switch specifies that if the command detects an issue, it attempts to fix it. You don't need to specify a value with this switch. | |
| -WatermarkBehindWarningThreholdInMinutes | UInt32 | The WatermarkBehindWarningThreholdInMinutes parameter specifies the threshold for watermark age. Event watermarks indicate the last time that events were successfully processed by an assistant. An event watermark... | |
| -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.