Suspend-Message

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Suspend-Message, um die Zustellung einer bestimmten Nachricht in einer Warteschlange auf einem Postfachserver oder Edge-Transport-Server zu verhindern.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Suspend-Message
       -Filter <String>
       [-Server <ServerIdParameter>]
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]

Suspend-Message
       [-Identity] <MessageIdentity>
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]

Beschreibung

Eine Nachricht, die sich bereits im Zustellungsvorgang befindet, wird nicht angehalten. Die Zustellung wird fortgesetzt, und der Nachrichtenstatus lautet PendingSuspend. Wenn ein Fehler bei der Zustellung auftritt, wird die Nachricht erneut in die Warteschlange eingereiht und dann angehalten. Sie können eine Nachricht, die sich in der Warteschlange für nicht verarbeitbare Nachrichten befindet, nicht anhalten.

Eine Nachricht, die an mehrere Empfänger gesendet wird, kann sich in mehreren Warteschlangen befinden. Wenn Sie den Parameter Identity angeben, wird die Nachricht in einer Warteschlange angehalten, 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 anhalten möchten, müssen Sie den Parameter Filter verwenden.

Anweisungen zur Wiederaufnahme einer angehaltenen Nachricht finden Sie unter Resume-Message.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Suspend-Message -Server Server1 -Filter "FromAddress -eq 'kweku@contoso.com'"

In diesem Beispiel wird die Zustellung aller Nachrichten verhindert, für die die folgenden Kriterien zutreffen:

Die Nachrichten werden vom Absender kweku@contoso.comgesendet.
Die Nachrichten werden auf dem Server "Server1" in die Warteschlange eingereiht.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

Der Parameter Filter gibt eine oder mehrere Nachrichten mithilfe der OPATH-Filtersyntax an. Der OPATH-Filter enthält einen Nachrichteneigenschaftsnamen gefolgt von einem Vergleichsoperator und -wert (z. B "FromAddress -like '*@contoso.com'". ). Ausführliche Informationen zu filterbaren Nachrichteneigenschaften und Vergleichsoperatoren finden Sie unter Eigenschaften von Nachrichten in Warteschlangen und Suchen von Warteschlangen und Nachrichten in Warteschlangen in der Exchange-Verwaltungsshell.

Sie können mehrere Kriterien angeben, indem Sie den Vergleichsoperator und verwenden. Eigenschaftenwerte, die nicht als ganze Zahl ausgedrückt werden, müssen in Anführungszeichen (") eingeschlossen werden.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Der Parameter Identity gibt die Nachricht an. Gültige Eingaben für diesen Parameter verwenden die Syntax Server\Queue\MessageInteger oder Queue\MessageInteger oder MessageInteger, z. B. Mailbox01\contoso.com\5 oder 10. Ausführliche Informationen zur Nachrichtenidentität finden Sie unter Nachrichtenidentität.

Type:	MessageIdentity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Der Parameter "Server" gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

Name
FQDN
Distinguished Name (DN)
Exchange-Legacy-DN

Exchange-Legacy-DN

Der Server-Parameter kann zusammen mit dem Filter-Parameter in demselben Befehl verwendet werden. Die Identity- und Server-Parameter können daher nicht in demselben Befehl verwendet werden.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Freigeben über