使用英语阅读

通过

配置 POP3 和 IMAP4 协议日志记录

  • 项目
  • 2023/04/04

适用于：Exchange Server 2013

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

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

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

提示

是否有任何疑问？ 在 Exchange 论坛中寻求帮助。 访问 Exchange Server 的论坛。

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

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

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

备注

更改 POP3 或 IMAP4 的协议日志记录设置后，必须重启正在使用的服务：POP3 或 IMAP4。 有关如何重启 POP3 和 IMAP4 服务的信息，请参阅启动和停止 POP3 服务和启动和停止 IMAP4 服务。

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

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

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

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

备注

更改 POP3 或 IMAP4 的协议日志记录设置后，必须重启正在使用的服务：POP3 或 IMAP4。 有关如何重启 POP3 和 IMAP4 服务的信息，请参阅启动和停止 POP3 服务和启动和停止 IMAP4 服务。

有关详细语法和参数信息，请参阅 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

备注

更改 POP3 或 IMAP4 的协议日志记录设置后，必须重启正在使用的服务：POP3 或 IMAP4。 有关如何重启 POP3 和 IMAP4 服务的信息，请参阅启动和停止 POP3 服务和启动和停止 IMAP4 服务。

有关详细语法和参数信息，请参阅 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 服务