导出 (0) 打印
全部展开
展开 最小化

Set-ImapSettings

 

适用于: Exchange Server 2013

上一次修改主题: 2014-03-05

此 cmdlet 只在本地 Exchange Server 2013 中可用。

使用 Set-ImapSettings cmdlet 可以为安装了客户端访问服务器角色并且正在运行 Microsoft Exchange IMAP4 服务的运行 Microsoft Exchange Server 2013 的服务器设置特定的 IMAP4 设置。

有关以下语法部分的参数设置的详细信息,请参阅语法

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-EnableGSSAPIAndNTLMAuth <$true | $false>] [-EnforceCertificateErrors <$true | $false>] [-ExtendedProtectionPolicy <None | Allow | Require>] [-ExternalConnectionSettings <MultiValuedProperty>] [-InternalConnectionSettings <MultiValuedProperty>] [-LiveIdBasicAuthReplacement <$true | $false>] [-LogFileLocation <String>] [-LogFileRollOverSettings <Hourly | Daily | Weekly | Monthly>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-LogPerFileSizeQuota <Unlimited>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <Uri>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProtocolLogEnabled <$true | $false>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-SuppressReadReceipt <$true | $false>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

此示例将纯文本或 TLS 连接设置为客户端访问服务器 CAS01。在本示例中,连接使用的 IP 地址为 10.0.0.0,使用的端口号为 995。

Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings 10.0.0.0:995

本示例将启用 IMAP4 协议日志记录。还会将 IMAP4 协议日志记录目录更改为 C:\Imap4Logging。

Set-ImapSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Imap4Logging"

本示例将 IMAP4 协议日志记录更改为在日志文件达到 2 MB 时创建新的日志文件。

Set-ImapSettings -LogPerFileSizeQuota 2000000

本示例将 IMAP4 协议日志记录更改为每小时创建一个新的日志文件。

Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

可以对安装了 Microsoft Exchange IMAP4 服务的单台客户端访问计算机运行 Set-ImapSettings cmdlet,也可以对安装了 Microsoft Exchange IMAP4 服务的所有 Exchange 客户端访问服务器运行此 cmdlet。

您必须先获得权限,然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数未包含在分配给您的权限中,则您无法访问这些参数。若要查看所需的权限,请参阅客户端和移动设备权限主题中的“IMAP4 设置”条目。

 

参数 必需 类型 说明

AuthenticatedConnectionTimeout

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

AuthenticatedConnectionTimeout 参数指定在关闭经过身份验证的空闲连接之前要等待的时间。

若要指定值,请以时间跨度的形式输入:dd.hh:mm:ss,其中 d = 天数,h = 小时数,m = 分钟数,s = 秒数。

此参数的有效输入值为 00:00:301:00:00。默认设置为 00:30:00(即 30 分钟)。

Banner

可选

System.String

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

CalendarItemRetrievalOption

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

CalendarItemRetrievalOption 参数指定在使用 IMAP4 访问日历时返回的日历项类型。默认值为 iCalendar。可以使用数值或文本字符串指定此参数的值。可以使用下列值:

  • 0 或者iCalendar

  • 1 或者intranetUrl

  • 2 或者InternetUrl

  • 3 或者Custom

如果使用 3Custom,则必须指定 OwaServerUrl 参数设置。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 开关将导致命令暂停处理,并需要您在继续处理之前确认该命令将执行的操作。您无需使用 Confirm 开关指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定将此配置更改写入 Active Directory 的域控制器的完全限定域名 (FQDN)。

EnableExactRFC822Size

可选

System.Boolean

EnableExactRFC822Size 参数计算可以从服务器检索的每封 MIME 邮件的确切大小。将此参数设置为 $true 时,存储在 Exchange 服务器上的 MIME 邮件的确切大小将对于需要知道每封 MIME 邮件的确切大小的 POP3 或 IMAP4 客户端程序可用。

注释注意:
默认情况下,此参数设置为 $false。如果没有将此选项设置为 $true,则 Exchange 服务器返回到 POP3 和 IMAP4 客户端程序的每封 MIME 邮件的大小可能与邮件的确切大小稍有不同。由于将此选项设置为 $true 可能会对性能产生负面影响,因此,只有当许多用户使用的客户端需要知道 MIME 邮件的确切大小时,才应使用此选项。

EnableGSSAPIAndNTLMAuth

可选

System.Boolean

EnableGSSAPIAndNTLMAuth 参数指定连接是否可以通过通用安全服务应用程序编程接口 (GSSAPI),来使用集成 Windows 身份验证 (NTLM)。此设置适用于禁用传输层安全性 (TLS) 情况下的连接。默认情况下,此参数设置为 $true。可以通过将值设置为 $false,来禁用 IMAP4 连接的 NTLM。在 Microsoft Exchange Server 2010 正式发布版 (RTM) 中,NTLM 身份验证不支持 IMAP4 连接。在 Exchange 2010 Service Pack 1 (SP1) 中重新提供了对 IMAP4 连接的 NTLM 身份验证的支持。

EnforceCertificateErrors

可选

System.Boolean

EnforceCertificateErrors 参数指定是否实施有效的安全套接字层 (SSL) 证书。要使用此参数,请指定要为其实施有效 SSL 证书的目标客户端访问服务器。如果 EnforceCertificateErrors 参数设置为 $true,而且代理服务器的目标证书无效,则代理服务器的登录尝试将失败。

默认设置是 $false

ExtendedProtectionPolicy

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

ExtendedProtectionPolicy 参数指定要如何将针对验证的扩展保护用于 IMAP4 连接。默认情况下,此参数设置为 None。可能的值是:

  • None 不使用身份验证扩展保护。

  • Allow   仅当连接的 IMAP4 连接支持时才使用针对验证的扩展保护。否则,建立的连接将不具有身份验证扩展保护功能。

  • Require   所有 IMAP4 连接都需要针对验证的扩展保护。如果连接的主机不支持身份验证扩展保护,则会拒绝连接。

身份验证扩展保护在使用集成的 Windows 身份验证对网络连接进行身份验证时增强了对凭据的保护和处理。集成的 Windows 身份验证也称为 NTLM。如果使用的是集成的 Windows 身份验证,强烈建议您使用身份验证的扩展保护。要使用针对验证的扩展保护,客户端和服务器计算机必须满足特定要求。这些要求包括操作系统要求和安全更新要求。此外,IMAP4 客户端程序还必须支持针对验证的扩展保护的使用。

ExternalConnectionSettings

可选

Microsoft.Exchange.Data.MultiValuedProperty

ExternalConnectionSettings 参数指定当 IMAP4 客户端从公司网络外部连接到其电子邮件时 Exchange 使用的主机名、端口和加密类型。

输入以下格式的值:<主机名>:<端口>:<加密类型>。对于具有多值属性的值,其 <加密类型> 部分是可选的。<加密类型> 的有效值为 TLS(传输层安全)或 SSL。

InternalConnectionSettings

可选

Microsoft.Exchange.Data.MultiValuedProperty

InternalConnectionSettings 参数指定当 IMAP4 客户端从公司网络内部连接到其电子邮件时使用的主机名、端口和加密类型。将用户连接转发到另一台客户端访问服务器时,还可以使用此设置指定使用的主机名、端口和加密类型。

输入以下格式的值:<主机名>:<端口>:<加密类型>。对于具有多值属性的值,其 <加密类型> 部分是可选的。<加密类型> 的有效值为 TLS 或 SSL。如果服务器名称为 Server01,域为 Contoso.com,则默认值为 Server01.Contoso.com:993:SSL, Server01.Contoso.com:143:TLS

LiveIdBasicAuthReplacement

可选

System.Boolean

保留此参数以供 Microsoft 内部使用。

LogFileLocation

可选

System.String

LogFileLocation 参数指定 IMAP4 协议日志文件的位置。默认情况下,IMAP4 协议日志文件位于 C:\Program Files\Microsoft\Exchange Server\V15\Logging\Imap4 目录下。

LogFileRollOverSettings

可选

Microsoft.Exchange.Diagnostics.LogFileRollOver

LogFileRollOverSettings 参数指定 IMAP4 协议日志记录创建新日志文件的频率。默认情况下,每天创建一个新的日志文件。可以使用数值或文本字符串指定此参数的值。可能的值是:

  • 1 或者Hourly

  • 2 或者Daily

  • 3 或者Weekly

  • 4 或者Monthly

此设置仅适用于将 LogPerFileSizeQuota 参数的值设置为 0 时。

LoginType

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

LoginType 参数指定用于运行 Microsoft Exchange IMAP4 服务的客户端访问服务器的身份验证设置。默认值为 SecureLogin。可以使用数值或文本字符串指定此参数的值。可能的值是:

  • 1 或者PlainTextLogin

  • 2 或者PlainTextAuthentication

  • 3 或者SecureLogin

LogPerFileSizeQuota

可选

Microsoft.Exchange.Data.Unlimited

LogPerFileSizeQuota 参数指定 IMAP4 协议日志文件的最大大小(以字节为单位)。默认情况下,此值设置为 0。将此值设置为 0 时,将按照 LogFileRollOverSettings 参数指定的频率创建新的协议日志文件。

MaxCommandSize

可选

System.Int32

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

MaxConnectionFromSingleIP

可选

System.Int32

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

MaxConnections

可选

System.Int32

MaxConnections 参数指定特定的服务器将接受的连接总数。这包括通过身份验证和未通过身份验证的连接。默认值为 2147483647。可能的值从 1 到 2147483647。

MaxConnectionsPerUser

可选

System.Int32

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

MessageRetrievalMimeFormat

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

MessageRetrievalMimeFormat 参数指定从服务器检索的邮件格式。默认值为 BestBodyFormat。可以使用数值或文本字符串指定此参数的值。可能的值是:

  • 0 或者TextOnly

  • 1 或者HtmlOnly

  • 2 或者HtmlAndTextAlternative

  • 3 或者TextEnrichedOnly

  • 4 或者TextEnrichedAndTextAlternative

  • 5 或者BestBodyFormat

  • 6 或者Tnef

有关详细信息,请参阅配置 POP3 和 IMAP4 的邮件检索格式选项

OwaServerUrl

可选

System.Uri

OwaServerUrl 参数指定客户端访问服务器,以便从其中检索自定义 Microsoft Office Outlook Web App 日历项实例的日历信息。

PreAuthenticatedConnectionTimeout

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

PreAuthenticatedConnectionTimeout 参数指定在关闭未经过身份验证的空闲连接之前要等待的时间。

若要指定值,请以时间跨度的形式输入:dd.hh:mm:ss,其中 d = 天数,h = 小时数,m = 分钟数,s = 秒数。

此参数的有效输入为 00:00:301:00:00。默认值为 00:01:00(即一分钟)。

ProtocolLogEnabled

可选

System.Boolean

ProtocolLogEnabled 参数指定是否启用协议日志记录。有关详细信息,请参阅配置 POP3 和 IMAP4 的协议日志记录

ProxyTargetPort

可选

System.Int32

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

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 参数指定组织中要为其指定 IMAP4 设置的单个客户端访问服务器。

ShowHiddenFoldersEnabled

可选

System.Boolean

ShowHiddenFoldersEnabled 参数指定隐藏的文件夹是否可见。如果将该值设置为 $true,则隐藏的文件夹可见。默认值为 $false

SSLBindings

可选

Microsoft.Exchange.Data.MultiValuedProperty

SSLBindings 参数指定该命令是否设置要用于 SSL 会话通信的 IP 地址和端口号。这是一个多值属性。输入以下格式的值:<IP 地址>:<端口号>。默认值为 0.0.0.0:993

SuppressReadReceipt

可选

System.Boolean

SuppressReadReceipt 参数指定是否停止将重复的已读回执发送到在其 IMAP4 电子邮件程序中使用“为我发送的邮件发送已读回执”选项的 IMAP4 发件人。默认情况下,此选项设置为 $false。默认情况下,使用“为我发送的邮件发送已读回执”选项的 IMAP4 发件人在下列两种情况下会收到已读回执:

  • 收件人下载他们发送的邮件时。

  • 收件人打开邮件时。

此参数的有效值和说明如下:

  • $false 每次收件人下载邮件时,将向 IMAP4 用户发送已读回执。此外,在用户打开邮件时,也会向 IMAP4 用户发送已读回执。

  • $true 在其电子邮件客户端程序中使用“为我发送的邮件发送已读回执”选项的 IMAP4 用户仅在收件人打开邮件时会收到已读回执。

UnencryptedOrTLSBindings

可选

Microsoft.Exchange.Data.MultiValuedProperty

UnencryptedOrTLSBindings 参数为通过 TLS 加密连接或未加密连接的通信指定 IP 地址和端口号。这是一个多值属性。输入以下格式的值:<IP 地址>:<端口号>。默认值为 0.0.0.0:143

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 开关指示命令模拟对对象执行的操作。通过使用 WhatIf 开关,您可以查看要发生的更改,而无需应用这些更改中的任何更改。您无需使用 WhatIf 开关指定值。

X509CertificateName

可选

System.String

X509CertificateName 参数指定来自“相关主题”字段的 SSL 证书中的主机名称。这是一个既包含 IP 地址又包含端口设置的多值属性。输入以下格式的值:<IP 地址>:<端口号>。

要查看此 cmdlet 接受的输入类型,请参阅 Cmdlet 输入和输出类型。如果 cmdlet 的输入类型字段为空,则 cmdlet 不接受输入数据。

要查看此 cmdlet 接受的返回类型(也称为输出类型),请参阅 Cmdlet 输入和输出类型。如果输出类型字段为空,则 cmdlet 不返回数据。

 
本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft