Set-OMEMessageRevocation
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Set-OMEMessageRevocation para revogar Criptografia de Mensagens do Microsoft Purview de uma mensagem. Revogar a encriptação impede que o destinatário veja 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 (Padrão)
Set-OMEMessageRevocation
-MessageId <String>
-Revoke <Boolean>
[<CommonParameters>]
Description
Quando um e-mail é revogado, o destinatário recebe o seguinte erro quando tenta ver a mensagem encriptada no portal do OME: "A mensagem é revogada pelo remetente".
Pode revogar mensagens encriptadas se o destinatário tiver recebido uma mensagem de e-mail encriptada baseada na ligação. Se o destinatário tiver recebido uma experiência inline nativa num cliente do Outlook suportado, não poderá revogar a encriptação da mensagem.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 encriptação para a mensagem especificada.
Parâmetros
-MessageId
Aplicável: Exchange Online
O parâmetro MessageId especifica a mensagem com base no valor do campo 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 que inclui a cadeia de ID de Mensagem completa (que pode incluir parênteses angulares) e coloque o valor entre aspas (por exemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").
Pode encontrar o ID da Mensagem de uma mensagem no Rastreio de Mensagens ou no Relatório de Encriptação 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 pretende revogar a encriptação da mensagem. Os valores válidos são:
- $true: a encriptação da mensagem especificada é revogada. O destinatário recebe um erro quando tenta ver a mensagem encriptada no portal do OME
- $false: a encriptação da mensagem especificada não é revogada. Este valor é a predefiniçã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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.