Disable-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 Disable-TransportAgent para deshabilitar 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

Disable-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

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

Para ejecutar el cmdlet Disable-TransportAgent, la cuenta que utilice deberá tener delegados los elementos siguientes:

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

Para ejecutar el cmdlet Disable-TransportAgent en un equipo que tenga instalada la función del servidor Transporte perimetral, es necesario iniciar una 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

Identity

Necesario

System.String

Este parámetro especifica el nombre para mostrar del agente de transporte que se va a deshabilitar. La longitud del nombre no puede superar los 64 caracteres.

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 deshabilitaría un antivirus ficticio en un servidor de transporte perimetral o de transporte de concentradores.

Disable-TransportAgent -Identity "Antivirus for Exchange"