Включение поддержки устаревших агентов транспортаEnable support for legacy transport agents

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

В Microsoft Exchange Server 2013 агенты транспорта, созданные с помощью Microsoft .NET Framework 4.0, поддерживаются по умолчанию. Exchange 2013 поддерживает агенты транспорта, созданные с помощью предыдущих версий Microsoft .NET Framework, но поддержка устаревших агентов транспорта не включена по умолчанию. Чтобы включить поддержку устаревших агентов транспорта, необходимо изменить соответствующий файл XML конфигурации приложения. То, какие файлы необходимо изменить, зависит от того, где установлен агент.In Microsoft Exchange Server 2013, transport agents that were created using the Microsoft .NET Framework version 4.0 are supported by default. Exchange 2013 supports transport agents that were created using previous versions of the .NET Framework, but support for these legacy transport agents isn't enabled by default. To enable support for legacy transport agents, you need to modify the appropriate XML application configuration file. The files you need to modify depend on where the transport agent is installed:

СерверServer Файлы конфигурации приложенийApplication configuration files Служба Microsoft WindowsMicrosoft Windows service

Сервер клиентского доступаClient Access server

%ExchangeInstallPath%Bin\MSExchangeFrontendTransport.exe.config%ExchangeInstallPath%Bin\MSExchangeFrontendTransport.exe.config

Транспорт внешнего интерфейса Microsoft Exchange (MSExchangeFrontendTransport)Microsoft Exchange Front End Transport (MSExchangeFrontendTransport)

Сервер почтовых ящиковMailbox server

  • %ExchangeInstallPath%Bin\EdgeTransport.exe.config%ExchangeInstallPath%Bin\EdgeTransport.exe.config

  • %ExchangeInstallPath%Bin\MSExchangeTransport.exe.config%ExchangeInstallPath%Bin\MSExchangeTransport.exe.config

Служба транспорта Microsoft Exchange (MSExchangeTransport)Microsoft Exchange Transport (MSExchangeTransport)

Поддержка устаревших агентов транспорта контролируется ключами в файлах конфигурации приложения. По умолчанию файлы конфигурации приложения не содержат этих ключей. Их необходимо добавить вручную. В следующей таблице каждый ключ рассматривается более подробно.Support for legacy transport agents is controlled by keys in the application configuration files. By default, none of the required keys are present in the application configuration files. You must add the keys manually. The following table explains each key in more detail.

КлавишаKey ОписаниеDescription

useLegacyV2RuntimeActivationPolicyuseLegacyV2RuntimeActivationPolicy

Этот раздел включает или отключает поддержку агенты транспорта прежних версий. Допустимые значения для этого ключа true или false. Если этот ключ не указан, значением по умолчанию является false.This key enables or disables support for legacy transport agents. Valid values for this key are true or false. If this key isn't specified, the default value is false.

supportedRuntime versionsupportedRuntime version

Этот ключ указывает версию Microsoft .NET Framework, требуемую агентом. Допустимые значения этого ключа: This key specifies the version of the Microsoft .NET Framework that's required by the agent. Valid values for this key are:

  • v4.0илиv4.0.30319v4.0 or v4.0.30319

  • v3.5илиv3.5.21022v3.5 or v3.5.21022

  • v3.0илиv3.0.4506v3.0 or v3.0.4506

  • v2.0илиv2.0.50727v2.0 or v2.0.50727

Можно указать несколько значений, с помощью нескольких отдельных экземпляров ключ supportedRuntime версии .You specify multiple values using multiple separate instances of the supportedRuntime version key.

При включении поддержки агента транспорта прежних версий, с помощью ключа useLegacyV2RuntimeActivationPolicy , всегда необходимо задать значение v4.0 в дополнение к значениям, необходимые для агента транспорта прежних версий.When you enable legacy transport agent support using the useLegacyV2RuntimeActivationPolicy key, you should always specify the value v4.0 in addition to the values required by the legacy transport agent.

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

  • Предполагаемое время для завершения: 15 минут.Estimated time to complete: 15 minutes

  • Разрешения Exchange не применяются к процедурам, описанным в этом разделе. Эти процедуры выполняются в операционной системе сервера Exchange.Exchange permissions don't apply to the procedures in this topic. These procedures are performed in the operating system of the Exchange Server.

  • Изменения, сохраненные в файле конфигурации приложения, применяются после перезапуска соответствующей службы.Changes you save to an application configuration file are applied after you restart the corresponding service.

  • При перезапуске любой из служб, связанных с файлами конфигурации приложения, поток обработки почты на сервере временно прерывается.When you restart any of the services that are associated with the application configuration files, mail flow on the server is temporarily interrupted.

  • Все специальные настройки, выполненные для каждого сервера в XML-файлах конфигурации приложения Exchange, например в файлах web.config на серверах клиентского доступа или файлах EdgeTransport.exe.config на серверах почтовых ящиков, будут перезаписаны после установки накопительного пакета обновления Exchange. Обязательно сохраните нужные данные, чтобы упростить перенастройку сервера после установки. Эти параметры необходимо перенастроить после установки накопительного пакета обновления Exchange.Any customized per-server settings you make in Exchange XML application configuration files, for example, web.config files on Client Access servers or the EdgeTransport.exe.config file on Mailbox servers, will be overwritten when you install an Exchange Cumulative Update (CU). Make sure that you save this information so you can easily re-configure your server after the install. You must re-configure these settings after you install an Exchange CU.

  • Сочетания клавиш для процедур, описанных в этой статье, приведены в статье Сочетания клавиш в Центре администрирования Exchange.For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Совет

Возникли проблемы? Обращение за помощью в форумах 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.

Настройка поддержки устаревших агентов транспорта с помощью командной строкиUse the Command Prompt to configure support for legacy transport agents

Чтобы включить поддержку устаревших агентов транспорта, сделайте следующее:Use the following procedure to enable support for legacy transport agents:

  1. В окне командной строки на сервере Exchange 2013, где требуется настроить поддержу устаревших агентов транспорта, откройте в Блокноте соответствующий файл конфигурации приложения с помощью следующей команды:In a Command prompt window, on the Exchange 2013 server where you want to configure the legacy transport agent support, open the appropriate application configuration file in Notepad by running the following command:

    Notepad %ExchangeInstallPath%Bin\<AppConfigFile>
    

    Например, чтобы открыть файл EdgeTransport.exe.config на сервере почтовых ящиков, выполните следующую команду:For example, to open the EdgeTransport.exe.config file on a Mailbox server, run the following command:

    Notepad %ExchangeInstallPath%Bin\EdgeTransport.exe.config
    
  2. Найдите * </configuration> * раздел в конце файла и вставьте следующие ключи перед * </configuration> * ключа:Locate the </configuration> key at the end of the file, and paste the following keys before the </configuration> key:

        <startup useLegacyV2RuntimeActivationPolicy="true">
           <supportedRuntime version="v4.0" />
           <supportedRuntime version="v3.5" />
           <supportedRuntime version="v3.0" />
           <supportedRuntime version="v2.0" />
        </startup>
    
  3. По завершении сохраните и закройте файл конфигурации приложения.When you are finished, save and close the application configuration file.

  4. Повторите шаги с 1 по 3, чтобы изменить остальные файлы конфигурации приложения.Repeat Steps 1 through 3 to modify the other application configuration files.

  5. Перезапустите связанную службу Windows, выполнив следующую команду:Restart the associated Windows service by running the following command:

        net stop <service> && net start <service>
    

    Например, если изменения были внесены в файл EdgeTransport.exe.config, перезапустите службу транспорта Microsoft Exchange, выполнив следующую команду:For example, if you modified the EdgeTransport.exe.config file, you need to restart the Microsoft Exchange Transport service by running the following command:

        net stop MSExchangeTransport && net start MSExchangeTransport
    
  6. Повторите шаг 5, чтобы перезапустить службы, связанные с остальными измененными файлами конфигурации приложения.Repeat Step 5 to restart services associated with the other modified application configuration files.

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

Если удалось успешно установить устаревший агент транспорта, значит, все получилось. При попытке установить устаревший агент транспорта без выполнения процедур, описанных в этой статье, возникнет ошибка, например:You'll know this procedure works if the legacy transport agent installs successfully. If you try to install a legacy transport agent without performing the procedures in this topic, you'll receive an error that's similar to the following:

Mixed mode assembly is built against version '<version>' of the runtime and cannot be loaded in the 4.0 runtime without additional configuration information.