Export (0) Print
Expand All

Get-ActiveSyncVirtualDirectory

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Use the Get-ActiveSyncVirtualDirectory cmdlet to retrieve the Microsoft Exchange ActiveSync settings configured on the Exchange ActiveSync Web site.


Get-ActiveSyncVirtualDirectory [-Identity <VirtualDirectoryIdParameter>] [-DomainController <Fqdn>]


Get-ActiveSyncVirtualDirectory -Server <ServerIdParameter> [-DomainController <Fqdn>]

Parameter Required Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter uniquely identifies a physical server. When this parameter is set, the command returns information configured on all virtual directories available on that server.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

The Identity parameter uniquely identifies an Exchange ActiveSync virtual directory on a physical server. If this value isn't set, this command returns information configured on all Exchange ActiveSync Web sites available across all Client Access servers in the Exchange organization.

Microsoft Exchange Server 2010 contains a default virtual directory that Exchange ActiveSync devices use to synchronize with the server. You can create multiple virtual directories and assign different devices to different directories. The Get-ActiveSyncVirtualDirectory cmdlet retrieves a variety of settings for the virtual directory.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Exchange ActiveSync virtual directory settings" entry in the Client Access Permissions topic.

Parameter Description

BasicAuthEnabled

A Boolean value that enables Basic authentication. By default, Basic authentication is disabled if Secure Sockets Layer (SSL) isn't enabled on the Exchange ActiveSync server.

ClientCertEnabled

A Boolean value that enables the mobile phone to use a client certificate. By default, this is enabled and the client requests a client certificate.

ClientCertProvisioningEnabled

A Boolean value that defines whether the server can send the client authentication configuration settings to the mobile phone. This is available only if the ClientCertEnabled parameter is set to $true.

ClientCertTemplateName

A string that defines the template name required in the certification request sent by the mobile phone to the certification authority (CA).

ClientCertURL

A string that defines the link to the CA that provides client certificates.

CompressionEnabled

An integer that identifies the compression applied to the specified Exchange ActiveSync virtual directory.

IsEnabled

A Boolean value that indicates whether the user account is enabled for Exchange ActiveSync.

IsValid

A Boolean value that indicates whether the user's Active Directory account is valid.

MobileSyncURL

A string that defines the URL to the Exchange ActiveSync server. This is configured on the server and then sent to the mobile phone.

WebsiteName

A string that defines the name of the Exchange ActiveSync Web site to which the mobile phone connects.

VirtualDirectoryName

A string that defines the name of the Exchange ActiveSync virtual directory. This is always Microsoft-Server-ActiveSync.

Error Description

 

 

Exceptions Description

 

 

This example returns the settings for the Exchange ActiveSync virtual directory on the server CAS-01.

Get-ActiveSyncVirtualDirectory -Server "CAS-01"

This example returns the settings for a specific Exchange ActiveSync virtual directory on the server CAS-01.

Get-ActiveSyncVirtualDirectory -Server "CAS-01" -Identity "Microsoft-Server-ActiveSync"

This example returns the settings for the Exchange ActiveSync virtual directory on the server CAS-01, for the domain controller DOM-01.

Get-ActiveSyncVirtualDirectory -Server "CAS-01" -DomainController "DOM-01"
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft