Suspend-Queue
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-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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit dem Cmdlet Suspend-Queue werden ausgehende Aktivitäten in einer Warteschlange beendet, die den Status Aktiv oder Wiederholen aufweist. Für Nachrichten, die aktuell mithilfe von SMTP-send übermittelt werden, wird die Übermittlung abgeschlossen. 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 mehr als einer Warteschlange 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:
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. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
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. 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 WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
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 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}