Set-OMEMessageRevocation

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Online

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Set-OMEMessageRevocation para revogar Criptografia de Mensagens do Microsoft Purview para uma mensagem. A revogação da criptografia impede que o destinatário visualize a mensagem no portal do OME.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

Quando um email for revogado, o destinatário receberá o seguinte erro ao tentar exibir a mensagem criptografada no portal do OME: "A mensagem foi revogada pelo remetente".

Você pode revogar mensagens criptografadas se o destinatário receber uma mensagem de email criptografada baseada em link e com marca. Se o destinatário recebeu uma experiência embutida nativa em um cliente do Outlook com suporte, você não poderá revogar a criptografia da mensagem.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

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

Este exemplo revoga a criptografia para a mensagem especificada.

Parâmetros

-MessageId

O parâmetro MessageId especifica a mensagem com base no valor do campo cabeçalho ID de mensagem. Este valor é conhecido também como ID do cliente. O formato da Message-ID depende do Messaging Server que envia a mensagem. O valor deve ser exclusivo para cada mensagem. No entanto, nem todos os Messaging Servers criam valores para o Message-ID da mesma maneira. Certifique-se de incluir a cadeia de caracteres ID de mensagem completa (que pode incluir colchetes de ângulo) e incluir o valor entre aspas (por exemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").

Você pode encontrar a ID da Mensagem para uma mensagem no Rastreamento de Mensagens ou no Relatório de Criptografia de Mensagens no portal de conformidade do Microsoft Purview.

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

-Revoke

O parâmetro Revoke especifica se a criptografia deve ser revogada para a mensagem. Os valores válidos são:

$true: a criptografia da mensagem especificada é revogada. O destinatário receberá um erro ao tentar exibir a mensagem criptografada no portal do OME
$false: A criptografia da mensagem especificada não é revogada. Esse é o valor padrão.

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