Compartir a través de

Suspend-Message

  • Artículo

 

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

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

Utilice el cmdlet Suspend-Message para impedir la entrega de un mensaje concreto en una cola en un equipo que tenga instalada la función del servidor Transporte perimetral o servidor concentrador de transporte.

Sintaxis

Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

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

Descripción detallada

El cmdlet Suspend-Message impide la entrega de uno o varios mensajes que se encuentran en una cola del servidor concentrador de transporte o del servidor de transporte perimetral. Los mensajes que se están entregando no se suspenderán. La entrega continuará y el estado del mensaje será PendingSuspend. Si la entrega no se puede realizar, el mensaje volverá a entrar en la cola y, seguidamente, se suspenderá. Los mensajes que están en las colas Envío o Dañado no se pueden suspender.

Un mensaje que se está enviando a varios destinatarios puede estar ubicado en diferentes colas. Si especifica un parámetro Identity, el mensaje se suspenderá en una única cola si esa identidad coincide sólo con un único mensaje. Si la identidad coincide con más de un mensaje, recibirá un error. Para suspender un mensaje en más de una cola en una única operación, debe usar un filtro. Es necesario utilizar un parámetro Identity o Filter. Estos dos conjuntos de parámetros son mutuamente excluyentes.

Se puede suspender un mensaje en un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el uso del parámetro Server con el parámetro Filter. Si no se especifica un servidor, el comando sólo se ejecuta en el servidor local.

Para ejecutar el cmdlet Suspend-Message, la cuenta que utilice debe tener delegada la función Administrador de Exchange Server y el grupo local de administradores en el servidor de destino.

Para ejecutar el cmdlet Suspend-Message en un equipo que tenga instalada la función del servidor Concentrador de transporte, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores de 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 el criterio del valor de propiedad para los mensajes 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 mensajes son criterios válidos para el parámetro Filter:

  • DateReceived   La fecha en la que se recibió el mensaje.

  • ExpirationTime   La hora en que expirará el mensaje.

  • FromAddress   La dirección del Protocolo simple de transferencia de correo (SMTP) del remitente de un mensaje. Este valor se toma del MAIL FROM: del sobre del mensaje.

  • Identity   Un entero que representa un mensaje particular y una identidad de cola y servidor opcional.

  • InternetMessageId   El valor del campo de encabezado de MessageID:. Esta propiedad se expresa como un GUID seguido por la dirección SMTP del servidor de envío, como en este ejemplo: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Cadena de texto del último error registrado para un mensaje.

  • MessageSourceName   Cadena de texto del nombre del componente que ha enviado este mensaje a la cola.

  • Queue   Especifica la identidad de la cola que almacena el mensaje. 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.

  • RetryCount   El número de veces que se ha intentando entregar un mensaje a un destino.

  • SCL   La propiedad del nivel de confianza contra correo no deseado (SCL) especifica el SCL del mensaje. Las entradas SCL válidas son enteros del 0 al 9. Un valor de propiedad SCL vacío indica que el agente de filtrado de contenido no ha procesado el mensaje.

  • Size   El tamaño de un mensaje.

  • SourceIP   La dirección IP del servidor externo que ha enviado el mensaje a la organización Exchange.

  • Status   El estado actual del mensaje. Las opciones de estado del mensaje son Active, Retry, Suspended, PendingSuspend o PendingRemove.

  • Subject   Cadena de texto que representa el asunto del correo electrónico. Este valor se toma del Subject: del campo del encabezado.

Puede especificar varios criterios de filtro usando el operador de comparación -and. Los valores de propiedad que no se expresan como un entero individual deben especificarse entre comillas.

Identity

Necesario

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Use el parámetro Identity para especificar el entero MessageIdentitiy que representa un mensaje particular y una identidad de cola y servidor opcional. La sintaxis para este parámetro es la siguiente:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

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 conectarse 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 server como un nombre de host o un nombre de dominio completo (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 muestra cómo impedir la entrega de todos los mensajes en los que se dan las siguientes condiciones:

  • Los mensajes se envían desde la dirección SMTP del remitente especificado.

  • Los mensajes se ponen en cola en los servidores de concentrador de transporte o de transporte perimetral en donde se ejecuta el comando.

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

Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}