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

The Set-ActiveSyncVirtualDirectory command enables you to configure the Microsoft ActiveSync settings on a specified virtual directory.

Syntax

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]
Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

This parameter uniquely identifies the Exchange ActiveSync virtual directory that is to be configured. This value must be website\microsoft-server-activesync.

ActiveSyncServer

Optional

System.String

This parameter specifies the URL of the Client Access server. It will be in the following format: https://servername/Microsoft-Server-ActiveSync.

BadItemReportingEnabled

Optional

System.Boolean

This parameter specifies whether items that cannot be synchronized should be reported to the user. If set to $true, the user receives a notification when an item cannot be synchronized to the mobile device.

BasicAuthEnabled

Optional

System.Boolean

This parameter enables or disables Basic authentication. The default setting is $true.

ClientCertAuth

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

This parameter specifies the status of client certificate authentication. By default, client certificate authentication is disabled . The default value of this parameter is $null.

CompressionEnabled

Optional

System.Boolean

This parameter is an integer that identifies the compression applied to the specified Exchange ActiveSync virtual directory. The default setting is $true.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the command.

ExternalAuthenticationMethods

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the authentication methods that are supported by the server that contains the virtual directory when access is requested from outside the network firewall. If this parameter is not set, all authentication methods can be used.

ExternalUrl

Optional

System.Uri

This parameter specifies the URL that is used to connect to the virtual directory from outside the network firewall.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

The Instance parameter enables you to pass a whole object to the command to be processed. It is mainly used in scripts where a whole object must be passed to the command.

InternalAuthenticationMethods

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the authentication methods that are supported by the server that contains the virtual directory when access is requested from inside the network firewall. If this parameter is not set, all authentication methods can be used.

InternalUrl

Optional

System.Uri

This parameter is used for the Client Access server HTTP Proxy feature. If it is set, the Client Access server that is receiving the incoming client connections will proxy the requests to this URL. This can be an Internet- facing fully qualified domain name (FQDN) URL or an internal host name.

MobileClientCertificateAuthorityURL

Optional

System.String

This parameter specifies the URL for the certification authority(CA) that is used by the mobile device.

MobileClientCertificateProvisioningEnabled

Optional

System.Boolean

This parameter specifies whether the Autodiscover service will return the Certificate Services Server URL in the XML file.

MobileClientCertTemplateName

Optional

System.String

This parameter specifies the template name for the client certificate.

Name

Optional

System.String

This parameter specifies the name of the Exchange ActiveSync virtual directory.

RemoteDocumentsActionForUnknownServers

Optional

System.Nullable

This parameter specifies the action that occurs when a Windows SharePoint Services or Windows file share request comes in via Exchange ActiveSync. When a request comes in, Exchange ActiveSync will look for the requested host name in the Allow and Block lists. If the host name is not found in either list, the action specified in this parameter, either Block or Allow, will be performed.

RemoteDocumentsAllowedServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter is a multivalued property that lists all the allowed servers for remote document access.

RemoteDocumentsBlockedServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter is a multivalued property that lists all the blocked servers for remote document access.

RemoteDocumentsInternalDomainSuffixList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter is used in organizations that do not run WINS in their network. In these environments, you can specify one or more FQDNs that Exchange ActiveSync treats as internal when a request for remote file access is received.

Detailed Description

The Set-ActiveSyncVirtualDirectory command enables you to configure a variety of settings on the virtual directory that is used for Exchange ActiveSync.

To run the Set-ActiveSyncVirtualDirectory 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 disables Basic authentication on the default Exchange ActiveSync virtual directory on the server named Contoso.

Copy Code
Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false