Suspend-Message
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:
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:
|
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"}