Remove-Message

Artikel
09/29/2014

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-06-28

Verwenden Sie das Cmdlet Remove-Message, um eine Nachricht aus einer Warteschlange auf einem Computer zu entfernen, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist.

Syntax

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

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

Detaillierte Beschreibung

Das Cmdlet Remove-Message löscht mindestens eine Nachricht aus einer Warteschlange auf einem Hub-Transport-Servercomputer oder einem Edge-Transport-Servercomputer. Eine Nachricht, die an mehrere Empfänger übertragen wird, kann sich in mehreren Warteschlangen befinden. Wenn Sie einen Identity-Parameter angeben, wird die Nachricht aus einer Warteschlange gelöscht, wenn diese Identität nur einer einzelnen Nachricht entspricht. Wenn die Identität mehreren Nachrichten entspricht, wird ein Fehler ausgegeben. Wenn Sie eine Nachricht in einem Vorgang aus mehreren Warteschlangen entfernen möchten, müssen Sie einen Filter verwenden. Wenn Sie versuchen, eine Nachricht zu entfernen, die zurzeit zugestellt wird, ändert sich der Nachrichtenstatus in "PendingDelete". Die Nachrichtenzustellung wird nicht unterbrochen, doch wenn ein Fehler bei der Zustellung auftritt, der bewirkt, dass die Nachricht erneut in die Warteschlange eingereiht wird, wird sie entfernt.

Es muss ein Identity-Parameter oder ein Filter-Parameter verwendet werden. Diese zwei Parametersätze schließen sich gegenseitig aus.

Damit Sie das Cmdlet Remove-Message ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.

Um das Cmdlet Remove-Message auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter	Erforderlich	Typ	Beschreibung
Filter	Erforderlich	System.String	Der Filter-Parameter verlangt einen Ausdruck, der die Kriterien des Eigenschaftenwerts für die Nachrichten angibt, die Sie entfernen möchten. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Nachrichteneigenschaften stellen gültige Kriterien für den Filter-Parameter dar: DateReceived Das Datum, an dem die Nachricht empfangen wurde. ExpirationTime Die Uhrzeit, zu der die Nachricht abläuft. FromAddress Die SMTP-Adresse (Simple Mail Transfer Protocol) des Absenders einer Nachricht. Dieser Wert wird von `MAIL FROM:` im Nachrichtenumschlag übernommen. Identity Eine ganze Zahl, die eine bestimmte Nachricht und eine optionale Server- und Warteschlangenidentität darstellt. InternetMessageId Der Wert des Kopfzeilenfelds `Message-ID:`. Diese Eigenschaft wird als GUID, gefolgt von der SMTP-Adresse des sendenden Servers, ausgedrückt; siehe folgendes Beispiel: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com. LastError Eine Textzeichenfolge mit dem letzten für eine Nachricht aufgezeichneten Fehler. MessageSourceName Eine Textzeichenfolge mit dem Namen der Komponente, die diese Nachricht an die Warteschlange gesendet hat. Queue Gibt die Identität der Warteschlange an, in der sich die Nachricht befindet. Geben Sie die Warteschlangenidentität in der Form Server\Ziel ein, wobei Ziel für eine Remotedomäne, einen Postfachserver oder den Namen einer beständigen Warteschlange steht. RetryCount Die Anzahl der Übermittlungsversuche einer Nachricht an ein Ziel. SCL Die SCL-Eigenschaft gibt die SCL-Bewertung (Spam Confidence Level) einer Nachricht an. Gültige SCL-Einträge sind die ganzen Zahlen von 0 bis 9. Ein leerer SCL-Eigenschaftenwert zeigt an, dass die Nachricht nicht vom Inhaltsfilter-Agent verarbeitet wurde. Size Die Größe der Nachricht. SourceIP Die IP-Adresse des externen Servers, der die Nachricht an die Exchange-Organisation gesendet hat. Status Der aktuelle Nachrichtenstatus. Die Optionen für den Nachrichtenstatus sind Active, Retry, Suspended, PendingSuspend und PendingRemove. Subject Eine Textzeichenfolge, die den Betreff einer E-Mail-Nachricht darstellt. Der Wert wird aus dem Kopfzeilenfeld `Subject:` übernommen. Mithilfe des Vergleichsoperators -and können mehrere Filterkriterien angegeben werden. Eigenschaftenwerte, die nicht als einzelne ganze Zahl ausgedrückt sind, müssen in Anführungszeichen eingeschlossen werden.
Identity	Erforderlich	Microsoft.Exchange.Data.QueueViewer.MessageIdentity	Verwenden Sie den Identity-Parameter, um die ganze Zahl für den MessageIdentity-Wert anzugeben, der eine bestimmte Nachricht und eine optionale Server- und Warteschlangenidentität darstellt. Für diesen Parameter gilt die folgende Syntax: Server\QueueIdentity\MessageIdentity QueueIdentity\MessageIdentity Server\*\MessageIdentity MessageIdentity
Confirm	Optional	System.Management.Automation.SwitchParameter	Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden.
Server	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Verwenden Sie den Server-Parameter, um den Namen des Servers anzugeben, der die Warteschlangen enthält, in denen die zu entfernenden Nachrichten gespeichert sind, und mit dem mithilfe von RPC-Aufrufen (Remote Procedure Call) eine Verbindung hergestellt werden soll. Geben Sie den Server-Parameter als Hostnamen oder als vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) ein. Wenn dieser Parameter nicht verwendet wird, wird der lokale Server abgefragt.
WhatIf	Optional	System.Management.Automation.SwitchParameter	Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden.
WithNDR	Optional	System.Boolean	Verwenden Sie den WithNDR-Parameter, wenn Sie angeben möchten, ob ein Unzustellbarkeitsbericht an den Absender der Nachricht zurückgegeben werden soll. Das Standardverhalten dieses Parameters ist auf `$true` festgelegt. Dieser Parameter kann zusammen mit dem Identity-Parameter und den Filter-Parametersätzen verwendet werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Das folgende Beispiel zeigt, wie alle Nachrichten entfernt werden, die den folgenden Kriterien entsprechen:

Die Nachrichten werden von der SMTP-Adresse des angegebenen Absenders gesendet.
Die Nachrichten werden auf dem Hub-Transport-Servercomputer oder dem Edge-Transport-Servercomputer, auf dem der Befehl ausgeführt wird, in die Warteschlange eingefügt.

Das folgende Beispiel zeigt außerdem, wie der Unzustellbarkeitsbericht unterdrückt wird.

Weitere Informationen zum Verwenden der Exchange-Verwaltungsshell für Aufgaben der Warteschlangenanzeige Sie unter Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

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

Freigeben über