Commands › Exchange Online

Test-OwaConnectivity

Exchange Online ExchangeOnlineManagement Test-*

Verify that Microsoft Office Outlook Web App is running as expected. The Test-OwaConnectivity cmdlet can be used to test Outlook Web App connectivity for all Microsoft Exchange Server 2010 virtual directories on a specified Client Access server for all mailboxes on servers running Exchange that are in the same Active Directory site. The Test-OwaConnectivity cmdlet can also be used to test the connectivity for an individual Exchange Outlook Web App URL.

Quick start script

# Test-OwaConnectivity — 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-OwaConnectivity -URL <String> -MailboxCredential <PSCredential> | Format-List

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

Syntax — 2 parameter sets

URL

Test-OwaConnectivity [-URL] <String> -MailboxCredential <PSCredential>
 [-AllowUnsecureAccess]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-LightMode]
 [-ResetTestAccountCredentials]
 [-Timeout <UInt32>]
 [-TrustAnySSLCertificate]
 [-WhatIf]
 [<CommonParameters>]

Identity

Test-OwaConnectivity [[-ClientAccessServer] <ServerIdParameter>]
 [-MailboxServer <ServerIdParameter>]
 [-MonitoringContext]
 [-RSTEndpoint <String>]
 [-TestType <OwaConnectivityTestType>]
 [-VirtualDirectoryName <String>]
 [-AllowUnsecureAccess]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-LightMode]
 [-ResetTestAccountCredentials]
 [-Timeout <UInt32>]
 [-TrustAnySSLCertificate]
 [-WhatIf]
 [<CommonParameters>]

Parameters (16)

Parameter	Type	Required	What it controls
-ClientAccessServer	ServerIdParameter		This parameter is available only in Exchange Server 2010
-URL	String	yes	The URL parameter specifies the URL to test. This parameter is required only when you want to test a single Outlook Web App URL.
-MailboxCredential	PSCredential	yes	The MailboxCredential parameter specifies the mailbox credential for a single URL test.
-AllowUnsecureAccess	SwitchParameter		The AllowUnsecureAccess switch specifies whether virtual directories that don't require TLS are tested. You don't need to specify a value with this switch.
-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...
-LightMode	SwitchParameter		The LightMode parameter isn't implemented for this diagnostic command. Using this parameter doesn't change the behavior of the command.
-MailboxServer	ServerIdParameter		The MailboxServer parameter specifies the name of the Mailbox server to test. If not specified, all Mailbox servers in the local Active Directory site are tested.
-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.
-ResetTestAccountCredentials	SwitchParameter		The ResetTestAccountCredentials switch resets the password for the test account that's used to run this command. You don't need to specify a value with this switch.
-RSTEndpoint	String		This parameter is reserved for internal Microsoft use.
-TestType	OwaConnectivityTestType		The TestType parameter specifies whether the command tests internal or external URLs. Values are Internal and External. You can't use this parameter with the URL parameter. When neither the TestType parameter nor the...
-Timeout	UInt32		The Timeout parameter specifies the amount of time, in seconds, to wait for the test operation to finish. The default value for the Timeout parameter is 30 seconds. You must specify a time-out value greater than 0...
-TrustAnySSLCertificate	SwitchParameter		The TrustAnySSLCertificate switch allows Exchange to accept certificates from untrusted certification authorities (CAs). You don't need to specify a value with this switch.
-VirtualDirectoryName	String		The VirtualDirectoryName parameter specifies the name of the virtual directory to test on a particular Client Access server. If this parameter isn't included, all Exchange Outlook Web App virtual directories that...
-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.