(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

Remove-Message

 

Gilt für: Exchange Server 2013

Letztes Änderungsdatum des Themas: 2014-03-05

Dieses Cmdlet ist nur lokal 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 Parameter Identity gibt die Nachricht an. Gültige Eingaben für diesen Parameter verwenden sie Syntax Server\Queue\MessageInteger oder Queue\MessageInteger oder MessageInteger, z. B. Mailbox01\contoso.com\5 oder 10. Genaue Informationen über Nachrichtenidentität finden Sie im Abschnitt "Nachrichtenidentität" unter 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 die 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.

Sie können die Parameter Server und Filter innerhalb desselben Befehls verwenden. Sie können die Parameter Server und Identity nicht innerhalb desselben Befehls verwenden.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Die Option WhatIf weist den Befehl an, die für das Objekt ausgeführten 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 die Option WhatIf 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.

 
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2014 Microsoft