Set-OutlookAnywhere (RTM)

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007

The Set-OutlookAnywhere cmdlet is used to modify the properties on a computer that is running Microsoft Exchange 2007 that has the Client Access server role installed and is enabled for Outlook Anywhere.

Syntax

Set-OutlookAnywhere [-DomainController <Fqdn>] [-Identity <VirtualDirectoryIdParameter>] [-ExternalAuthenticationMethod <Basic | Digest | Ntlm | Fba | WindowsIntegrated | Misconfigured>] [-ExternalHostname <Hostname>] [-Instance <ADRpcHttpVirtualDirectory>] [-Name <String>] [-SSLOffloading <$true | $false>]

Detailed Description

The Set-OutlookAnywhere cmdlet is used to modify the properties on an Exchange 2007 Client Access server that is enabled for Outlook Anywhere.

To run the Set-OutlookAnywhere 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.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

This parameter specifies the name or GUID of the virtual directory. It is represented as: ServerName\VirtualDirectoryName (WebsiteName).

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

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

ExternalAuthenticationMethod

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod

This parameter specifies the authentication method to use in the HTTP connections between Microsoft Outlook and the firewall, and between the firewall and the /rpc virtual directory on the Client Access server that is enabled for Outlook Anywhere. This authentication method can be set to Basic or NTLM.

ExternalHostname

Optional

Microsoft.Exchange.Data.Hostname

This parameter specifies the external host name to use in the Outlook profiles for users who are enabled for Outlook Anywhere.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADRpcHttpVirtualDirectory

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

Name

Optional

System.String

Use the name parameter to specify name of the user. 

SSLOffloading

Optional

System.Boolean

This parameter specifies whether the Client Access server requires Secure Sockets Layer (SSL). This value should be set only to $true when an SSL hardware solution is running in front of the Client Access server.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

This code example sets the external authentication method to NTLM for the Client Access server named CAS01.

Set-OutlookAnywhere -Name:CAS01 -ExternalAuthenticationMethod:NTLM