Set-OMEMessageRevocation

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-OMEMessageRevocation para revocar Cifrado de mensajes de Microsoft Purview de un mensaje. La revocación del cifrado impide que el destinatario vea el mensaje en el portal OME.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Default (valor predeterminado)

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

Description

Cuando se revoca un correo electrónico, el destinatario recibe el siguiente error al intentar ver el mensaje cifrado en el portal OME: "El remitente ha revocado el mensaje".

Puede revocar los mensajes cifrados si el destinatario recibió un mensaje de correo electrónico cifrado de marca basado en vínculos. Si el destinatario recibió una experiencia nativa en línea en un cliente de Outlook compatible, no podrá revocar el cifrado del mensaje.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se revoca el cifrado del mensaje especificado.

Parámetros

-MessageId

Aplicable: Exchange Online

El parámetro MessageId especifica el mensaje en función del valor del campo de encabezado Message-ID. Este valor también se conoce como el identificador del cliente. El formato de Message-ID depende del servidor de mensajería que envió el mensaje. El valor debe ser único para cada mensaje. No obstante, no todos los servidores de mensajería crean valores para Message-ID del mismo modo. Asegúrese de incluir la cadena de Id. de mensaje completa (que podría incluir corchetes angulares) y de escribir el valor entre comillas (por ejemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").

Puede encontrar el identificador de mensaje de un mensaje en el seguimiento de mensajes o en el informe de cifrado de mensajes en el portal de cumplimiento de Microsoft Purview.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Revoke

Aplicable: Exchange Online

El parámetro Revoke especifica si se debe revocar el cifrado del mensaje. Los valores admitidos son:

  • $true: El cifrado del mensaje especificado está revocado. El destinatario recibe un error cuando intenta ver el mensaje cifrado en el portal OME
  • $false: el cifrado del mensaje especificado no se revocará. Este valor es el predeterminado.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.