Set-OMEMessageRevocation

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online

此 cmdlet 仅在基于云的服务中可用。

使用 Set-OMEMessageRevocation cmdlet 撤消消息Microsoft Purview 邮件加密。 撤销加密会阻止收件人在 OME 门户中查看邮件。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

撤销电子邮件后，收件人在尝试在 OME 门户中查看加密邮件时会收到以下错误：“邮件已被发件人撤销”。

如果收件人收到基于链接的品牌加密电子邮件，则可以撤销加密邮件。 如果收件人在受支持的 Outlook 客户端中收到了本机内联体验，则无法撤消邮件加密。

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 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 标头字段的值指定消息。 此值也称为“客户端 ID”。 Message-ID 的格式取决于发送邮件的消息传送服务器。 此值应对每封邮件都是唯一的。 但是，并非所有消息传送服务器都会以相同方式创建 Message-ID 的值。 请务必包含完整的消息 ID 字符串 (可能包含尖括号) 并将值括在引号 (例如“d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com”) 。

可以在“邮件跟踪”或“邮件加密报告”Microsoft Purview 合规门户中找到邮件的消息 ID。

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