Set-OMEMessageRevocation

參考

模組:: ExchangePowerShell

適用於:: Exchange Online

此指令程式只能在雲端式服務中使用。

使用 Set-OMEMessageRevocation Cmdlet 撤銷訊息的Microsoft Purview 郵件加密。撤銷加密可防止收件者在 OME 入口網站中檢視郵件。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

撤銷電子郵件後，當收件者嘗試在 OME 入口網站中檢視加密的郵件時，會收到下列錯誤：「寄件者已撤銷郵件」。

如果收件者收到以連結為基礎的品牌加密電子郵件訊息，您可以撤銷加密的郵件。如果收件者已在支援的 Outlook 用戶端中收到原生內嵌體驗，則您無法撤銷郵件的加密。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

此範例會撤銷指定訊息的加密。

參數

-MessageId

MessageId 參數會根據 Message-ID 標頭欄位的值來指定訊息。此值也稱為「用戶端識別碼」。 Message-ID 的格式取決於傳送郵件的訊息伺服器。每封郵件都僅具有唯一值。然而，並非所有訊息伺服器都使用相同的方法來建立 Message-ID 的值。請務必包含完整的訊息識別碼字串 (其中可能包含角括弧) ，並將值括在引號 (例如「 d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com 」) 。

您可以在訊息追蹤中找到訊息的訊息識別碼，或在Microsoft Purview 合規性入口網站中找到訊息加密報告。

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

-Revoke

Revoke 參數會指定是否要撤銷訊息的加密。有效值為：

$true：已撤銷指定訊息的加密。當收件者嘗試在 OME 入口網站中檢視加密的郵件時，會收到錯誤訊息
$false：不會撤銷指定訊息的加密。這是預設值。

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