Set-OMEMessageRevocation

Modulo:

ExchangePowerShell

Si applica a:

Exchange Online

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-OMEMessageRevocation per revocare Microsoft Purview Message Encryption per un messaggio. La revoca della crittografia impedisce al destinatario di visualizzare il messaggio nel portale OME.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Quando un messaggio di posta elettronica è stato revocato, il destinatario riceverà l'errore seguente quando tenta di visualizzare il messaggio crittografato nel portale OME: "Il messaggio è stato revocato dal mittente".

È possibile revocare i messaggi crittografati se il destinatario ha ricevuto un messaggio di posta elettronica crittografato basato su collegamento. Se il destinatario ha ricevuto un'esperienza inline nativa in un client Outlook supportato, non è possibile revocare la crittografia per il messaggio.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

In questo esempio viene revocata la crittografia per il messaggio specificato.

Parametri

-MessageId

Il parametro MessageId consente di specificare il messaggio in base al valore del campo di intestazione Message-ID. Questo valore è anche noto come ID client. Il formato di Message-ID dipende dal server di messaggistica che ha inviato il messaggio. Questo valore deve essere univoco per ciascun messaggio. Tuttavia, non tutti i server di messaggistica creano i valori di Message-ID nello stesso modo. Assicurarsi di includere la stringa id messaggio completa (che può includere parentesi angolari) e racchiudere il valore tra virgolette (ad esempio, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").

È possibile trovare l'ID messaggio per un messaggio in Traccia messaggi o il report di crittografia dei messaggi nel Portale di conformità di Microsoft Purview.

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

-Revoke

Il parametro Revoke specifica se revocare la crittografia per il messaggio. I valori validi sono:

• $true: la crittografia per il messaggio specificato viene revocata. Il destinatario riceverà un errore quando tenta di visualizzare il messaggio crittografato nel portale OME
• $false: la crittografia per il messaggio specificato non viene revocata. Questo è il valore predefinito.

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