Elementos de arquivo de configuração de agentes para o Exchange 2013

  • Artigo

Encontre informações sobre os elementos XML no arquivo de configuração agents.config e fetagents.config no Exchange 2013.

Aplica-se a: Exchange Server 2013

Ao instalar o Acesso ao Cliente ou a função de servidor caixa de correio em um servidor exchange, o instalador cria um arquivo XML que contém informações de configuração sobre agentes instalados no servidor. Você não pode gravar diretamente neste arquivo.

O serviço de Transporte front-end é executado em servidores de Acesso ao 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 gravam em um arquivo chamado agents.config. Um computador que tenha a função de servidor de Acesso ao Cliente e a função de servidor caixa de correio terá um fetagents.config e um arquivo agents.config.

A única maneira com suporte para gravar nesses arquivos é usando os cmdlets do agente de transporte no Shell de Gerenciamento do Exchange. Para obter informações sobre os cmdlets do agente de transporte, consulte Cmdlets de Fluxo de Email no TechNet.

Observação

Para distinguir entre os agentes que estendem o serviço de Transporte front-end no servidor de Acesso ao Cliente e o serviço de transporte no servidor 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 front-end.

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. Essa 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 para ambos os arquivos é o mesmo. Essa documentação não fornece informações sobre como gravar nos arquivos.

Cuidado

Usar métodos sem suporte para gravar no arquivo agents.config ou fetagents.config pode produzir resultados inesperados, incluindo falha do serviço de transporte ou agentes de transporte ou ambos. Não escreva diretamente em nenhum desses arquivos. O único método com suporte para gravar nesses arquivos é usando os cmdlets do agente de transporte shell de gerenciamento do Exchange.

Local dos arquivos de configuração do agente de transporte

Ao instalar 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 pasta ExchangeInstallFolder>\TransportRoles\Agents (<em que ExchangeInstallFolder> é a pasta na qual você instalou o <Exchange 2013). Se você instalar a função de servidor de Acesso ao Cliente, o Exchange 2013 copiará o arquivo fetagents.config.template para fetagents.config. Se você instalar a função de servidor da Caixa de Correio, o Exchange 2013 copiará o arquivo agents.config.template para agents.config. O Exchange 2013 lê e grava este arquivo quando você altera a configuração dos agentes de transporte no servidor.

Verificando uma instalação de agente de transporte

Você pode usar os recursos XML que o .NET Framework fornece para ler e validar o agents.config ou o arquivo XML fetagents.config. 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 agente que corresponde ao agente de transporte. Se um elemento de agente para o agente de transporte específico não existir, o agente de transporte não será instalado. Se o agente de transporte estiver instalado, você poderá ler os atributos do elemento agent para determinar sua configuração.

Hierarquia do elemento de arquivo de configuração

O código a seguir mostra a hierarquia de elementos no arquivo XML de configuração.

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

Nesta seção

Confira também