Set-OMEMessageRevocation

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Online

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Set-OMEMessageRevocation, um Microsoft Purview-Nachrichtenverschlüsselung für eine Nachricht zu widerrufen. Das Widerrufen der Verschlüsselung verhindert, dass der Empfänger die Nachricht im OME-Portal anzeigt.

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

Syntax

Set-OMEMessageRevocation
   -MessageId <String>
   -Revoke <Boolean>
   [<CommonParameters>]

Beschreibung

Wenn eine E-Mail widerrufen wurde, erhält der Empfänger die folgende Fehlermeldung, wenn er versucht, die verschlüsselte Nachricht im OME-Portal anzuzeigen: "Die Nachricht wurde vom Absender widerrufen".

Sie können verschlüsselte Nachrichten widerrufen, wenn der Empfänger eine linkbasierte, verschlüsselte E-Mail-Nachricht mit Branding erhalten hat. Wenn der Empfänger eine native Inlineumgebung in einem unterstützten Outlook-Client erhalten hat, können Sie die Verschlüsselung für die Nachricht nicht widerrufen.

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

Set-OMEMessageRevocation -MessageId "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>" -Revoke $true

In diesem Beispiel wird die Verschlüsselung für die angegebene Nachricht widerrufen.

Parameter

-MessageId

Der Parameter MessageId gibt die Nachricht basierend auf dem Wert des Headerfelds Message-ID an. Dieser Wert wird auch Client-ID genannt. Das Format der Message-ID hängt von dem Messagingserver ab, der die Nachricht gesendet hat. Der Wert muss für jede Nachricht eindeutig sein. Allerdings erstellen nicht alle Messagingserver Werte für die Message-ID auf dieselbe Weise. Achten Sie darauf, die vollständige Nachrichten-ID-Zeichenfolge (die spitze Klammern enthalten kann) einzuschließen und den Wert in Anführungszeichen (z. B. "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com") einzuschließen.

Sie finden die Nachrichten-ID für eine Nachricht in der Nachrichtenablaufverfolgung oder im Meldungsverschlüsselungsbericht im Microsoft Purview-Complianceportal.

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

-Revoke

Der Revoke-Parameter gibt an, ob die Verschlüsselung für die Nachricht widerrufen werden soll. Gültige Werte sind:

$true: Die Verschlüsselung für die angegebene Nachricht wird widerrufen. Der Empfänger erhält einen Fehler, wenn er versucht, die verschlüsselte Nachricht im OME-Portal anzuzeigen.
$false: Die Verschlüsselung für die angegebene Nachricht wird nicht widerrufen. Dies ist der Standardwert.

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