Resume-Queue

  • Artikel

 

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 Resume-Queue, um ausgehende Aktivitäten für eine angehaltene Warteschlange auf einem Computer erneut zu starten, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Resume-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Resume-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit dem Cmdlet Resume-Queue werden die ausgehenden Aktivitäten einer Warteschlange erneut gestartet, die den Status Angehalten aufweist. Wenn Sie einen Identity-Parameter angeben, wird die Warteschlange fortgesetzt, wenn diese Identität nur einer einzelnen Warteschlange entspricht. Wenn die Identität mehreren Warteschlangen entspricht, wird ein Fehler ausgegeben. Wenn Sie in einem Vorgang mehrere Warteschlangen fortsetzen möchten, müssen Sie einen Filter verwenden. 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 fortsetzen, indem Sie den Servernamen im Parameter Identity angeben oder den Parameter Server einer Filterabfrage hinzufügen. Wenn kein Server angegeben wird, wird der Befehl nur auf dem lokalen Server ausgeführt.

Damit Sie das Cmdlet Resume-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 Resume-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 Parameter Filter benötigt einen Ausdruck, mit dem die Eigenschaftswertkriterien für die fortzusetzenden Warteschlangen angegeben werden. 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

    • SmartHostConnetorDelivery

    • 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 Active, Ready, Retry und Suspended.

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

Mit dem Parameter Identity geben Sie die Identität der Warteschlange mit den fortzusetzenden Nachrichten an. 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.

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

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 Servernamen als Hostnamen oder als vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) ein. Wird dieser Parameter nicht verwendet, 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 Bindung an einen Remoteserver mithilfe von Remoteprozeduraufrufen (Remote Procedure Call, RPC) und Fortsetzungsaktivitäten für alle Warteschlangen hergestellt wird, wobei die NextHopDomain "Fourthcoffee.com" ist.

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

Resume-Queue -Server ExchSrv1.contoso.com -Filter {NextHopDomain -eq "Fourthcoffee.com"}