Install-TransportAgent
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-27
Utilice 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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Install-TransportAgent se utiliza para registrar un agente de transporte para utilizarlo en un servidor de transporte perimetral o transporte de concentradores.
Advertencia
Los agentes de transporte tienen acceso completo a todos los mensajes de correo electrónico con que se 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, solamente 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, debe utilizar una cuenta en la que se delegue lo siguiente:
- Función de administrador de servidores de Exchange y grupo local Administradores 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, la delegación de funciones y los derechos necesarios para administrar Exchange 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 utilizar 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 desarrollador del agente de transporte que se está instalando facilita el generador de agentes de transporte y otra información relacionada. Para obtener más información, consulte la documentación facilitada por el desarrollador del generador de agentes de transporte. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
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. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
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"