Éléments de fichier de configuration agents pour Exchange 2013
Recherchez des informations sur les éléments XML dans le fichier de configuration agents.config et fetagents.config dans Exchange 2013.
S’applique à : Exchange Server 2013
Lorsque vous installez le rôle Accès au client ou Serveur de boîtes 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. Vous ne pouvez pas écrire directement dans ce fichier.
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 les serveurs de boîtes aux lettres et écrivent dans un fichier nommé agents.config. Un ordinateur disposant à la fois du rôle serveur d’accès au client et du rôle serveur de boîtes aux lettres aura à la fois un fetagents.config et un fichier agents.config.
La seule façon d’écrire dans ces fichiers est d’utiliser les applets de commande de l’agent de transport dans Exchange Management Shell. Pour plus d’informations sur les applets de commande de l’agent de transport, consultez Applets de commande de flux de courrier sur TechNet.
Remarque
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 applets de commande 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.
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. Cette documentation fournit une référence que vous pouvez utiliser pour lire les informations contenues dans le fichier agents.config ou dans le fetagents.config. Le format de ces deux fichiers est le même. Cette documentation ne fournit pas d’informations sur la façon d’écrire dans les fichiers.
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, y compris la défaillance du service de transport ou des agents de transport, ou les deux. N’écrivez pas directement dans l’un de ces fichiers. La seule méthode prise en charge pour l’écriture dans ces fichiers consiste à utiliser les applets de commande de l’agent de transport Exchange Management Shell.
Emplacement des fichiers de configuration de l’agent de transport
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 <dossier ExchangeInstallFolder>\TransportRoles\Agents (où <ExchangeInstallFolder> est le dossier dans lequel vous avez installé 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.
Vérification de l’installation d’un agent de transport
Vous pouvez utiliser les fonctionnalités XML que le .NET Framework fournit pour lire et valider le agents.config ou le fichier XML fetagents.config. 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 qui correspond à l’agent de transport. Si aucun élément d’agent n’existe pour l’agent de transport spécifique, l’agent de transport n’est pas installé. Si l’agent de transport est installé, vous pouvez lire les attributs de l’élément agent pour déterminer sa configuration.
Hiérarchie des éléments de fichier de configuration
Le code suivant montre la hiérarchie des éléments dans le fichier XML de configuration.
<configuration>
<mexRuntime>
<monitoring>
<agentExecution/>
<messageSnapshot/>
</monitoring>
<agentList>
<agent/>
<agent/>
<agent />
</agentList>
</mexRuntim>
</configuration>