ClientAccessServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

This parameter specifies the name of the Client Access server to test. Do not use this parameter with the URL parameter.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

ConnectionType

Optional

Microsoft.Exchange.Monitoring.ProtocolConnectionType

This parameter specifies the type of connection that is used to connect to the Client Access server.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the cmdlet.

LightMode

Optional

System.Management.Automation.SwitchParameter

This parameter is not implemented for the Test-ImapConnectivity cmdlet. Using this parameter does not change the behavior of the cmdlet.

Note:

This cmdlet is implemented for other Exchange 2007 diagnostic cmdlets.

MailboxCredential

Optional

System.Management.Automation.PSCredential

This parameter includes the mailbox credential for a single URL test.

MailboxServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

This parameter specifies the name of the Mailbox server to test. If not specified, all Mailbox servers in the local Active Directory site will be tested.

MonitoringContext

Optional

System.Management.Automation.SwitchParameter

If this parameter is included, the task will be run by Microsoft Operations Manager (MOM) scheduling. Running the task with this parameter without MOM will cause the task to fail. If this parameter is excluded, the task must be run interactively by an administrator.

PerConnectionTimeout

Optional

System.Int32

This parameter specifies the amount of time to wait per connection, in seconds, for the test operation to finish. The default value for PerConnectionTimeout is 24 seconds. You must specify a Timeout value greater than 0 seconds and less than 120 seconds. We recommend that you always configure this parameter with a value of 5 seconds or more.

PortClientAccessServer

Optional

System.Int32

This parameter specifies the port to use to connect to the Client Access server that you will use with the Test-ImapConnectivity cmdlet.

ResetTestAccountCredentials

Optional

System.Management.Automation.SwitchParameter

Using this parameter will reset the test account credentials to use with the Test-ImapConnectivity cmdlet.

Timeout

Optional

System.UInt32

This parameter specifies the amount of time to wait, in seconds, for the test operation to finish. The default value for Timeout is 30 seconds. You must specify a Timeout value greater than 0 seconds and less than 1 hour (3600 seconds). We recommend that you always configure this parameter with a value of 5 seconds or more.

TrustAnySSLCertificate

Optional

System.Management.Automation.SwitchParameter

If this parameter is used, Secure Sockets Layer (SSL) certificate validation failures will not be reported. This parameter lets the Test-ImapConnectivity cmdlet check the IMAP4 service without generating an error when the certificate does not match the URL of the Client Access server.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with the WhatIf parameter.