Suspend-Message
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 Suspend-Message, um die Zustellung einer Nachricht aus einer Warteschlange auf einem Computer zu verhindern, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Suspend-Message verhindert die Zustellung mindestens einer Nachricht aus einer Warteschlange auf einem Hub-Transport-Servercomputer oder einem Edge-Transport-Servercomputer. Eine Nachricht, die sich bereits im Zustellungsvorgang befindet, wird nicht angehalten. Die Zustellung wird fortgesetzt, und der Nachrichtenstatus lautet PendingSuspend. Wenn ein Fehler bei der Zustellung auftritt, wird die Nachricht erneut in die Warteschlange eingereiht und dann angehalten. Sie können keine Nachricht anhalten, die sich in der Übermittlungswarteschlange oder der Warteschlange für nicht verarbeitete Nachrichten befindet.
Eine Nachricht, die an mehrere Empfänger gesendet wird, kann sich in mehreren Warteschlangen befinden. Wenn Sie einen Identity-Parameter angeben, wird die Nachricht in einer Warteschlange angehalten, 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 in mehreren Warteschlangen anhalten möchten, müssen Sie einen Filter verwenden. Es muss ein Identity-Parameter oder ein Filter-Parameter verwendet werden. Diese zwei Parametersätze schließen sich gegenseitig aus.
Sie können eine Nachricht auf einem Remoteserver anhalten, indem Sie den Servernamen als Teil des Identity-Parameters oder den Server-Parameter zusammen mit dem Filter-Parameter verwenden. Wenn kein Server angegeben wird, wird der Befehl nur auf dem lokalen Server ausgeführt.
Damit Sie das Cmdlet Suspend-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 Suspend-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 anhalten 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:
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:
|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm 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 anzuhaltenden Nachrichten gespeichert sind, und mit dem mithilfe von RPC-Aufrufen (Remote Procedure Call) eine Verbindung hergestellt werden soll. Geben Sie den Server-Namen 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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Beispiel zeigt, wie die Zustellung aller Nachrichten verhindert wird, für die die folgenden Kriterien wahr sind:
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.
Weitere Informationen zum Verwenden der Exchange-Verwaltungsshell für Aufgaben der Warteschlangenanzeige finden Sie unter Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.
Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}