Элементы файла конфигурации агентов для Exchange 2013Agents configuration file elements for Exchange 2013

Найдите сведения об элементах XML в файле конфигурации Agents. config и фетажентс. config в Exchange 2013.Find information about the XML elements in the agents.config and fetagents.config configuration file in Exchange 2013.

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

При установке роли сервера клиентского доступа или сервера почтовых ящиков на сервере Exchange Installer создает XML-файл, содержащий сведения о конфигурации агентов, установленных на сервере.When you install the Client Access or the Mailbox server role on an Exchange server, the installer creates an XML file that contains configuration information about agents that are installed on the server. Вы не можете выполнять запись непосредственно в этот файл.You cannot write directly to this file.

Внешняя служба транспорта работает на серверах клиентского доступа и выполняет запись в файл с именем фетажентс. config. Служба транспорта и служба транспорта почтовых ящиков выполняются на серверах почтовых ящиков и записываются в файл с именем Agents. config. У компьютера, у которого есть роль сервера клиентского доступа и роль сервера почтовых ящиков, есть файл фетажентс. config и Agents. config.The Front End Transport service runs on Client Access servers and writes to a file named fetagents.config. The Transport service and the Mailbox Transport service run on Mailbox servers, and write to a file named agents.config. A computer that has both the Client Access server role and the Mailbox server role will have both a fetagents.config and an agents.config file.

Единственный поддерживаемый способ записи в эти файлы — использование командлетов агента транспорта в командной консоли Exchange.The only supported way to write to these files is by using the transport agent cmdlets in the Exchange Management Shell. Сведения о командлетах агента транспорта можно найти в разделе командлеты обработки почты на сайте TechNet.For information about the transport agent cmdlets, see Mail Flow Cmdlets on TechNet.

Примечание

Для различения агентов, расширяющих службу транспорта переднего плана на сервере клиентского доступа и транспортной службе на сервере почтовых ящиков, Командлеты агента транспорта имеют параметр TransportService со значением "Hub" для транспортной службы и сервера переднего плана для внешней серверной службы транспорта.To distinguish between agents that extend the Front End Transport service on the Client Access server and the Transport service on the Mailbox server, transport agent cmdlets have a TransportService parameter with a value of "Hub" for the Transport service and "FrontEnd" for the Front End Transport service.

Можно прочитать файл Agents. config или фетажентс. config, чтобы определить присутствие и сведения о конфигурации для одного или нескольких агентов на сервере.You can read the agents.config or fetagents.config file to determine the presence of and configuration information for one or more agents on the server. В этой документации представлена ссылка, которую можно использовать для чтения информации либо в файле Agents. config, либо в файле фетажентс. config. Формат обоих этих файлов один и тот же.This documentation provides a reference that you can use to read the information in either the agents.config file or the fetagents.config. The format for both of these files is the same. В этой документации не приводятся сведения о том, как выполнять запись в файлы.This documentation does not provide information about how to write to the files.

Внимание!

Использование неподдерживаемых методов для записи в файл Agents. config или фетажентс. config может привести к непредвиденным результатам, в том числе отказам в службе транспорта или агентах транспорта или обоим.Using unsupported methods to write to the agents.config file or fetagents.config can produce unexpected results, including failure of the transport service or transport agents, or both. Не записывайте непосредственно ни один из этих файлов.Do not write directly to either of these files. Единственный поддерживаемый метод для записи в эти файлы заключается в использовании командлетов агента транспорта Exchange Management Shell.The only supported method for writing to these files is by using the Exchange Management Shell transport agent cmdlets.

Расположение файлов конфигурации агента транспортаLocation of the transport agent configuration files

При установке Exchange 2013 установщик создает XML-файл с именем Agents. config. Template или фетажентс. config. Template в зависимости от установленной роли сервера, в <ExchangeInstallFolder> папке \транспортролес\ажентс (где <ExchangeInstallFolder> — Папка, в которой установлено Exchange 2013).When you install Exchange 2013, the installer creates an XML file that is named either agents.config.template or fetagents.config.template, depending on the server role installed, in the <ExchangeInstallFolder>\TransportRoles\Agents folder (where <ExchangeInstallFolder> is the folder in which you installed Exchange 2013). При установке роли сервера клиентского доступа Exchange 2013 копирует файл фетажентс. config. Template в фетажентс. config. При установке роли сервера почтовых ящиков Exchange 2013 копирует файл Agents. config. Template в Agents. config. Exchange 2013 считывает и записывает этот файл при изменении конфигурации агентов транспорта на сервере.If you install the Client Access server role, Exchange 2013 copies the fetagents.config.template file to fetagents.config. If you install the Mailbox server role, Exchange 2013 copies the agents.config.template file to agents.config. Exchange 2013 reads and writes this file when you change the transport agents configuration on the server.

Проверка установки агента транспортаVerifying a transport agent installation

Вы можете использовать возможности XML, предоставляемые .NET Framework для чтения и проверки файла Agents. config или XML-файла фетажентс. config.You can use the XML capabilities that the .NET Framework provides to read and validate the agents.config or the fetagents.config XML file. Чтобы проверить установку и конфигурацию агента транспорта, прочтите XML-код в файле конфигурации и найдите элемент Agent , соответствующий агенту транспорта.To verify the installation and configuration of a transport agent, read the XML in the configuration file and find the agent element that corresponds to the transport agent. Если элемент Agent для определенного агента транспорта не существует, агент транспорта не установлен.If an agent element for the specific transport agent does not exist, the transport agent is not installed. Если агент транспорта установлен, можно прочитать атрибуты элемента Agent , чтобы определить его конфигурацию.If the transport agent is installed, you can read the attributes of the agent element to determine its configuration.

Иерархия элементов файла конфигурацииConfiguration file element hierarchy

В приведенном ниже коде показана иерархия элементов в XML-файле конфигурации.The following code shows the element hierarchy in the configuration XML file.

<configuration>
    <mexRuntime>
        <monitoring>
            <agentExecution/>
            <messageSnapshot/>
        </monitoring>
        <agentList>
            <agent/>
            <agent/>
            <agent />
        </agentList>
    </mexRuntim>
</configuration>

В этой статьеIn this section

См. такжеSee also