Set-OMEMessageRevocation
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 de 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.
Sintaxe
Default (Default)
Set-OMEMessageRevocation
-MessageId <String>
-Revoke <Boolean>
[<CommonParameters>]
Description
Quando um email é revogado, o destinatário recebe o seguinte erro ao tentar exibir a mensagem criptografada no portal OME: "A mensagem foi revogada pelo remetente".
Você pode revogar mensagens criptografadas se o destinatário recebeu uma mensagem de email criptografada baseada em link e com marca. Se o destinatário recebeu uma experiência nativa embutida em um cliente Outlook compatível, você não pode revogar a criptografia da mensagem.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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
Aplicável: Exchange Online
O parâmetro MessageId especifica a mensagem com base no valor do campo de cabeçalho Message-ID. 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 completa da ID da mensagem (que pode incluir colchetes angulares) e coloque 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Revoke
Aplicável: Exchange Online
O parâmetro Revoke especifica se a criptografia da mensagem deve ser revogada. Os valores válidos são:
- $true: A criptografia para a mensagem especificada é revogada. O destinatário recebe um erro ao tentar exibir a mensagem criptografada no portal OME
- $false: a criptografia da mensagem especificada não é revogada. Esse valor é o padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.