Release-QuarantineMessage

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Online, Security & Compliance, Exchange Online Protection

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

Utilice el cmdlet Release-QuarantineMessage para liberar mensajes de la cuarentena en una organización basada en la nube. Puede liberar mensajes para todos los destinatarios originales o para destinatarios específicos.

En el caso de los archivos en cuarentena por datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams, puede desbloquear los archivos en los sitios de equipo y bibliotecas de documentos respectivos mediante el cmdlet Release-QuarantineMessage para que los usuarios puedan acceder a los archivos, compartirlos y descargarlos.

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.

Syntax

Release-QuarantineMessage
       -User <String[]>
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-ReleaseToAll]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       -Identities <QuarantineMessageIdentity[]>
       [-Identity <QuarantineMessageIdentity>]
       [-ActionType <ReleaseActionType>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       -Identity <QuarantineMessageIdentity>
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Description

Tenga en cuenta el siguiente escenario: john@gmail.com envía un mensaje a faith@contoso.com y john@subsidiary.contoso.com. Gmail bifurca este mensaje en dos copias que se enrutan a la cuarentena como suplantación de identidad (phishing) en Microsoft. Un administrador libera ambos mensajes en admin@contoso.com. Se entrega el primer mensaje publicado que llega al buzón de administración. El segundo mensaje publicado se identifica como entrega duplicada y se omite. Los mensajes se identifican como duplicados si tienen el mismo identificador de mensaje y la misma hora de recepción.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.com

En este ejemplo se usa el cmdlet Get-QuarantineMessage para liberar el mensaje en cuarentena con el valor <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> message-id para un destinatario julia@contoso.comoriginal.

Ejemplo 2

Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll

En este ejemplo se libera el mensaje en cuarentena con el valor Identity especificado a todos los destinatarios originales.

Ejemplo 3

Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll

En este ejemplo se liberan todos los mensajes a todos los destinatarios originales.

Ejemplo 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

$q[-1] | Release-QuarantineMessage -ReleaseToAll

En este ejemplo se libera un archivo que se puso en cuarentena como parte de Datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams. El primer comando almacena todos los archivos en cuarentena en la variable $q. El segundo comando libera el último archivo de la lista. Para obtener más información sobre los elementos de matrices y números de índice, vea Acceso y uso de elementos de matriz.

Parámetros

-ActionType

El parámetro ActionType especifica el tipo de acción de versión. Los valores válidos son:

Aprobar
Denegar
Versión
Solicitud

Type:	ReleaseActionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-AllowSender

El modificador AllowSender especifica que no se ponen en cuarentena todos los mensajes futuros del remitente. No es necesario especificar un valor con este modificador.

Si el mensaje se puso en cuarentena debido a una regla de transporte o a un remitente bloqueado, los mensajes del remitente se pueden seguir bloqueando en el futuro.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

El parámetro EntityType filtra los resultados por EntityType. Los valores admitidos son:

Correo electrónico
SharePointOnline
Teams (actualmente en versión preliminar)

Type:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Force

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Use este modificador cada vez que intente volver a publicar los mensajes publicados anteriormente de la cuarentena.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

El parámetro Identities identifica los mensajes en cuarentena para las operaciones masivas. Los mensajes se identifican mediante la sintaxis : value1,value2,...valueN. El valor es un identificador de mensaje en cuarentena único en el formato GUID1\GUID2 (por ejemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Puede encontrar el valor de identidad de un mensaje en cuarentena mediante el cmdlet Get-QuarantineMessage.

Cuando se usa este parámetro, se requiere el parámetro Identity, pero se omite el valor. Por ejemplo, use el valor 000 para el parámetro Identity.

Type:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

El parámetro Identity especifica el mensaje en cuarentena que desea liberar. El valor es un identificador de mensaje en cuarentena único en el formato GUID1\GUID2 (por ejemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Puede buscar el valor Identity para un mensaje en cuarentena con el cmdlet Get-QuarantineMessage.

Type:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReleaseToAll

El modificador ReleaseToAll libera el mensaje en cuarentena a todos los destinatarios originales. No es necesario especificar un valor con este modificador.

Este modificador es necesario para el tipo de cuarentena SPOMalware.

Si anteriormente usó el parámetro User o el modificador ReleaseToAll para liberar el mensaje en cuarentena para algunos o todos los destinatarios originales, esos destinatarios se omitirán cuando vuelva a usar el modificador ReleaseToAll.

No puede usar el modificador ReleaseToAll y el parámetro User en el mismo comando.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

El modificador ReportFalsePositive especifica si se debe notificar el mensaje como falso positivo a Microsoft (buen mensaje marcado como incorrecto). No es necesario especificar un valor con este modificador.

Este modificador solo está disponible para los mensajes de correo no deseado en cuarentena.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-User

El parámetro User especifica la dirección de correo electrónico del usuario al que desea liberar el mensaje en cuarentena. Puede especificar varias direcciones de correo electrónico separadas por comas.

Puede usar este parámetro para liberar el mensaje a los destinatarios del mensaje original o a cualquier otra dirección de correo electrónico de la organización.

Si anteriormente usó el modificador ReleaseToAll para liberar el mensaje en cuarentena para todos los destinatarios originales y, posteriormente, vuelve a publicar el mensaje con el parámetro User, se omitirán los destinatarios originales que especifique con el parámetro User.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.