Управление агентами транспортаManage transport agents

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

Агенты транспорта используют события SMTP для обработки сообщений, когда они проходят через транспортный конвейер. Большинство встроенных агентов транспорта, заданных в Microsoft Exchange Server 2013, невидимы и неуправляемы. Однако на серверах Exchange в организации можно установить и настроить сторонние агенты транспорта. Дополнительные сведения об агентах транспорта см. в разделе Агенты транспорта.Transport agents use SMTP events to operate on messages as the messages move through the transport pipeline. Most of the built-in transport agents that are included with Microsoft Exchange Server 2013 are invisible and unmanageable. However, you can install and configure third-party transport agents on Exchange servers in your organization. For more information about transport agents, see Transport agents.

Что нужно знать перед началом работыWhat do you need to know before you begin?

Совет

Возникли проблемы? Обращение за помощью в форумах Exchange. Посетите форумы Exchange Server, Exchange Onlineили Exchange Online Protection.Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Server, Exchange Online, or Exchange Online Protection.

Что нужно сделатьWhat do you want to do?

О процедурах агентов транспорта в службе транспорта переднего плана на серверах клиентского доступаAbout transport agent procedures in the Front End Transport service on Client Access servers

Для управления агентом транспорта в службе транспорта переднего плана на серверах клиентского доступа нельзя использовать командную консоль Exchange. Вместо этого на сервере клиентского доступа нужно открыть Windows PowerShell, а затем импортировать командлеты Exchange в сеанс Windows PowerShell.You can't use the Exchange Management Shell to manage transport agent in the Front End Transport service on a Client Access server. Instead, you need to open Windows PowerShell on the Client Access server, and then import the Exchange cmdlets into the Windows PowerShell session.

Предупреждение

Выполнение командлетов Exchange в среде Windows PowerShell для задач, отличных от управление агенты транспорта в транспортной службе не поддерживается. Существуют серьезные последствия, которые могут привести к Если пропустить Командная консоль Exchange и управлении доступом на основе ролей (RBAC), выполнив командлеты Exchange в Windows PowerShell. Командлеты Exchange всегда следует запускать в командной консоли Exchange. Для получения дополнительных сведений см заметки о выпуске Exchange 2013.Running Exchange cmdlets in Windows PowerShell for tasks other than managing transport agents in the Front End Transport service is not supported. There are serious consequences that can result if you bypass the Exchange Management Shell and role-based access control (RBAC) by running Exchange cmdlets in Windows PowerShell. You should always run Exchange cmdlets in the Exchange Management Shell. For more information, see Release notes for Exchange 2013.

Для выполнения любой процедуры агента транспорта, описанной в этом разделе в службе транспорта переднего плана, нужно выполнить следующие дополнительные действия.To perform any of the Transport Agent procedures described in this topic in the Front End Transport service, you need to perform the following additional steps:

  1. На сервере клиентского доступа откройте Windows PowerShell и выполните команду, приведенную ниже:On the Client Access server, open Windows PowerShell and run the following command:

    Add-PSSnapin Microsoft.Exchange.Management.PowerShell.SnapIn
    
  2. Выполните команду, как описано, но добавьте к команде следующее значение: -TransportService FrontEnd.Run the command as described, but add the following value to the command: -TransportService FrontEnd.

    Например, для просмотра агентов транспорта в службе транспорта переднего плана выполните команду, приведенную ниже:For example, to view the transport agents in the Front End Transport service on a Client Access server, run the following command:

    Get-TransportAgent -TransportService FrontEnd
    

Установка агента транспорта с помощью командной консоли ExchangeUse the Shell to install a transport agent

При установке агента транспорта Exchange регистрирует только те библиотеки DLL, которые относятся к агенту транспорта. Поэтому все файлы, разделы реестра и другие объекты, влияющие на работу агента транспорта, должны быть установлены и правильно настроены. После загрузки библиотек DLL Exchange продолжает ссылаться на них после завершения выполнения команды.When you install a transport agent, Exchange only registers the DLLs associated with the transport agent. You need to make sure all files, registry keys, and other objects that the transport agent depends on are installed correctly and configured. After Exchange loads the DLLs, it continues to reference the DLLs after the command has completed.

Агенты транспорта имеют полный доступ ко всем сообщениям электронной почты, обнаруженным ими. Приложение Exchange не накладывает ограничений на поведение агентов транспорта. Нестабильные агенты транспорта или с недостатками в системе безопасности могут повлиять на стабильность и безопасность Exchange. Поэтому устанавливать следует только те агенты транспорта, которые заслуживают полного доверия и были испытаны в лабораторной среде.Transport agents have full access to all e-mail messages that they encounter. Exchange puts no restrictions on a transport agent's behavior. Transport agents that are unstable or contain security flaws may affect the stability and security of Exchange. Therefore, you should only install transport agents that you fully trust and that have been fully tested in a test environment.

Чтобы исключить влияние не настроенных агентов транспорта на передачу почтовых сообщений, после установки они находятся в отключенном состоянии. Поэтому после правильной настройки агента транспорта его необходимо включить.Transport agents are installed in a disabled state to make sure mail flow isn't affected by transport agents that haven't been configured. Therefore, after a transport agent has been configured correctly, you need to enable the transport agent.

Чтобы установить агент транспорта, используйте следующий синтаксис.Use the following syntax to install a transport agent.

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

В этом примере фиктивный агент транспорта Contoso Transport Agent устанавливается в службе транспорта на сервере почтовых ящиков.This example installs a fictitious transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

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

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться, что вы успешно установили агента транспорта, выполните команду Get-TransportAgent и убедитесь в список агента транспорта.To verify that you have successfully installed the transport agent, run the command Get-TransportAgent and verify the transport agent is listed.

Включение агента транспорта с помощью командной консоли ExchangeUse the Shell to enable a transport agent

Чтобы включить агент транспорта, используйте следующий синтаксис.Use the following syntax to enable a transport agent.

Enable-TransportAgent <TransportAgentIdentity>

В этом примере фиктивный агент транспорта Contoso Transport Agent включается в службе транспорта на сервере почтовых ящиков.This example enables the transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

Enable-TransportAgent "Contoso Transport Agent"

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться в том, что вы успешно включили агента транспорта, выполните команду Get-TransportAgent | Format-List Name,Enabled и проверьте включено агента транспорта.To verify that you have successfully enabled a transport agent, run the command Get-TransportAgent | Format-List Name,Enabled and verify the transport agent is enabled.

Отключение агента транспорта с помощью командной консоли ExchangeUse the Shell to disable a transport agent

Чтобы отключить агент транспорта, используйте следующий синтаксис:Use the following syntax to disable a transport agent:

Disable-TransportAgent <TransportAgentIdentity>

В этом примере фиктивный агент транспорта Fabirkam Transport Agent отключается в службе транспорта на сервере почтовых ящиков.This example disables the transport agent named Fabirkam Transport Agent in the Transport service on a Mailbox server.

Disable-TransportAgent "Fabrikam Transport Agent"

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться в том, что вы успешно отключили агента транспорта, выполните команду Get-TransportAgent | Format-List Name,Enabled и проверьте агента транспорта отключена.To verify that you have successfully disabled a transport agent, run the command Get-TransportAgent | Format-List Name,Enabled and verify the transport agent is disabled.

Просмотр агента транспорта с помощью командной консоли ExchangeUse the Shell to view transport agents

Чтобы просмотреть сводный список всех агентов транспорта, выполните следующую команду:To view a summary list of transport agents, run the following command:

Get-TransportAgent

Чтобы просмотреть подробные сведения о конфигурации определенного агента транспорта, выполните следующую команду:To view the detailed configuration of a specific transport agent, run the following command:

Get-TransportAgent <TransportAgentIdentity> | Format-List

В этом примере предоставляются подробные сведения о конфигурации агента транспорта Transport Rule Agent.This example provides detailed configuration of the transport agent named Transport Rule Agent.

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

Настройка приоритета агента транспорта с помощью командной консоли ExchangeUse the Shell to configure the priority of a transport agent

Агенты транспорта, для которых значение приоритета близко к нулю, обрабатывают сообщения электронной почты в первую очередь. Однако событие SMTP в транспортном конвейере, где зарегистрирован агент транспорта, может стать причиной того, что агенты с низким приоритетом будут обрабатывать сообщения раньше агентов с высоким приоритетом.Transport agents with a priority closest to 0 process email messages first. However, the SMTP event in the transport pipeline where the transport agent is registered may cause a lower priority agent to act on the message before a higher priority agent.

Чтобы изменить приоритет существующего агента транспорта, выполните следующую команду:To modify the priority of an existing transport agent, run the following command:

Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>

В этом примере для существующего агента транспорта Contoso Transport Agent устанавливается значение приоритета агента 3 в службе транспорта на сервере почтовых ящиков.This example sets the priority agent value of 3 for the existing transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

Set-TransportAgent "Contoso Transport Agent" -Priority 3

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться в том, что вы успешно настроили приоритет агента транспорта, выполните команду Get-TransportAgent | Format-List Name,Priority и проверьте значение приоритета агента транспорта.To verify that you have successfully configured the priority of a transport agent, run the command Get-TransportAgent | Format-List Name,Priority and verify the priority value of the transport agent.

Удаление агента транспорта с помощью командной консоли ExchangeUse the Shell to uninstall a transport agent

При удалении агента транспорта Exchange отменяет регистрацию используемых агентом файлов DLL. При этом файлы, разделы реестра или другие объекты, добавляемые при установке агента транспорта, Exchange не удаляет.When the transport agent is uninstalled, Exchange unregisters the DLL files used with the agent. Exchange doesn't remove any files, registry keys, or other objects added by the installation of the transport agent.

Для удаления агента транспорта выполните следующую команду:To uninstall a transport agent, run the following command:

Uninstall-TransportAgent <TransportAgentIdentity>

В этом примере фиктивный агент транспорта Fabrikam Transport Agent удаляется из службы транспорта на сервере почтовых ящиков.This example uninstalls the transport agent named Fabrikam Transport Agent from the Transport service on a Mailbox server.

Uninstall-TransportAgent "Fabrikam Transport Agent"

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться, что вы успешно удалили агента транспорта, выполните команду Get-TransportAgent и проверьте, нет в списке агента транспорта.To verify that you have successfully uninstalled the transport agent, run the command Get-TransportAgent and verify the transport agent isn't listed.