Enable-OutlookAnywhere

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

The Enable-OutlookAnywhere cmdlet enables the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed for Outlook Anywhere. Running this cmdlet enables the server to accept requests from Microsoft Office Outlook 2007 and Outlook 2003 client computers from the Internet by using Outlook Anywhere, also known as RPC over HTTP.

Syntax

Enable-OutlookAnywhere -DefaultAuthenticationMethod <Basic | Digest | Ntlm | Fba | WindowsIntegrated | Misconfigured> -ExternalHostname <Hostname> -SSLOffloading <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Enable-OutlookAnywhere -ClientAuthenticationMethod <Basic | Digest | Ntlm | Fba | WindowsIntegrated | Misconfigured> -ExternalHostname <Hostname> -SSLOffloading <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IISAuthenticationMethods <MultiValuedProperty>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detailed Description

The Enable-OutlookAnywhere cmdlet enables the Exchange 2007 Client Access server for Outlook Anywhere. This lets the server accept requests from Outlook 2007 and Outlook 2003 clients from the Internet by using Outlook Anywhere.

Important

This cmdlet can be successfully run only if the RPC over HTTP proxy Windows networking component is already installed.

Note

When you run this cmdlet, it can take as long as an hour for the settings to become effective, depending on how long it takes for Active Directory to replicate.

To run the Enable-OutlookAnywhere cmdlet, the account you use must be delegated the Exchange Server Administrator role and membership in the local Administrators group for the target server.

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

Parameters

Parameter	Required	Type	Description
ClientAuthenticationMethod	Required	Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod	This parameter specifies the authentication method that the Autodiscover service will provide to the Outlook Anywhere clients to authenticate to the Client Access server. The authentication method can be set to Basic or NTLM. Note This parameter must be specified if you do not use the DefaultAuthenticationMethod parameter. When you use this parameter without specifying the IISAuthenticationMethods parameter, the authentication method is set to both NTLM and Basic.
DefaultAuthenticationMethod	Required	Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod	This parameter can be used to set both the ClientAuthenticationMethod parameter and the IISAuthenticationMethods parameter to the same authentication value. When you set an authentication value by using the DefaultAuthenticationMethod parameter, you force the specified authentication method to be used on the /rpc virtual directory in Internet Information Services (IIS). The authentication method can be set to Basic or NTLM. Note If the DefaultAuthenticationMethod parameter is specified, neither the ClientAuthenticationMethod nor the IISAuthenticationMethods parameters can be used.
ExternalHostname	Required	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.
SSLOffloading	Required	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.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm parameter causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller, include the DomainController parameter on the cmdlet.
IISAuthenticationMethods	Optional	Microsoft.Exchange.Data.MultiValuedProperty	This parameter specifies the authentication methods that will be enabled on the /rpc virtual directory in IIS. When you use this parameter, all other authentication methods will be disabled. More than one value can be specified for this parameter by using a comma to separate the list of authentication methods. For example: NTLM, Basic.
Server	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	This parameter specifies the name of the Client Access server to be enabled for Outlook Anywhere.
TemplateInstance	Optional	System.Management.Automation.PSObject	When an existing object is supplied with this parameter, the cmdlet uses the configuration of that object to create an identical copy of the object on a local or target 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.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

This code example enables the server named Server01 for Outlook Anywhere. The external host name is set to mail.contoso.com, NTLM authentication is used, and SSL offloading is set to $true.

Enable-OutlookAnywhere -Server:Server01 -ExternalHostname:mail.contoso.com -ClientAuthenticationMethod:NTLM -SSLOffloading:$true