Freigeben über

Delete-QuarantineMessage

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Online, Security & Compliance, Exchange Online Protection

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Mit dem Cmdlet Delete-QuarantineMessage können Sie unter Quarantäne stehende Nachrichten aus Ihrer cloudbasierten Organisation löschen.

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

Syntax

Delete-QuarantineMessage
      -Identities <QuarantineMessageIdentity[]>
      [-Identity <QuarantineMessageIdentity>]
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]
Delete-QuarantineMessage
      -Identity <QuarantineMessageIdentity>
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

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

Delete-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7

In diesem Beispiel wird die unter Quarantäne stehende Nachricht mit dem angegebenen Identity-Wert gelöscht.

Beispiel 2

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identity $ids[4]

In diesem Beispiel wird die unter Quarantäne stehende Nachricht gelöscht, die in der Ergebnisliste von Get-QuarantineMessage an fünfter Stelle aufgeführt ist. Die erste Nachricht hat die Indexnummer 0, die zweite die Indexnummer 1 usw.

Beispiel 3

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identities $ids -Identity 000

In diesem Beispiel werden alle Nachrichten aus der Quarantäne gelöscht. Der Parameter Identity ist erforderlich, der Wert 000 wird jedoch ignoriert.

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 Online, Security & Compliance, Exchange Online Protection

-EntityType

Der EntityType-Parameter filtert die Ergebnisse nach EntityType. Gültige Werte sind:

  • E-Mails
  • SharePointOnline
  • Teams (derzeit in der Vorschau)
Type:Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-HardDelete

Der Schalter HardDelete gibt an, dass die Nachricht endgültig gelöscht und nicht wiederhergestellt werden kann. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Schalter nicht verwenden, wird die Nachricht gelöscht, kann aber möglicherweise wiederhergestellt werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

Der Parameter Identities identifiziert unter Quarantäne gestellte Nachrichten für Massenvorgänge. Sie identifizieren die Nachrichten mithilfe der Syntax: value1,value2...valueN. Jeder Wert ist ein eindeutiger, in Quarantäne befindlicher Nachrichtenbezeichner im Format GUID1\GUID2 (z. B c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7. ).

Sie finden den Identity-Wert für eine Nachricht in Quarantäne mithilfe des Cmdlets Get-QuarantineMessage.

Wenn Sie diesen Parameter verwenden, ist der Identity-Parameter erforderlich, aber der Wert wird ignoriert. Verwenden Sie beispielsweise den Wert 000 für den Identity-Parameter.

Type:QuarantineMessageIdentity[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

Der Parameter Identity gibt an, welche der unter Quarantäne gestellten Nachrichten gelöscht werden soll. Der Wert ist ein eindeutiger, in Quarantäne befindlicher Nachrichtenbezeichner im Format GUID1\GUID2 (z. B c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7. ).

Sie finden den Identity-Wert für eine Nachricht in Quarantäne mithilfe des Cmdlets Get-QuarantineMessage.

Type:QuarantineMessageIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RecipientAddress

Der RecipientAddress-Parameter filtert die Ergebnisse nach der E-Mail-Adresse des Empfängers. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-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.

Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection