Remove-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 Remove-Message, um eine Nachricht aus der Warteschlange auf einem Postfachserver oder Edge-Transport-Server zu löschen.

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

Syntax

Remove-Message
      -Filter <String>
      [-Server <ServerIdParameter>]
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Remove-Message
      [-Identity] <MessageIdentity>
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Beschreibung

Eine Nachricht, die an mehrere Empfänger übertragen wird, befindet sich möglicherweise in mehreren Warteschlangen. Wenn Sie einen Identity-Parameter angeben, wird die Nachricht aus einer einzelnen Warteschlange entfernt, wenn diese Identität nur mit einer einzelnen Nachricht übereinstimmt. Wenn die Identität mehreren Nachrichten entspricht, wird ein Fehler ausgegeben. Um eine Nachricht aus mehr als einer Warteschlange in einem einzelnen Vorgang zu entfernen, müssen Sie den Filter-Parameter verwenden. Wenn Sie versuchen, eine aktuell zugestellte Nachricht zu entfernen, ändert sich der Status der Nachricht in Ausstehendes Löschen. Die Nachrichtenübermittlung wird nicht unterbrochen, aber wenn bei der Übermittlung ein Fehler auftritt und die Nachricht erneut in die Warteschlange eingereiht wird, wird sie entfernt.

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

Remove-Message -Server Server1 -Filter "FromAddress -eq 'Kweku@contoso.com'" -WithNDR $false

In diesem Beispiel werden alle Nachrichten entfernt, die die folgenden Kriterien erfüllen. Unzustellbarkeitsberichte werden nicht generiert:

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

-WithNDR

Der Parameter WithNDR gibt an, ob ein Unzustellbarkeitsbericht (Non-delivery Report, NDR) an den Absender einer Nachricht zurückgeschickt werden soll. Der Standardwert ist $true. Dieser Parameter kann zusammen mit dem Identity-Parameter und den Filter-Parametersätzen verwendet werden.

Type:	Boolean
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.