Administrar agentes de transporteManage transport agents

Se aplica a: Exchange Server 2013Applies to: Exchange Server 2013

Los agentes de transporte usan los eventos SMTP para procesar los mensajes a medida que pasan por la canalización de transporte. La mayoría de los agentes de transporte integrados incluidos en Microsoft Exchange Server 2013 son invisibles y no administrables. No obstante, puede instalar y configurar agentes de transporte de terceros en servidores de Exchange en su organización. Para obtener más información acerca de los agentes de transporte, consulte Agentes de transporte.Transport agents use SMTP events to operate on messages as the messages move through the transport pipeline. Most of the built-in transport agents that are included with Microsoft Exchange Server 2013 are invisible and unmanageable. However, you can install and configure third-party transport agents on Exchange servers in your organization. For more information about transport agents, see Transport agents.

¿Qué necesita saber antes de comenzar?What do you need to know before you begin?

Sugerencia

¿Problemas?Having problems? Solicite ayuda en los foros de Exchange.Ask for help in the Exchange forums. Visite los foros en Exchange Server.Visit the forums at Exchange Server.

Acerca de los procedimientos del agente de transporte en el servicio de transporte front-end en los servidores de acceso de clienteAbout transport agent procedures in the Front End Transport service on Client Access servers

No puede usar el Shell de administración de Exchange para administrar el agente de transporte en el servicio de transporte front-end o en un servidor de acceso de cliente. En cambio, debe abrir Windows PowerShell en el servidor de acceso de cliente y, a continuación, importar los cmdlets de Exchange en la sesión de Windows PowerShell.You can't use the Exchange Management Shell to manage transport agent in the Front End Transport service on a Client Access server. Instead, you need to open Windows PowerShell on the Client Access server, and then import the Exchange cmdlets into the Windows PowerShell session.

Advertencia

No se admite la ejecución de cmdlets de Exchange en Windows PowerShell para tareas que no sean la administración de agentes de transporte en el servicio de transporte front-end.Running Exchange cmdlets in Windows PowerShell for tasks other than managing transport agents in the Front End Transport service is not supported. Pueden ocurrir consecuencias graves si omite el Shell de administración de Exchange y el control de acceso basado en roles (RBAC), y ejecuta los cmdlets de Exchange en Windows PowerShell.There are serious consequences that can result if you bypass the Exchange Management Shell and role-based access control (RBAC) by running Exchange cmdlets in Windows PowerShell. Siempre debe ejecutar los cmdlets de Exchange en el Shell de administración de Exchange.You should always run Exchange cmdlets in the Exchange Management Shell. Para obtener más información, vea notas de la versión de Exchange 2013.For more information, see Release notes for Exchange 2013.

Para realizar cualquiera de los procedimientos del agente de transporte descritos en este tema, en el servicio de transporte front-end, debe seguir estos pasos adicionales:To perform any of the Transport Agent procedures described in this topic in the Front End Transport service, you need to perform the following additional steps:

  1. En el servidor de acceso de cliente, abra Windows PowerShell y ejecute el siguiente comando:On the Client Access server, open Windows PowerShell and run the following command:

    Add-PSSnapin Microsoft.Exchange.Management.PowerShell.SnapIn
    
  2. Ejecute el comando como se describe, pero agregue el siguiente valor al comando: -TransportService FrontEnd.Run the command as described, but add the following value to the command: -TransportService FrontEnd.

    Por ejemplo, para ver los agentes de transporte en el servicio de transporte front-end en un servidor de acceso de cliente, ejecute el siguiente comando:For example, to view the transport agents in the Front End Transport service on a Client Access server, run the following command:

    Get-TransportAgent -TransportService FrontEnd
    

Uso del Shell para instalar un agente de transporteUse the Shell to install a transport agent

Cuando instala un agente de transporte, Exchange solamente registra las DLL asociadas con el agente de transporte. Debe asegurarse de que todos los archivos, claves de registro y otros objetos en los que depende el agente de transporte estén instalados y configurados correctamente. Después de que Exchange carga las DLL, sigue haciendo referencia a las DLL una vez finalizado el comando.When you install a transport agent, Exchange only registers the DLLs associated with the transport agent. You need to make sure all files, registry keys, and other objects that the transport agent depends on are installed correctly and configured. After Exchange loads the DLLs, it continues to reference the DLLs after the command has completed.

Los agentes de transporte tienen acceso completo a todos los mensajes de correo electrónico que encuentran. Exchange no restringe en modo alguno el comportamiento de los agentes de transporte. Los agentes de transporte que sean inestables o tengan problemas de seguridad pueden afectar a la estabilidad y seguridad de Exchange. Por lo tanto, solamente debe instalar agentes de transporte en los que confía totalmente y que han sido probados completamente en un entorno de prueba.Transport agents have full access to all e-mail messages that they encounter. Exchange puts no restrictions on a transport agent's behavior. Transport agents that are unstable or contain security flaws may affect the stability and security of Exchange. Therefore, you should only install transport agents that you fully trust and that have been fully tested in a test environment.

Los agentes de transporte están instalados en estado deshabilitado para garantizar que el flujo de correo no se vea afectado por los agentes de transporte que aún no se hayan configurado. Por lo tanto, después de configurar correctamente un agente de transporte, debe habilitarlo.Transport agents are installed in a disabled state to make sure mail flow isn't affected by transport agents that haven't been configured. Therefore, after a transport agent has been configured correctly, you need to enable the transport agent.

Utilice la sintaxis siguiente para instalar un agente de transporte.Use the following syntax to install a transport agent.

Install-TransportAgent -Name <TransportAgentIdentity> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">

En este ejemplo, se instala un agente de transporte ficticio denominado Contoso Transport Agent en el servicio de transporte de un servidor de buzones de correo.This example installs a fictitious transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

Install-TransportAgent -Name "Contoso Transport Agent" -TransportAgentFactory "vendor.exchange.ContosoTransportAgentfactory" -AssemblyPath "C:\Program Files\Vendor\TransportAgent\ContosoTransportAgentFactory.dll"

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Para comprobar que el agente de transporte se instaló correctamente, ejecute el comando Get-TransportAgent y compruebe que el agente de transporte aparezca en la lista.To verify that you have successfully installed the transport agent, run the command Get-TransportAgent and verify the transport agent is listed.

Usar el Shell para habilitar un agente de transporteUse the Shell to enable a transport agent

Use la sintaxis siguiente para habilitar un agente de transporte.Use the following syntax to enable a transport agent.

Enable-TransportAgent <TransportAgentIdentity>

En este ejemplo, se habilita el agente de transporte denominado Contoso Transport Agent en el servicio de transporte de un servidor de buzones de correo.This example enables the transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

Enable-TransportAgent "Contoso Transport Agent"

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Para comprobar que el agente de transporte se habilitó correctamente, ejecute el comando Get-TransportAgent | Format-List Name,Enabled y compruebe que el agente de transporte esté habilitado.To verify that you have successfully enabled a transport agent, run the command Get-TransportAgent | Format-List Name,Enabled and verify the transport agent is enabled.

Usar el Shell para deshabilitar un agente de transporteUse the Shell to disable a transport agent

Use la sintaxis siguiente para deshabilitar un agente de transporte:Use the following syntax to disable a transport agent:

Disable-TransportAgent <TransportAgentIdentity>

En este ejemplo, se deshabilita el agente de transporte denominado Fabirkam Transport Agent en el servicio de transporte de un servidor de buzones de correo.This example disables the transport agent named Fabirkam Transport Agent in the Transport service on a Mailbox server.

Disable-TransportAgent "Fabrikam Transport Agent"

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Para comprobar que el agente de transporte se deshabilitó correctamente, ejecute el Get-TransportAgent | Format-List Name,Enabled comando y compruebe que el agente de transporte esté deshabilitado.To verify that you have successfully disabled a transport agent, run the command Get-TransportAgent | Format-List Name,Enabled and verify the transport agent is disabled.

Usar el Shell para ver los agentes de transporteUse the Shell to view transport agents

Para ver una lista de resumen de todos los agentes de transporte, ejecute el siguiente comando:To view a summary list of transport agents, run the following command:

Get-TransportAgent

Para ver la configuración detallada de un agente de transporte específico, ejecute el siguiente comando:To view the detailed configuration of a specific transport agent, run the following command:

Get-TransportAgent <TransportAgentIdentity> | Format-List

En este ejemplo, se proporciona una configuración detallada del agente de transporte denominado Transport Rule Agent.This example provides detailed configuration of the transport agent named Transport Rule Agent.

Get-TransportAgent "Transport Rule Agent" | Format-List

Usar el Shell para configurar la prioridad de un agente de transporteUse the Shell to configure the priority of a transport agent

Cuanto más cercana a 0 sea la prioridad de un agente de transporte, antes procesará los mensajes de correo electrónico. No obstante, el evento SMTP en la canalización de transporte donde está registrado el agente de transporte puede hacer que un agente de menor prioridad procese el mensaje antes que un agente de mayor prioridad.Transport agents with a priority closest to 0 process email messages first. However, the SMTP event in the transport pipeline where the transport agent is registered may cause a lower priority agent to act on the message before a higher priority agent.

Para modificar la prioridad de un agente de transporte existente, ejecute el siguiente comando:To modify the priority of an existing transport agent, run the following command:

Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>

En este ejemplo, se establece en 3 el valor de prioridad para el agente de transporte existente denominado Contoso Transport Agent en el servicio de transporte de un servidor de buzones de correo.This example sets the priority agent value of 3 for the existing transport agent named Contoso Transport Agent in the Transport service on a Mailbox server.

Set-TransportAgent "Contoso Transport Agent" -Priority 3

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Para comprobar que la prioridad de un agente de transporte se configuró correctamente, ejecute el Get-TransportAgent | Format-List Name,Priority comando y compruebe el valor de prioridad del agente de transporte.To verify that you have successfully configured the priority of a transport agent, run the command Get-TransportAgent | Format-List Name,Priority and verify the priority value of the transport agent.

Uso del Shell para desinstalar un agente de transporteUse the Shell to uninstall a transport agent

Cuando se desinstala el agente de transporte, Exchange elimina el registro de los archivos de DLL usados con el agente. Exchange no quita ningún archivo, clave de registro u otros objetos agregados mediante la instalación del agente de transporte.When the transport agent is uninstalled, Exchange unregisters the DLL files used with the agent. Exchange doesn't remove any files, registry keys, or other objects added by the installation of the transport agent.

Para desinstalar un agente de transporte, ejecute el siguiente comando:To uninstall a transport agent, run the following command:

Uninstall-TransportAgent <TransportAgentIdentity>

En este ejemplo, se desinstala el agente de transporte denominado Fabirkam Transport Agent del servicio de transporte de un servidor de buzones de correo.This example uninstalls the transport agent named Fabrikam Transport Agent from the Transport service on a Mailbox server.

Uninstall-TransportAgent "Fabrikam Transport Agent"

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Para comprobar que el agente de transporte se desinstaló correctamente, ejecute el comando Get-TransportAgent y compruebe que el agente de transporte no aparezca en la lista.To verify that you have successfully uninstalled the transport agent, run the command Get-TransportAgent and verify the transport agent isn't listed.