Resume-Message (RTM)

Artikel
09/29/2014

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-08

Mit dem Cmdlet Resume-Message können Sie die Zustellung einer zuvor angehaltenen Nachricht in einer Warteschlange auf einem Computer aktivieren, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Resume-Message -Identity <MessageIdentity>

Resume-Message -Filter <String> [-Server <ServerIdParameter>]

Detaillierte Beschreibung

Das Cmdlet Resume-Message aktiviert die Zustellung einer zuvor angehaltenen Nachricht, die sich in einer Warteschlange auf einem Hub-Transport- oder Edge-Transport-Server 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 einzigen Warteschlange fortgesetzt, 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 fortsetzen 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 fortsetzen, indem Sie den Servernamen im Parameter Identity angeben oder den Parameter Server zusammen mit dem Parameter Filter verwenden. Wenn kein Server angegeben wird, wird der Befehl nur auf dem lokalen Server ausgeführt.

Damit Sie das Cmdlet Resume-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 Resume-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

Parameter	Erforderlich	Typ	Beschreibung
Filter	Erforderlich	System.String	Der Parameter Filter benötigt einen Ausdruck, mit dem die Eigenschaftswertkriterien für die fortzusetzenden Nachrichten angegeben werden. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Nachrichteneigenschaften stellen gültige Kriterien für den Parameter Filter 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 `Message-ID:`-Nachrichtenkopfzeilenfelds , das sich in der Kopfzeile befindet. 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 MessageIdentity anzugeben. Dies ist eine ganze Zahl, die 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
Server	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Mit dem Parameter Server geben Sie den Namen des Servers an, mit dem über Remoteprozeduraufrufe (Remote Procedure Call, RPC) eine Verbindung hergestellt werden soll und auf dem sich die Warteschlangen mit den Nachrichten befinden, die fortgesetzt werden sollen. Geben Sie den Parameter Server als Hostnamen oder vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) ein. Wird dieser Parameter nicht verwendet, wird der lokale Server abgefragt.

Filter

Erforderlich

System.String

Der Parameter Filter benötigt einen Ausdruck, mit dem die Eigenschaftswertkriterien für die fortzusetzenden Nachrichten angegeben werden. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Nachrichteneigenschaften stellen gültige Kriterien für den Parameter Filter 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 Message-ID:-Nachrichtenkopfzeilenfelds , das sich in der Kopfzeile befindet. 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 MessageIdentity anzugeben. Dies ist eine ganze Zahl, die 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

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Mit dem Parameter Server geben Sie den Namen des Servers an, mit dem über Remoteprozeduraufrufe (Remote Procedure Call, RPC) eine Verbindung hergestellt werden soll und auf dem sich die Warteschlangen mit den Nachrichten befinden, die fortgesetzt werden sollen. Geben Sie den Parameter Server als Hostnamen oder vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) ein. Wird dieser Parameter nicht verwendet, wird der lokale Server abgefragt.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Das folgende Beispiel zeigt, wie die Zustellung aller Nachrichten fortgesetzt wird, die sich im angehaltenen Zustand befinden und für die folgende Bedingungen erfüllt sind:

Die Nachrichten wurden von der SMTP-Adresse des angegebenen Absenders gesendet.
Die Nachrichten befinden sich in der Warteschlange auf dem Hub-Transport-Server oder auf dem Edge-Transport-Server, auf dem der Befehl ausgeführt wird.
Die Nachrichten laufen zum angegebenen Datum vor 15:00 Uhr ab.

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

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}