Set-TransportAgent (RTM)

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-11

Utilice el cmdlet Set-TransportAgent para modificar un agente de transporte de un equipo que tiene instalada la función del servidor Transporte perimetral o función de servidor Transporte de concentradores en una organización de Microsoft Exchange Server 2007.

Sintaxis

Set-TransportAgent -Identity <String> [-DomainController <Fqdn>] [-Priority <Nullable>]

Descripción detallada

El cmdlet Set-TransportAgent se utiliza para modificar un agente de transporte de un servidor de transporte perimetral o de transporte de concentradores.

Para ejecutar el cmdlet Set-TransportAgent, la cuenta que utilice debe tener delegadas las siguientes funciones:

  • Función de administrador de servidores de Exchange y grupo Administradores local para el servidor de destino

Para ejecutar el cmdlet Set-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 Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

System.String

Utilice este parámetro para especificar el nombre para mostrar del agente de transporte objeto de la modificación. La longitud del nombre no puede superar los 64 caracteres.

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.

Priority

Opcional

System.Nullable

Utilice este parámetro para especificar la prioridad del agente de transporte. La prioridad del agente de transporte controla el orden en el que los agentes de transporte procesan los mensajes de correo electrónico. El valor de la prioridad debe estar comprendido entre 0 y el número máximo de agentes de transporte. El comportamiento predeterminado es anexar un agente de transporte nuevo al final de la lista de prioridades. Cuanto más cercana a 0 sea la prioridad de un agente de transporte, antes procesará los mensajes de correo electrónico.

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 modificaría la prioridad de un agente antivirus ficticio.

Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3