Remove-Message

 

Gilt für:Exchange Server 2013

Dieses Cmdlet ist nur lokal in Exchange Server 2013 verfügbar.

Verwenden Sie das Cmdlet Remove-Message, um eine Nachricht aus der Warteschlange auf einem Postfachserver oder Edge-Transport-Server zu löschen.

Remove-Message -Filter <String> [-Server <ServerIdParameter>] <COMMON PARAMETERS>
Remove-Message -Identity <MessageIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

In diesem Beispiel werden alle Nachrichten entfernt, die die folgenden Kriterien erfüllen. Unzustellbarkeitsberichte werden nicht generiert:

  • Die Nachrichten wurden vom Absender Kweku@contoso.com gesendet.

  • Die Nachrichten werden auf dem Server "Server1" in die Warteschlange eingereiht.

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

Eine Nachricht, die an mehrere Empfänger übermittelt wird, kann sich in mehreren Warteschlangen befinden. Wenn Sie den Parameter Identity angeben, wird die Nachricht aus einer einzigen Warteschlange gelöscht, wenn diese Identität nur einer einzigen Nachricht entspricht. Wenn die Identität mehreren Nachrichten entspricht, wird ein Fehler ausgegeben. Um eine Nachricht in einem einzigen Vorgang aus mehreren Warteschlangen zu entfernen, müssen Sie den Parameter Filter verwenden. Wenn Sie versuchen, eine Nachricht zu entfernen, die zurzeit zugestellt wird, ändert sich der Nachrichtenstatus in PendingDelete. Die Nachrichtenzustellung wird nicht unterbrochen. Tritt bei der Zustellung jedoch ein Fehler auf, der bewirkt, dass die Nachricht erneut in die Warteschlange eingereiht wird, wird sie entfernt.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Warteschlangen" im Thema Berechtigungen für den Nachrichtenfluss.

 

Parameter Erforderlich Typ Beschreibung

Filter

Erforderlich

System.String

Mit dem Parameter Filter werden mit der OPath-Filtersyntax eine oder mehrere Nachrichten angegeben. Der OPath-Filter beinhaltet einen Eigenschaftennamen für eine Nachricht gefolgt von einem Vergleichsoperator und -wert, wie zum Beispiel {FromAddress -like "*@contoso.com"}. Einzelheiten zu filterbaren Nachrichteneigenschaften und Vergleichsoperatoren finden Sie unter Nachrichtenfilter und Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

Mithilfe des Vergleichsoperators and können mehrere Kriterien angegeben werden. Eigenschaftenwerte, die nicht als ganze Zahl ausgedrückt werden, müssen in Anführungszeichen (") eingeschlossen werden.

Identity

Erforderlich

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Der Identity-Parameter gibt die Nachricht an. Eine gültige Eingabe für diesen Parameter verwendet die Syntax Server\Queue\MessageInteger oder Queue\MessageInteger oder MessageInteger, z. B. Mailbox01\contoso.com\5 oder 10. Nähere Informationen zu Nachrichtenidentität finden Sie im Abschnitt „Nachrichtenidentität“ in Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

Confirm

Optional

System.Management.Automation.SwitchParameter

Die Option Confirm kann zum Unterdrücken der Bestätigungsaufforderung verwendet werden, die standardmäßig angezeigt wird, wenn dieses Cmdlet ausgeführt wird. Verwenden Sie zum Unterdrücken dieser Bestätigungsaufforderung die Syntax -Confirm:$False. Sie müssen einen Doppelpunkt (:) in der Syntax einfügen.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Der Parameter Server gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Sie können einen beliebigen Wert verwenden, der den Server eindeutig identifiziert. Beispiel:

  • Name

  • FQDN

  • Distinguished Name (DN)

  • Exchange-Legacy-DN

Wenn Sie den Parameter Server nicht verwenden, wird der Befehl auf dem lokalen Server ausgeführt.

Der Server-Parameter kann zusammen mit dem Filter-Parameter in demselben Befehl verwendet werden. Die Identity- und Server-Parameter können daher nicht in demselben Befehl verwendet werden.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Die Option WhatIf weist den Befehl an, die für das Objekt auszuführenden Aktionen zu simulieren. Durch Verwendung der Option WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für dieWhatIf-Option muss kein Wert angegeben werden.

WithNDR

Optional

System.Boolean

Der Parameter WithNDR gibt an, ob ein Unzustellbarkeitsbericht (Non-delivery Report, NDR) an den Absender einer Nachricht zurückgeschickt werden soll. Der Standardwert ist $true. Dieser Parameter kann zusammen mit dem Identity-Parameter und den Filter-Parametersätzen verwendet werden.

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets . Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: