Suspend-Queue (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

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

Use el cmdlet Suspend-Queue para detener las actividades salientes en la cola de un equipo que tiene instalada la función del servidor Transporte de concentradores o de transporte perimetral.

Sintaxis

Suspend-Queue -Identity <QueueIdentity>

Suspend-Queue -Filter <String> [-Server <ServerIdParameter>]

Descripción detallada

El cmdlet Suspend-Queue detiene las actividades salientes en las colas que tienen un estado Active o Retry. Los mensajes que se están entregando mediante SMTP finalizarán las operaciones. Ningún otro mensaje abandonará la cola. Si especifica un parámetro Identity y la identidad coincide con una única cola, la cola se suspenderá. Si la identidad coincide con más de una cola, recibirá un error. Para suspender más de una cola en una única operación, debe utilizar un filtro.

Es necesario usar un parámetro Identity o Filter. Los conjuntos de parámetros Identity y Filter son mutuamente excluyentes. Se puede suspender una cola de un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el uso del parámetro Server con una consulta de filtro. Si no se especifica un servidor, el comando sólo se ejecuta en el servidor local.

Para ejecutar el cmdlet Suspend-Queue, la cuenta que utilice deberá tener delegado lo siguiente:

  • Función Administrador de servidores de Exchange y grupo local de administradores para el servidor de destino

Para ejecutar el cmdlet Suspend-Queue en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante 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 Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Filter

Necesario

System.String

El parámetro Filter requiere una expresión que especifica los criterios de valor de la propiedad para las colas que desea suspender. La expresión incluye un nombre de propiedad seguido de un operador y un valor de comparación. Las siguientes propiedades de la cola son criterios válidos para el parámetro Filter:

  • DeliveryType   El tipo de entrega de esta cola tal y como define el transporte. El tipo de entrega debe ser uno de los valores siguientes:

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

  • Identity   Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente.

  • LastError   Una cadena de texto del último error registrado de una cola.

  • LastRetryTime   La hora en la que se intentó por última vez establecer conexión en esta cola.

  • MessageCount   El número de elementos que hay en la cola.

  • NextHopConnector   El GUID del conector que se usó para crear la cola.

  • NextHopDomain   El dominio del siguiente salto de la cola, especificado como un dominio remoto de Protocolo simple de transferencia de correo (SMTP), un nombre de servidor, el nombre de un sitio de Active Directory o un identificador de base de datos de mensajes (MDB).

  • NextRetryTime   La hora en la que se volverá a intentar establecer conexión en esta cola.

  • Status   El estado de la cola. Las opciones de estado de la cola son Active, Ready, Retry o Suspended.

Los criterios se pueden especificar mediante el uso del operador de comparación - and. Los valores de propiedad que no se expresen como un entero deben estar entre comillas.

Identity

Necesario

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Use el parámetro Identity para especificar la identidad de la cola que contiene los mensajes que desea suspender. Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Use el parámetro Server para especificar el nombre del servidor al que desea conectar mediante una llamada a procedimiento remoto (RPC) que contiene las colas en las que se encuentran los mensajes que desea suspender. Escriba el nombre del servidor como un nombre de host o un nombre completo de dominio (FQDN). Si no se usa este parámetro, se consulta el servidor local.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

En el siguiente ejemplo se muestran dos comandos Suspend-Queue. El primero suspende las actividades salientes en todas las colas que contienen mensajes para entregar en el dominio especificado y cuyo estado actual es Retry.

El segundo enlaza con un servidor remoto mediante RPC y suspende todas las colas que contienen más de 100 mensajes.

Para obtener más información acerca de cómo usar Shell de administración para realizar tareas de visor de cola, vea Utilización de Shell de administración de Exchange para administrar colas (en inglés).

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}