Install-TransportAgent (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-11
Use el cmdlet Install-TransportAgent para registrar un agente de transporte de un equipo que tenga instalada la función del servidor Transporte perimetral o Transporte de concentradores en una organización de Microsoft Exchange Server 2007.
Sintaxis
Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-DomainController <Fqdn>]
Descripción detallada
El cmdlet Install-TransportAgent se usa para registrar un agente de transporte para usarlo en un servidor de transporte perimetral o transporte de concentradores.
Advertencia
Los agentes de transporte tienen acceso ilimitado a los mensajes de correo electrónico que encuentren. 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 tanto, sólo se deben instalar agentes de transporte en los que se confía totalmente y que han sido probados completamente en un entorno de prueba.
Para ejecutar el cmdlet Install-TransportAgent, se debe usar una cuenta en la que se delegue lo siguiente:
- Función Administrador de Exchange Server y grupo Administradores local para el servidor de destino
Para ejecutar el cmdlet Install-TransportAgent en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores en dicho equipo.
Para obtener más información acerca de los permisos, delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
AssemblyPath |
Necesario |
System.String |
Este parámetro especifica la ubicación del ensamblado de Microsoft .NET del agente de transporte. No se pueden usar rutas de archivo con formato UNC (Convención de nomenclatura universal). |
Name |
Necesario |
System.String |
Este parámetro especifica el nombre para mostrar del agente de transporte que se va a instalar. La longitud del nombre no puede superar los 64 caracteres. |
TransportAgentFactory |
Necesario |
System.String |
Este parámetro especifica el tipo de clase de Microsoft .NET del generador de agentes de transporte. El programador del agente de transporte instalado proporciona información de la empresa del agente de transporte e información relacionada. Para obtener más información, consulte la documentación facilitada por el desarrollador del generador de agentes de transporte. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que ejecutan la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo lee desde la instancia ADAM local y escribe en ella. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
En el siguiente ejemplo se muestra cómo se instalaría una aplicación de antivirus ficticia en un servidor de transporte perimetral o transporte de concentradores.
Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"