Release-QuarantineMessage
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 a todos los destinatarios originales o a destinatarios específicos.
Para los archivos que se pusieron en cuarentena mediante datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams, puede desbloquear los archivos en los respectivos sitios de grupo y bibliotecas de documentos mediante el Release-QuarantineMessage cmdlet para que los usuarios puedan acceder, compartir y descargar los archivos.
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
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Description
Imagine la siguiente situación: 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 cuarentena como suplantación de identidad (phishing) en Microsoft. Un administrador envía ambos mensajes a admin@contoso.com. Se entrega el primer mensaje liberado que llega al buzón de administrador. El segundo mensaje publicado se identifica como entrega duplicada y se omite. Los mensajes se identifican como duplicados si tienen el mismo Id. de mensaje y hora de recepción.
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
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> Id. de mensaje a 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 para 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, consulte Acceso y uso de elementos de matriz.
Parámetros
-ActionType
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El parámetro ActionType especifica el tipo de acción de versión. Los valores admitidos son:
- Denegar
- Lanzamiento: use este valor para liberar mensajes o aprobar solicitudes para liberar mensajes.
- Solicitud
Propiedades de parámetro
| Tipo: | ReleaseActionType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AllowSender
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El modificador AllowSender especifica que todos los mensajes futuros del remitente no se ponen en cuarentena. No es necesario especificar un valor con este modificador.
Si el mensaje se puso en cuarentena debido a una regla de transporte o al remitente bloqueado, los mensajes del remitente aún podrán bloquearse en el futuro.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los 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 otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
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 liberar mensajes publicados anteriormente de la cuarentena.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identities
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El parámetro Identities identifica los mensajes en cuarentena para las operaciones masivas. Los mensajes se identifican con la sintaxis: value1,value2,...valueN. El valor es un identificador de mensaje en cuarentena único con 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 con el cmdlet Get-QuarantineMessage.
Cuando usa este parámetro, el parámetro Identity es obligatorio, pero se omite el valor. Por ejemplo, use el valor 000 para el parámetro Identity.
Propiedades de parámetro
| Tipo: | QuarantineMessageIdentity[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identities
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
OrgReleaseToAll
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
OrgReleaseToUser
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El parámetro Identity especifica el mensaje en cuarentena que desea liberar. El valor es un identificador de mensaje en cuarentena único con 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.
Propiedades de parámetro
| Tipo: | QuarantineMessageIdentity |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identities
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
OrgReleaseToAll
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
OrgReleaseToUser
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
IdentityOnly
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-ReleaseToAll
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El modificador ReleaseToAll libera el mensaje en cuarentena para todos los destinatarios originales. No es necesario especificar un valor con este modificador.
Este modificador es necesario para el SPOMalware de tipo de cuarentena.
Si anteriormente usó el parámetro User o el modificador ReleaseToAll para liberar el mensaje en cuarentena a algunos o todos los destinatarios originales, esos destinatarios se omiten cuando vuelve a usar el modificador LiberToAll.
No puede utilizar el modificador ReleaseToAll y el parámetro User en el mismo comando.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OrgReleaseToAll
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReportFalsePositive
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El modificador ReportFalsePositive especifica si se debe notificar el mensaje como falso positivo a Microsoft (mensaje correcto 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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-User
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
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 utilizó el modificador ReleaseToAll para liberar el mensaje en cuarentena a todos los destinatarios originales y posteriormente vuelve a liberar el mensaje con el parámetro User, se omitirán los destinatarios originales que especifique con el parámetro User.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OrgReleaseToUser
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
El modificador WhatIf no funciona en Security & Compliance PowerShell.
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| 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.
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.