Set-IMAPSettings (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-11

使用 Set-IMAPSettings cmdlet 可以为安装了客户端访问服务器角色与正在运行 IMAP4 服务的 Microsoft Exchange Server 2007 服务器设置特定的 Internet 邮件访问协议 4rev1 版本 (IMAP4) 设置。

语法

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 cmdlet 可以为正在运行 IMAP4 服务的 Exchange 2007 客户端访问服务器设置特定的 IMAP4 设置。可以对安装了 IMAP4 服务的单台客户端访问计算机运行此 cmdlet，也可以对安装了 IMAP4 服务的所有 Exchange 2007 客户端访问服务器运行此 cmdlet。

若要运行 Set-IMAPSettings cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

AuthenticatedConnectionTimeout

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定在关闭经过身份验证的空闲连接之前要等待的时间。默认设置为 1800 秒。可能的值从 30 秒到 86,400 秒。

Banner

可选

System.String

此参数指定在与客户端访问服务器建立连接之后显示的标题字符串。

CalendarItemRetrievalOption

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

此参数指定在使用 IMAP4 访问日历时返回的日历项类型。可以使用下列值：

  • 0:Calendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

如果使用 3:Custom，则必须指定 OWAServerUrl 设置。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于从 Active Directory 目录服务检索数据域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

Instance 参数指定通过管道传递给此命令供其使用的 Active Directory 对象实例。

LoginType

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

此参数指定用于正在运行 IMAP4 服务的客户端访问服务器的身份验证设置。可能的值如下：

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

可选

System.Int32

此参数指定单个命令的最大大小。默认大小为 40 字节。可能的值从 40 字节到 1024 字节。

MaxConnectionFromSingleIP

可选

System.Int32

此参数指定特定服务器将从单个 IP 地址接受的连接数。默认值为 20。可能的值从 1 到 1000。

MaxConnections

可选

System.Int32

指定所指定的服务器将接受的连接总数。这包括通过身份验证和未通过身份验证的连接。默认大小为 2,000 字节。可能的值从 1 字节到 25,000 字节。

MaxConnectionsPerUser

可选

System.Int32

此参数指定客户端访问服务器将从特定用户接受的最大连接数。默认值为 10。可能的值从 1 到 1000。

MessageRetrievalMimeFormat

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

此参数指定从服务器检索的邮件格式。可能的值如下：

  • 0：仅文本

  • 1：仅 HTML

  • 2：HTML 和文本

  • 3：仅 RTF

  • 4：UUEncode

  • 5：UUEncodeBinHex

  • 6：最佳正文格式

OwaServerUrl

可选

System.String

此参数指定要从其检索自定义 Outlook Web Access 日历项实例的日历信息的客户端访问服务器。

PreAuthenticatedConnectionTimeout

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定在关闭未经过身份验证的空闲连接之前要等待的时间。默认设置为 60 秒。可能的值从 10 秒到 3600 秒。

ProxyTargetPort

可选

System.Int32

此参数指定客户端访问服务器上的 IMAP4 服务要将命令中继到的 Exchange Server 2003 后端服务器端口。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

此参数指定组织中要为其指定 IMAP 设置的单台客户端访问服务器。

ShowHiddenFoldersEnabled

可选

System.Boolean

如果指定了此参数，则将可以看到隐藏的文件夹。默认值为 $false。

SSLBindings

可选

Microsoft.Exchange.Data.MultiValuedProperty

如果指定了此参数，cmdlet 将返回用于安全套接字层 (SSL) 会话的通信的 IP 端口。

UnencryptedOrTLSBindings

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定用于通过传输层安全性 (TLS) 加密连接或未加密连接进行通信的 IP 端口。

X509CertificateName

可选

System.String

该参数指定来自“相关主题”字段的 SSL 证书中的主机名称。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下代码示例对名为 CAS01 的客户端访问服务器设置 TLS IP 地址。

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