Retry-Queue

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2008-03-11

Verwenden Sie das Cmdlet Retry-Queue, um einen Verbindungsversuch für eine Warteschlange auf einem Computer zu erzwingen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Retry-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]

Retry-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit dem Cmdlet Retry-Queue wird ein Verbindungsversuch für eine Warteschlange erzwungen, die den Status Wiederholen aufweist. Der Befehl stellt möglichenfalls eine Verbindung mit dem nächsten Hop her. Wenn eine Verbindung geplant ist, setzt dieser Befehl den nächsten Wiederholungszeitpunkt für eine Warteschlange auf die aktuelle Uhrzeit zurück, und ein Verbindungsversuch wird unternommen. Kommt keine Verbindung zustande, wird ein neuer Wiederholungszeitpunkt festgelegt. Mithilfe des Parameters Resubmit können Sie die erneute Übermittlung des Warteschlangeninhalts an das Kategorisierungsmodul veranlassen. Mit diesem Befehl können Sie die Zustellung von Nachrichten wiederholen, die in der Nicht erreichbar-Warteschlange stehen. Hierzu müssen Sie aber den Parameter Resubmit angeben.

Wenn Sie den Parameter Resubmit auf $false festlegen, erzwingt das Cmdlet Retry-Queue einen neuen Verbindungsversuch. Wenn Sie den Parameter Resubmit auf $false festlegen, werden die in der Warteschlange befindlichen Nachrichten erneut an das Kategorisierungsmodul übermittelt.

Hinweis

Sie können den Parameter Resubmit nur auf $true festlegen, wenn der Status der Remotewarteschlange Wiederholen ist.

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 wiederholen, 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 Retry-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 Retry-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 zu wiederholenden 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

    • 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 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 zu wiederholenden 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.

Resubmit

Optional

System.Boolean

Mithilfe des Parameters Resubmit können Sie angeben, ob vor dem Herstellen einer Verbindung die erneute Übermittlung des Warteschlangeninhalts an das Kategorisierungsmodul veranlasst werden soll. Legen Sie den Parameter Resubmit auf $false fest, um einen neuen Verbindungsversuch zu erzwingen. Legen Sie den Parameter Resubmit auf $false fest, damit die in der Warteschlange befindlichen Nachrichten erneut an das Kategorisierungsmodul übermittelt 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 wiederholt 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 für alle Warteschlangen, die den folgenden Kriterien entsprechen, ein Verbindungsversuch erzwungen wird:

  • Die Warteschlangen enthalten Nachrichten für die angegebene Domäne.

  • Die Warteschlangen haben den Status Wiederholen.

  • Die Warteschlangen befinden sich auf dem Server, auf dem der Befehl ausgeführt wird.

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

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}