Agents Configuration File Read-Only Element Reference
Topic Last Modified: 2007-10-26
When you install the Hub Transport or the Edge Transport server role on a computer that is running Microsoft Exchange Server 2007, the installer creates an XMLfile that is named
agents.config that contains configuration information about agents that are installed on the server. You cannot write directly to this file. The only supported way to write to this file is by using the transport agent commands in the Exchange Management Shell. For information about the Transport Agent cmdlets, see Transport Agent Cmdlets on Microsoft TechNet.
The use of unsupported methods to write to the |
You can read the
agents.config file to determine the presence of and configuration information for one or more agents on the server. This documentation provides a reference for reading the information in the
agents.config file. This documentation is not a reference for writing to the
When you install Exchange 2007, the installer creates an XML file that is named
agents.config.template in the
<ExchangeInstallFolder>\TransportRoles\Shared folder (where <ExchangeInstallFolder> is the folder in which you installed Exchange 2007). When you install a Hub Transport or an Edge Transport server, Exchange 2007 copies the
agents.config.template file to
agents.config. Exchange 2007 reads and writes this file when you change the transport agents configuration on the server.
You can use the XML capabilities that are provided by the Microsoft .NET Framework to read and validate the
agents.config XML file. To verify the installation and configuration of a transport agent, read the XML in the
agents.config file and find the agent element that corresponds to the transport agent. If an agent element for the specific transport agent does not exist, the transport agent is not installed. If the transport agent is installed, you can read the attributes of the agent element to determine its configuration.
The following list shows the element hierarchy in the
agents.config XML file.
<configuration> <mexRuntime> <monitoring> <agentExecution/> <messageSnapshot/> </monitoring> <agentList> <agent/> <agent/> <agent /> </agentList> </mexRuntim> </configuration>