Commands › Exchange Online

Invoke-MonitoringProbe

Exchange Online ExchangeOnlineManagement Invoke-*

Run a Managed Availability probe on a selected server. This cmdlet can't be used to run every Managed Availability probe. Only some probes (mainly the deep test probes) can be run manually using this cmdlet. Probes that can't be run with this cmdlet return error messages when you use Invoke-MonitoringProbe to run them.

Quick start script

# Invoke-MonitoringProbe — 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
Invoke-MonitoringProbe -Identity <String> -Server <ServerIdParameter> | Format-List

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

Syntax

Invoke-MonitoringProbe [-Identity] <String> -Server <ServerIdParameter>
 [-Account <String>]
 [-Endpoint <String>]
 [-ItemTargetExtension <String>]
 [-Password <String>]
 [-PropertyOverride <String>]
 [-SecondaryAccount <String>]
 [-SecondaryEndpoint <String>]
 [-SecondaryPassword <String>]
 [-TimeOutSeconds <String>]
 [<CommonParameters>]

Parameters (11)

Parameter	Type	Required	What it controls
-Identity	String	yes	The Identity parameter specifies the identity of the monitoring probe to run.
-Server	ServerIdParameter	yes	The Server parameter specifies the Exchange server where you want to run this command. You can use any value that uniquely identifies the server. For example:
-Account	String		The Account parameter specifies the identity of the mailbox or user account that's used to run the monitoring probe.
-Endpoint	String		The Endpoint parameter specifies the name of the monitoring probe endpoint to connect to, for example, contoso.mail.com.
-ItemTargetExtension	String		The ItemTargetExtension parameter specifies cmdlet extension data that you can pass to the monitoring probe. The probe that runs on the server might require specific data for its execution. This data is presented to...
-Password	String		The Password parameter specifies the password of the mailbox or user account that's used to run the monitoring probe.
-PropertyOverride	String		The PropertyOverride parameter specifies a property that you want to override, for example, to set the time-out value to be extended beyond the default value.
-SecondaryAccount	String		The SecondaryAccount parameter specifies the identity of the delegate mailbox or user account that's used to run the monitoring probe.
-SecondaryEndpoint	String		The SecondaryEndpoint parameter specifies the name of the secondary monitoring probe endpoint to connect to, for example, contoso.mail.fabrikam.com.
-SecondaryPassword	String		The SecondaryPassword parameter specifies the password of the delegate mailbox or user account that's used to run the monitoring probe.
-TimeOutSeconds	String		The TimeOutSeconds parameter specifies the monitoring operation time-out period.

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