在 Exchange Server 中管理传输代理

  • 项目

传输代理使用 SMTP 事件对传输管道中运行的邮件进行操作。 Microsoft Exchange Server 2016 或 2019 附带的大多数内置传输代理是不可见且不可管理的。 然而，您可以在您组织中的 Exchange 服务器上安装和配置第三方传输代理。 有关传输代理的详细信息，请参阅 Exchange Server 中的传输代理。

开始前，有必要了解什么？

  • 估计完成每个步骤时间：10 分钟

  • 您必须先获得权限，然后才能执行此过程或多个过程。 若要查看所需的权限，请参阅 邮件流权限主题中的"传输代理"条目。

  • 只能使用 Exchange 命令行管理程序执行此过程。

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

提示

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

使用 Exchange 命令行管理程序安装传输代理

安装传输代理时，Exchange 只注册与该传输代理关联的 DLL。 需要确保已正确安装和配置传输代理所依赖的所有文件、注册表项和其他对象。 当 Exchange 加载了 DLL 之后，它会在命令完成后继续引用这些 DLL。

传输代理对其遇到的所有电子邮件都具有完全访问权限。 Exchange 对传输代理的行为没有任何限制。 不稳定的或带有安全缺陷的传输代理可能会影响 Exchange 的稳定性和安全性。 因此，您应该只安装自己完全信任并且已在测试环境中经过全面测试的传输代理。

在禁用状态下安装传输代理，以确保邮件流不受尚未配置的传输代理的影响。 因此，在正确配置了传输代理之后，需要启用该传输代理。

使用以下语法安装传输代理。

Install-TransportAgent -Name <TransportAgentIdentity> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">

本示例在传输服务中安装名为 Contoso 传输代理的虚构传输代理。

Install-TransportAgent -Name "Contoso Transport Agent" -TransportAgentFactory "vendor.exchange.ContosoTransportAgentfactory" -AssemblyPath "C:\Program Files\Vendor\TransportAgent\ContosoTransportAgentFactory.dll"

您如何知道这有效？

若要验证是否已成功安装传输代理，请运行 命令 Get-TransportAgent 并确认已列出传输代理。

使用 Exchange 命令行管理程序启用传输代理

使用以下语法启动传输代理。

Enable-TransportAgent <TransportAgentIdentity>

此示例在传输服务中启用名为 Contoso 传输代理的传输代理。

Enable-TransportAgent "Contoso Transport Agent"

您如何知道这有效？

若要验证是否已成功启用传输代理，请运行 命令 Get-TransportAgent | Format-List Name,Enabled 并确认传输代理已启用。

使用 Exchange 命令行管理程序禁用传输代理

使用以下语法禁用传输代理：

Disable-TransportAgent <TransportAgentIdentity>

此示例在传输服务中禁用名为 Fabrikam 传输代理的传输代理。

Disable-TransportAgent "Fabrikam Transport Agent"

您如何知道这有效？

若要验证是否已成功禁用传输代理，请运行 命令 Get-TransportAgent | Format-List Name,Enabled 并确认传输代理已禁用。

使用 Exchange 命令行管理程序查看传输代理

若要查看所有传输代理的摘要列表，请运行以下命令：

Get-TransportAgent

若要查看特定传输代理的详细配置，请运行以下命令：

Get-TransportAgent <TransportAgentIdentity> | Format-List

此示例提供名为传输规则代理的传输代理的详细配置。

Get-TransportAgent "Transport Rule Agent" | Format-List

使用 Exchange 命令行管理程序配置传输代理的优先级

优先级最接近 0 的传输代理将首先处理电子邮件。 然而，传输代理注册的传输管道中的 SMTP 事件可能导致低优先级的代理在高优先级代理之前对邮件进行操作。

若要修改现有传输代理的优先级，请运行以下命令：

Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>

本示例将传输服务中名为 Contoso 传输代理的现有传输代理的优先级代理值设置为 3。

Set-TransportAgent "Contoso Transport Agent" -Priority 3

您如何知道这有效？

若要验证是否已成功配置传输代理的优先级，请运行 命令 Get-TransportAgent | Format-List Name,Priority 并确认传输代理的优先级值。

使用 Exchange 命令行管理程序卸载传输代理

卸载传输代理时，Exchange 将取消注册与代理一起使用的 DLL 文件。 Exchange 不会删除任何文件、注册表项或由传输代理安装操作添加的其他对象。

要卸载传输代理，请运行以下命令：

Uninstall-TransportAgent <TransportAgentIdentity>

此示例从传输服务中卸载名为 Fabrikam 传输代理的传输代理。

Uninstall-TransportAgent "Fabrikam Transport Agent"

您如何知道这有效？

若要验证是否已成功卸载传输代理，请运行 命令 Get-TransportAgent 并验证未列出传输代理。