Commands › Exchange Online

Test-SmtpConnectivity

Exchange Online ExchangeOnlineManagement Test-*

Diagnose whether an SMTP connection can successfully be established to the Receive connectors on a specific server. Although you can run this cmdlet manually to verify SMTP connectivity for a specified server, it's primarily used by Microsoft System Center Operations Manager 2007 to test your transport servers' ability to receive SMTP connections to each of the bindings on all the Receive connectors on those servers.

Quick start script

# Test-SmtpConnectivity — 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-SmtpConnectivity | Format-List

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

Syntax

Test-SmtpConnectivity [[-Identity] <ServerIdParameter>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MonitoringContext <Boolean>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (5)

Parameter	Type	What it controls
-Identity	ServerIdParameter	The Identity parameter specifies the transport server for which the cmdlet verifies SMTP connectivity .
-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...
-MonitoringContext	Boolean	The MonitoringContext parameter specifies whether to include the associated monitoring events and performance counters in the results. Valid values are:
-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.