Éléments du fichier de configuration des agents pour Exchange 2013Agents configuration file elements for Exchange 2013

Recherchez des informations sur les éléments XML dans le fichier de configuration agents. config et fetagents. config dans Exchange 2013.Find information about the XML elements in the agents.config and fetagents.config configuration file in Exchange 2013.

S’applique à : Exchange Server 2013Applies to: Exchange Server 2013

Lorsque vous installez le rôle serveur d’accès au client ou de boîte aux lettres sur un serveur Exchange, le programme d’installation crée un fichier XML qui contient des informations de configuration sur les agents installés sur le serveur.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. Vous ne pouvez pas écrire directement dans ce fichier.You cannot write directly to this file.

Le service de transport frontal s’exécute sur les serveurs d’accès au client et écrit dans un fichier nommé fetagents. config. Le service de transport et le service de transport de boîtes aux lettres s’exécutent sur des serveurs de boîtes aux lettres, et sont écrits dans un fichier nommé agents. config. Un ordinateur qui a à la fois le rôle serveur d’accès au client et le rôle serveur de boîte aux lettres aura à la fois un fichier fetagents. config et un fichier 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.

La seule façon d’écrire dans ces fichiers est d’utiliser les applets de commande de l’agent de transport dans l’environnement de commande Exchange Management Shell.The only supported way to write to these files is by using the transport agent cmdlets in the Exchange Management Shell. Pour plus d’informations sur les applets de commande de l’agent de transport, consultez la rubrique mail Flow cmdlets on technet.For information about the transport agent cmdlets, see Mail Flow Cmdlets on TechNet.

Notes

Pour faire la distinction entre les agents qui étendent le service de transport frontal sur le serveur d’accès au client et le service de transport sur le serveur de boîtes aux lettres, les cmdlets de l’agent de transport ont un paramètre TransportService avec la valeur « Hub » pour le service de transport et « frontend » pour le service de transport frontal.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.

Vous pouvez lire le fichier agents. config ou fetagents. config pour déterminer la présence et les informations de configuration d’un ou de plusieurs agents sur le serveur.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. Cette documentation fournit une référence que vous pouvez utiliser pour lire les informations dans le fichier agents. config ou fetagents. config. Le format de ces deux fichiers est le même.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. Cette documentation ne fournit pas d’informations sur la façon d’écrire dans les fichiers.This documentation does not provide information about how to write to the files.

Attention

L’utilisation de méthodes non prises en charge pour écrire dans le fichier agents. config ou fetagents. config peut produire des résultats inattendus, notamment l’échec du service de transport ou des agents de transport, ou les deux.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’écrivez pas directement dans l’un de ces fichiers.Do not write directly to either of these files. La seule méthode prise en charge pour l’écriture dans ces fichiers est d’utiliser les cmdlets de l’agent de transport de l’environnement de commande Exchange Management Shell.The only supported method for writing to these files is by using the Exchange Management Shell transport agent cmdlets.

Emplacement des fichiers de configuration de l’agent de transportLocation of the transport agent configuration files

Lorsque vous installez Exchange 2013, le programme d’installation crée un fichier XML nommé agents. config. template ou fetagents. config. Template, selon le rôle serveur installé, dans le <ExchangeInstallFolder> dossier \TransportRoles\Agents (où <ExchangeInstallFolder> est le dossier dans lequel vous avez installé 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). Si vous installez le rôle serveur d’accès au client, Exchange 2013 copie le fichier fetagents. config. template dans fetagents. config. Si vous installez le rôle serveur de boîtes aux lettres, Exchange 2013 copie le fichier agents. config. template dans agents. config. Exchange 2013 lit et écrit ce fichier lorsque vous modifiez la configuration des agents de transport sur le serveur.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.

Vérification de l’installation d’un agent de transportVerifying a transport agent installation

Vous pouvez utiliser les fonctionnalités XML fournies par .NET Framework pour lire et valider le fichier agents. config ou le fichier 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. Pour vérifier l’installation et la configuration d’un agent de transport, lisez le code XML dans le fichier de configuration et recherchez l’élément agent correspondant à l’agent de transport.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. Si un élément agent pour l’agent de transport spécifique n’existe pas, l’agent de transport n’est pas installé.If an agent element for the specific transport agent does not exist, the transport agent is not installed. Si l’agent de transport est installé, vous pouvez lire les attributs de l’élément agent pour en déterminer la configuration.If the transport agent is installed, you can read the attributes of the agent element to determine its configuration.

Hiérarchie des éléments du fichier de configurationConfiguration file element hierarchy

Le code suivant montre la hiérarchie des éléments dans le fichier XML de configuration.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>

Dans cette sectionIn this section

Voir aussiSee also