Remove-Message

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Remove-Message para eliminar un mensaje de una cola en un servidor de buzones o un servidor de transporte perimetral.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Remove-Message
      -Filter <String>
      [-Server <ServerIdParameter>]
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Remove-Message
      [-Identity] <MessageIdentity>
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Description

Un mensaje que se transmite a varios destinatarios podría encontrarse en varias colas. Si especifica un parámetro Identity, el mensaje se quita de una sola cola si esa identidad solo coincide con un único mensaje. Si la identidad coincide con más de un mensaje, recibirá un error. Para quitar un mensaje de más de una cola en una sola operación, debe usar el parámetro Filter. Si intenta quitar un mensaje que se está entregando actualmente, el estado del mensaje cambia a PendingDelete. La entrega de mensajes no se interrumpe, pero si se produce un error en la entrega y hace que el mensaje vuelva a entrar en la cola, se quitará.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Remove-Message -Server Server1 -Filter "FromAddress -eq 'Kweku@contoso.com'" -WithNDR $false

En este ejemplo se quitan todos los mensajes que cumplen los criterios siguientes sin generar NDR:

El remitente Kweku@contoso.comenvía los mensajes.
Los mensajes se colocan en la cola del servidor Server1.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

El parámetro Filter especifica uno o varios mensajes mediante la sintaxis de filtro de OPATH. El filtro OPATH incluye un nombre de propiedad de mensaje seguido de un operador de comparación y un valor (por ejemplo, "FromAddress -like '*@contoso.com'"). Para obtener más información sobre las propiedades de mensajes filtrables y los operadores de comparación, consulte Propiedades de mensajes en colas y Búsqueda de colas y mensajes en colas en el Shell de administración de Exchange.

Puede especificar varios criterios mediante el operador de comparación y . Los valores de propiedad que no se expresen como un entero deben estar entre comillas (").

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

El parámetro Identity especifica el mensaje. La entrada válida para este parámetro debe usar la sintaxis Server\Queue\MessageInteger, Queue\MessageInteger o MessageInteger, por ejemplo, Mailbox01\contoso.com\5 o 10. Para obtener más información sobre la identidad del mensaje, consulte Identidad del mensaje.

Type:	MessageIdentity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

El parámetro Server especifica el servidor Exchange en el que desea ejecutar este comando. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

Name
FQDN
Distinguished name (DN)
Nombre distintivo (DN) heredado de Exchange

Nombre distintivo (DN) heredado de Exchange

No puede usar el parámetro Server y el parámetro Filter en el mismo comando. No puede usar el parámetro Server y el parámetro Identity en el mismo comando.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WithNDR

El parámetro WithNDR especifica si se devuelve un informe de no entrega (NDR) al remitente de un mensaje. El valor predeterminado es $true. Este parámetro se puede usar con los conjuntos de parámetros Identity y Filter.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.