Suspend-Queue

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

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 completará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 utilizar 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 Exchange Server 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 sobre los permisos, funciones de delegación 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.
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.
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.
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 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}