Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11

The Test-ActiveSyncConnectivity cmdlet lets you perform a full synchronization against a specified mailbox to test the configuration of Microsoft Exchange ActiveSync.

Syntax


`test-ActiveSyncConnectivity [-ClientAccessServer <ServerIdParameter>] [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-DomainController <Fqdn>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-MonitoringInstance <String>] [-ResetTestAccountCredentials <SwitchParameter>] [-TrustAnySSLCertificate <SwitchParameter>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>]`

test-ActiveSyncConnectivity [-ClientAccessServer
<ServerIdParameter>] [-URL <String>]
[-AllowUnsecureAccess <SwitchParameter>] [-DomainController
<Fqdn>] [-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>] [-MonitoringContext
<SwitchParameter>] [-MonitoringInstance <String>]
[-ResetTestAccountCredentials <SwitchParameter>]
[-TrustAnySSLCertificate <SwitchParameter>]
[-UseAutodiscoverForClientAccessServer
<SwitchParameter>]

Parameters

Parameter	Required	Type	Description
AllowUnsecureAccess	Optional	System.Management.Automation.SwitchParameter	This parameter allows the test to continue over an unsecured channel that does not require Secure Sockets Layer (SSL).
ClientAccessServer	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	This parameter specifies the Client Access server computer the device uses to synchronize.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	This parameter specifies the domain controller to connect to for Active Directory validation.
MailboxCredential	Optional	System.Management.Automation.PSCredential	This parameter specifies the mailbox the device synchronizes with.
MailboxServer	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	This parameter specifies the Mailbox server computer that contains the associated mailbox.
MonitoringContext	Optional	System.Management.Automation.SwitchParameter	This parameter specifies whether the test result is passed to Microsoft Operations Manager (MOM). If this parameter is set to `$true`, the test result is passed to MOM. If this parameter is set to `$false`, the test result appears only on the command line.
MonitoringInstance	Optional	System.String	This parameter specifies whether the task is to be run against the mailbox of the user currently running the task. It is only used when this task is run from MOM.
ResetTestAccountCredentials	Optional	System.Management.Automation.SwitchParameter	This flag resets the password for the test account that is used to perform this cmdlet. The password for the test account is typically reset every 7 days. Use of this flag forces a password reset at any time if it is required for security reasons.
TrustAnySSLCertificate	Optional	System.Management.Automation.SwitchParameter	This parameter allows the test to use any available SSL certificate to run the test.
URL	Optional	System.String	This parameter specifies the external URL for Exchange ActiveSync.
UseAutodiscoverForClientAccessServer	Optional	System.Management.Automation.SwitchParameter	This parameter specifies whether the test should use the Autodiscover service to locate the Client Access server computer.

Detailed Description

The Test-ActiveSyncConnectivity cmdlet performs a full synchronization between a mobile device and a specified mailbox to test the functionality of Exchange ActiveSync. If the synchronization fails, a message is displayed in the Exchange Management Shell.

To run the Test-ActiveSyncConnectivity cmdlet, the account you use must be delegated the following:

Exchange Server Administrator role and local Administrators group for the target server

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

The following code example tests the Exchange ActiveSync connectivity for the mailbox PaulA.

	Copy Code
Test-ActiveSyncConnectivity -MailboxCredential "PaulA"