Freigeben über

Suspend-Queue (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-08

Verwenden Sie das Cmdlet Suspend-Queue, um ausgehende Aktivitäten für eine Warteschlange auf einem Computer zu beenden, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Suspend-Queue -Identity <QueueIdentity>

Suspend-Queue -Filter <String> [-Server <ServerIdParameter>]

Detaillierte Beschreibung

Mit dem Cmdlet Suspend-Queue werden ausgehende Aktivitäten in einer Warteschlange beendet, die den Status Aktiv oder Wiederholen aufweist. In der Verarbeitung befindliche SMTP-Sendevorgänge von Nachrichten werden zuerst fertig gestellt. Keine weiteren Nachrichten verlassen die Warteschlange. Wenn Sie einen Identity-Parameter angeben, wird die Warteschlange angehalten, wenn die Identität nur einer einzelnen Warteschlange entspricht. Wenn die Identität mehreren Warteschlangen entspricht, wird ein Fehler ausgegeben. Es muss ein Filter verwendet werden, um mehrere Warteschlangen in einem einzelnen Vorgang anzuhalten.

Es muss ein Identity-Parameter oder ein Filter-Parameter verwendet werden. Die Parametersätze Identity und Filter schließen sich gegenseitig aus. Sie können eine Warteschlange auf einem Remoteserver anhalten, indem Sie den Servernamen als Teil des Identity-Parameters verwenden oder den Server-Parameter zusammen mit einer Filterabfrage verwenden. Wenn kein Server angegeben wird, wird der Befehl nur auf dem lokalen Server ausgeführt.

Damit Sie das Cmdlet Suspend-Queue ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

Um das Cmdlet Suspend-Queue 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 erfordert einen Ausdruck, der das Eigenschaftenwertkriterium für die anzuhaltenden Warteschlangen angibt. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Warteschlangeneigenschaften stellen gültige Kriterien für den Filter-Parameter dar:

  • DeliveryType   Der Übermittlungstyp für die betreffende Warteschlange, wie er durch den Transport definiert ist. Der Übermittlungstyp muss einen der folgenden Werte aufweisen:

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Nicht definiert

    • Nicht erreichbar

  • Identity   Geben Sie die Warteschlangen-ID in der Form Server\Ziel ein, wobei Ziel für eine Remotedomäne, einen Postfachserver oder den Namen einer beständigen Warteschlange steht.

  • LastError   Eine Textzeichenfolge mit dem letzten für eine Warteschlange aufgezeichneten Fehler.

  • LastRetryTime   Der Zeitpunkt des letzten Verbindungsversuchs für die betreffende Warteschlange.

  • MessageCount   Die Anzahl der Zeilen in der Warteschlange.

  • NextHopConnector   Die GUID des Connectors, der zum Erstellen der Warteschlange verwendet wurde.

  • NextHopDomain   Die nächste Hopdomäne der Warteschlange, die als SMTP-Domäne (Simple Mail Transfer Protocol), als Servername, als Name eines Active Directory-Standorts oder als Nachrichtendatenbank-ID (MDB) angegeben ist.

  • NextRetryTime   Der Zeitpunkt, zu dem der nächste Verbindungsversuch für die betreffende Warteschlange ausgeführt wird.

  • Status   Der Status der Warteschlange. Die Optionen für den Warteschlangenstatus sind Aktiv, Bereit, Wiederholen und Angehalten.

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

Identity

Erforderlich

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Verwenden Sie den Identity-Parameter, um die Identität der Warteschlange anzugeben, die die anzuhaltenden Nachrichten enthält. 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.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Verwenden Sie den Server-Parameter, um den Namen des Servers anzugeben, mit dem die Verbindung mithilfe von RPC (Remote Procedure Call) hergestellt werden soll und der die Warteschlangen mit den anzuhaltenden Nachrichten enthält. Geben Sie den Servernamen als Hostnamen oder als 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 veranschaulicht zwei Suspend-Queue-Befehle. Der erste Befehl hält ausgehende Aktivitäten in allen Warteschlangen an, die Nachrichten für die Übermittlung an die angegebene Domäne enthalten und aktuell den Status Wiederholen aufweisen.

Der zweite Befehl bindet mithilfe von RPC an einen Remoteserver und hält alle Warteschlangen an, die mehr als 100 Nachrichten aufweisen.

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

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}