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

The Set-IMAPSettings cmdlet lets you set specific Internet Message Access Protocol version 4rev1 (IMAP4) settings for the Microsoft Exchange Server 2007 server that has the Client Access server role installed and that is running the IMAP4 service.

Syntax


Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar \| intranetUrl \| InternetUrl \| Custom>] [-DomainController <Fqdn>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin \| PlainTextAuthentication \| SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true \| $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-X509CertificateName <String>]

Set-ImapSettings [-AuthenticatedConnectionTimeout
<EnhancedTimeSpan>] [-Banner <String>]
[-CalendarItemRetrievalOption <iCalendar | intranetUrl |
InternetUrl | Custom>] [-DomainController <Fqdn>]
[-Instance <Imap4AdConfiguration>] [-LoginType
<PlainTextLogin | PlainTextAuthentication | SecureLogin>]
[-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP
<Int32>] [-MaxConnections <Int32>]
[-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat
<TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly
| TextEnrichedAndTextAlternative | BestBodyFormat>]
[-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout
<EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server
<ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true |
$false>] [-SSLBindings <MultiValuedProperty>]
[-UnencryptedOrTLSBindings <MultiValuedProperty>]
[-X509CertificateName <String>]

Parameters

Parameter	Required	Type	Description
AuthenticatedConnectionTimeout	Optional	Microsoft.Exchange.Data.EnhancedTimeSpan	This parameter specifies the period of time to wait before closing an idle authenticated connection. The default setting is 1800 seconds. The possible values are from 30 to 86,400 seconds.
Banner	Optional	System.String	This parameter specifies the banner string that is displayed after a connection to a Client Access server has been established.
CalendarItemRetrievalOption	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions	This parameter specifies the type of calendar item that is returned when the calendar is accessed by using IMAP4. The following values are available: 0:Calendar 1:IntranetUrl 2:InternetUrl 3:Custom If you are using 3:Custom, you must specify the OWAServerUrl setting.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration	The Instance parameter specifies an instance of an Active Directory object that is piped to and consumed by this command.
LoginType	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions	This parameter specifies the authentication setting that is used for the Client Access server that is running the IMAP4 service. The possible values are as follows: 1:PlainTextLogin 2:PlainTextAuthentication 3:SecureLogin
MaxCommandSize	Optional	System.Int32	This parameter specifies the maximum size of a single command. The default size is 40 bytes. The possible values are from 40 to 1024 bytes.
MaxConnectionFromSingleIP	Optional	System.Int32	This parameter specifies the number of connections that the specified server will accept from a single IP address. The default value is 20. The possible values are from 1 to 1000.
MaxConnections	Optional	System.Int32	Specifies the total number of connections the specified server will accept. This includes authenticated and unauthenticated connections. The default size is 2,000 bytes. The possible values are from 1 to 25,000.
MaxConnectionsPerUser	Optional	System.Int32	This parameter specifies the maximum number of connections that the Client Access server will accept from a particular user. The default value is 10. The possible values are from 1 to 1000.
MessageRetrievalMimeFormat	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat	This parameter specifies the format of the messages that are retrieved from the server. The possible values are as follows: 0:Text Only 1:HTML Only 2:HTML and Text 3:Rich Text Only 4:UUEncode 5:UUEncodeBinHex 6:Best Body Format
OwaServerUrl	Optional	System.String	This parameter specifies the Client Access server from which to retrieve calendar information for instances of custom Outlook Web Access calendar items.
PreAuthenticatedConnectionTimeout	Optional	Microsoft.Exchange.Data.EnhancedTimeSpan	This parameter specifies the period of time to wait before closing an idle connection that is not authenticated. The default setting is 60 seconds. The possible values are from 10 to 3600 seconds.
ProxyTargetPort	Optional	System.Int32	This parameter specifies the port on the Exchange Server 2003 back-end server to which the IMAP4 service on a Client Access server will relay commands.
Server	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	This parameter specifies an individual Client Access server in your organization for which you are specifying IMAP settings.
ShowHiddenFoldersEnabled	Optional	System.Boolean	If this parameter is specified, hidden folders will be visible. The default value is `$false`.
SSLBindings	Optional	Microsoft.Exchange.Data.MultiValuedProperty	If this parameter is specified, the cmdlet returns the IP port to use for communication for a Secure Sockets Layer (SSL) session.
UnencryptedOrTLSBindings	Optional	Microsoft.Exchange.Data.MultiValuedProperty	This parameter specifies the IP port for communication over the Transport Layer Security (TLS) encrypted connection or the connection that is not encrypted.
X509CertificateName	Optional	System.String	This parameter specifies the host name in the SSL certificate from the Associated Subject field.

Detailed Description

The Set-IMAPSettings cmdlet lets you set specific IMAP4 settings for the Exchange 2007 Client Access server that is running the IMAP4 service. You can run this cmdlet for a single Client Access server that has the IMAP4 service installed, or for all Exchange 2007 Client Access servers that have the IMAP4 service installed.

To run the Set-IMAPSettings 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 sets the IPAddress for TLS on the Client Access server that is named CAS01.

	Copy Code
Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953