Set-IMAPSettings

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-05-15

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

语法

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

详细说明

使用 Set-IMAPSettings cmdlet 可以为正在运行 IMAP4 服务的 Exchange 2007 客户端访问服务器设置特定的 IMAP4 设置。可以对安装了 IMAP4 服务的单台客户端访问计算机运行此 cmdlet，也可以对安装了 IMAP4 服务的所有 Exchange 2007 客户端访问服务器运行此 cmdlet。

若要运行 Set-IMAPSettings cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。

有关管理 Exchange 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 设置。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

EnableExactRFC822Size

可选

System.Boolean

EnableExactRFC822Size 参数用于返回邮箱中每封电子邮件的准确 RFC822.SIZE 值。

默认情况下，Exchange 2007 会估计 RFC822.SIZE 值，因为 Exchange 2007 必须重新生成 MIME 以确定实际的大小。如果邮箱包括大型邮件或包含深层嵌套附件的邮件，重建 MIME 可能会影响性能。但是，某些电子邮件客户端可能会要求 RFC822.SIZE 值是确切值而非估计值。

若要使每个人都知道确切大小，请运行以下命令：

Set-ImapSettings -EnableExactRFC822Size:$true

若要仅使特定用户知道确切大小，请运行以下命令：

Set-CASMailbox <IMAP_User_Name> -ImapUseProtocolDefaults:$false -ImapEnableExactRFC822Size:$true

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

此参数指定单个命令的最大大小。默认大小为 10240 字节。可能的值的范围为 1024 字节到 16384 字节之间。

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：最佳正文格式

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 端口。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

X509CertificateName

可选

System.String

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

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

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