Remove-Message

Artículo
08/09/2014

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 Remove-Message para eliminar un mensaje de una cola en un equipo que tenga instalada la función del servidor Transporte perimetral o servidor de transporte de concentradores.

Sintaxis

Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Descripción detallada

El cmdlet Remove-Message elimina uno o más mensajes que se encuentren en una cola de un servidor de transporte de concentradores o un servidor de transporte perimetral. Un mensaje que se está transmitiendo a varios destinatarios puede estar ubicado en varias colas. Si especifica un parámetro Identity, el mensaje se eliminará de 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 eliminar un mensaje de más de una cola en una única operación, debe usar un filtro. Si intenta eliminar un mensaje que se está entregando actualmente, el estado del mensaje cambiará a PendingDelete. La entrega del mensaje no se interrumpirá, pero si no es posible realizar la entrega y el mensaje vuelva a entrar en la cola, se eliminará.

Debe usar un parámetro Identity o un parámetro Filter. Estos dos conjuntos de parámetros son mutuamente excluyentes.

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

Para ejecutar el cmdlet Remove-Message en un equipo que tenga instalada la función del servidor Transporte perimetral, 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 eliminar. 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 de `MAIL FROM:` en el 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 `Message-ID:`. 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 SCL especifica el nivel de confianza de correo electrónico no deseado 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 y PendingRemove. Subject Cadena de texto que representa el asunto del correo electrónico. Este valor se toma del campo de encabezado `Subject:`. 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 se va a conectar usando una llamada a procedimiento remoto (RPC) que contiene las colas que almacenan los mensajes que desea eliminar. Especifique el parámetro Server como 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.
WithNDR	Opcional	System.Boolean	Utilice el parámetro WithNDR para especificar si se devuelve un informe de no entrega (NDR) al remitente de un mensaje. El comportamiento predeterminado de este parámetro se establece en `$true`. Este parámetro se puede usar tanto con los conjuntos de parámetros Identity y Filter.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

El siguiente ejemplo muestra cómo eliminar todos los mensajes que satisfacen los siguientes criterios:

Los mensajes se envían desde la dirección SMTP del remitente especificado.
Los mensajes se ponen en cola en los servidores concentrador de transporte o de transporte perimetral en donde se ejecuta el comando.

En el siguiente ejemplo se muestra también cómo suprimir el NDR.

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).

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false