Elementos de arquivo de configuração de agentes para o Exchange 2013Agents configuration file elements for Exchange 2013

Encontre informações sobre os elementos XML no arquivo de configuração Agents. config e fetagents. config no Exchange 2013.Find information about the XML elements in the agents.config and fetagents.config configuration file in Exchange 2013.

Aplica-se a: Exchange Server 2013Applies to: Exchange Server 2013

Quando você instala a função de servidor Acesso para cliente ou caixa de correio em um servidor Exchange, o instalador cria um arquivo XML que contém informações de configuração sobre os agentes instalados no servidor.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. Você não pode gravar diretamente neste arquivo.You cannot write directly to this file.

O serviço de transporte de front-end é executado em servidores de acesso para cliente e grava em um arquivo chamado fetagents. config. O serviço de transporte e o serviço de transporte de caixa de correio são executados em servidores de caixa de correio e grava em um arquivo chamado Agents. config. Um computador que tenha a função de servidor de acesso para cliente e a função de servidor de caixa de correio terá um fetagents. config e um arquivo 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.

A única maneira compatível de gravar nesses arquivos é usando os cmdlets do agente de transporte no Shell de gerenciamento do Exchange.The only supported way to write to these files is by using the transport agent cmdlets in the Exchange Management Shell. Para obter informações sobre os cmdlets do agente de transporte, consulte cmdlets de fluxo de emails no TechNet.For information about the transport agent cmdlets, see Mail Flow Cmdlets on TechNet.

Observação

Para distinguir entre agentes que estendem o serviço de transporte de front-end no servidor de acesso para cliente e o serviço de transporte no servidor de caixa de correio, os cmdlets do agente de transporte têm um parâmetro TransportService com um valor de "Hub" para o serviço de transporte e "frontend" para o serviço de transporte de front-end.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.

Você pode ler o arquivo agents. config ou fetagents. config para determinar a presença e as informações de configuração de um ou mais agentes no servidor.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. Esta documentação fornece uma referência que você pode usar para ler as informações no arquivo agents. config ou no fetagents. config. O formato de ambos os arquivos é o mesmo.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. Esta documentação não fornece informações sobre como gravar nos arquivos.This documentation does not provide information about how to write to the files.

Cuidado

O uso de métodos sem suporte para gravar no arquivo agents. config ou fetagents. config pode produzir resultados inesperados, incluindo a falha do serviço de transporte ou agentes de transporte, ou ambos.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. Não escreva diretamente para nenhum desses arquivos.Do not write directly to either of these files. O único método com suporte para gravar nesses arquivos é usando os cmdlets do agente de transporte do Shell de gerenciamento do Exchange.The only supported method for writing to these files is by using the Exchange Management Shell transport agent cmdlets.

Local dos arquivos de configuração do agente de transporteLocation of the transport agent configuration files

Quando você instala o Exchange 2013, o instalador cria um arquivo XML chamado Agents. config. Template ou fetagents. config. Template, dependendo da função de servidor instalada, na <ExchangeInstallFolder> pasta \TransportRoles\Agents (onde <ExchangeInstallFolder> é a pasta na qual você instalou o 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). Se você instalar a função de servidor Acesso para cliente, o Exchange 2013 copiará o arquivo fetagents. config. Template para fetagents. config. Se você instalar a função de servidor caixa de correio, o Exchange 2013 copiará o arquivo agents. config. Template para o Agents. config. O Exchange 2013 lê e grava esse arquivo quando você altera a configuração dos agentes de transporte no servidor.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.

Verificar a instalação de um agente de transporteVerifying a transport agent installation

Você pode usar os recursos de XML que o .NET Framework fornece para ler e validar os agentes. config ou o arquivo XML fetagents. 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. Para verificar a instalação e a configuração de um agente de transporte, leia o XML no arquivo de configuração e localize o elemento do agente que corresponde ao agente de transporte.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. Se não existir um elemento de agente para o agente de transporte específico, o agente de transporte não será instalado.If an agent element for the specific transport agent does not exist, the transport agent is not installed. Se o agente de transporte estiver instalado, você poderá ler os atributos do elemento Agent para determinar sua configuração.If the transport agent is installed, you can read the attributes of the agent element to determine its configuration.

Hierarquia de elemento do arquivo de configuraçãoConfiguration file element hierarchy

O código a seguir mostra a hierarquia do elemento no arquivo XML de configuração.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>

Nesta seçãoIn this section

Confira tambémSee also