配置 POP3 和 IMAP4 协议日志记录

适用于：Exchange Server 2013

可以使用 Shell 启用、禁用或修改 POP3 和 IMAP4 的协议日志记录设置。 默认情况下，不启用协议日志记录。

协议日志记录允许查看 Exchange 环境中的 POP3 和 IMAP4 连接。 如果要排查与 POP3 或 IMAP4 性能相关的问题，这将非常有用。 有关详细信息，请参阅 POP3 和 IMAP4 的协议日志记录。 有关 POP3 和 IMAP4 的详细信息，请参阅 2013 Exchange Server 中的 POP3 和 IMAP4。

在开始之前，您需要知道什么？

• 估计完成时间：5 分钟。

• 您必须先获得权限，然后才能执行此过程或多个过程。 若要查看所需的权限，请参阅 客户端和移动设备权限主题中的"POP3 设置"和"IMAP4 设置"条目。

• 若要了解本主题中的过程可能适用的键盘快捷键，请参阅 Exchange 管理中心内的键盘快捷键。

使用命令行管理程序启用 POP3 或 IMAP4 的协议日志记录

此示例在客户端访问服务器 CAS01 上启用 IMAP4 或 POP3 的协议日志记录。

Set-ImapSettings -Server "CAS01" -ProtocolLogEnabled $true
Set-PopSettings -Server "CAS01" -ProtocolLogEnabled $true

有关详细的语法和参数信息，请参阅 Set-ImapSettings 和 Set-PopSettings。

使用命令行管理程序禁用 POP3 或 IMAP4 的协议日志记录

此示例在客户端访问服务器 CAS01 上禁用 IMAP4 或 POP3 的协议日志记录。

Set-ImapSettings -Server "CAS01" -protocolLogEnabled $false
Set-PopSettings -Server "CAS01" -protocolLogEnabled $false

有关详细的语法和参数信息，请参阅 Set-ImapSettings 和 Set-PopSettings。

使用命令行管理程序修改 POP3 或 IMAP4 的协议日志记录

若要修改 POP3 或 IMAP4 日志记录设置，请使用以下一个或多个参数运行 Set-ImapSettings 或 Set-PopSettings cmdlet。

• LogFileLocation：此参数指定 POP3 或 IMAP4 协议日志文件的位置。 默认情况下，POP3 协议日志文件位于 C：\Program Files\Microsoft\Exchange Server\V15\Logging\Pop3 目录中。 此示例在客户端访问服务器 CAS01 上打开 POP3 协议日志记录。 它还会将 POP3 协议日志记录目录更改为 C：\Pop3Logging。

  Set-PopSettings -Server "CAS01" -ProtocolLogEnabled $true -LogFileLocation "C:\Pop3Logging"
  

• LogFileRollOverSettings：此参数定义 POP3 或 IMAP4 协议日志记录创建新日志文件的频率。 默认情况下，每天都会创建新的日志文件。 可能的值有：

  每小时

  每天

  每周

  每月

  仅当 LogPerFileSizeQuota 参数的值设置为零时，此设置才适用。 本示例将客户端访问服务器 CAS01 上的 POP3 协议日志记录更改为每小时创建新的日志文件。

  Set-PopSettings -Server "CAS01" -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly
  

• LogPerFileSizeQuota：此参数定义 POP3 或 IMAP4 协议日志文件的最大大小（以字节为单位）。 默认情况下，此值设置为零。 当此值设置为零时，将按 LogFileRollOverSettings 参数指定的频率创建新的协议日志文件。

  此示例在客户端访问服务器 CAS01 上将 POP3 协议日志记录更改为在日志文件达到 2 MB 时创建一个新的日志文件。

  Set-PopSettings -Server "CAS01" -LogPerFileSizeQuota 2000000
  

  此示例在客户端访问服务器 CAS01 上将 POP3 协议日志记录更改为使用相同日志文件，而不考虑其创建日期和大小。

  Set-PopSettings -Server "CAS01" -LogPerFileSizeQuota unlimited
  

有关详细的语法和参数信息，请参阅 Set-ImapSettings 和 Set-PopSettings。

如何知道操作成功？

在 Shell 中运行以下命令，验证 POP3 协议日志记录设置。 如果启用了 POP3 协议日志记录，则 ProtocolLogEnabled 参数 True的值为 。 如果禁用 POP3 协议日志记录，则值为 False。 还可以确保 LogFileLocation、 LogPerFileSizeQuota 和 LogFileRollOverSettings 参数的值正确。

Get-PopSettings | format-list

在 Shell 中运行以下命令，验证 IMAP4 协议日志记录设置。 如果启用了 IMAP4 协议日志记录，则 ProtocolLogEnabled 参数 True的值为 。 如果禁用 IMAP4 协议日志记录，则值为 False。 还可以确保 LogFileLocation、 LogPerFileSizeQuota 和 LogFileRollOverSettings 参数的值正确。

Get-ImapSettings | format-list

详细信息

配置 POP3 和 IMAP4 的协议日志记录设置之后，您可能还需要：

启动和停止 IMAP4 服务

启动和停止 POP3 服务