Export-QuarantineMessage
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Export-QuarantineMessage para exportar mensajes y archivos en cuarentena de la organización basada en la nube. Los mensajes se exportan a archivos de mensajes .eml para que pueda abrirlos en Outlook.
En el caso de los archivos en cuarentena por datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams, los archivos se exportan en formato Base64.
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
Export-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>] Export-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>] Description
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
$e = Export-QuarantineMessage -Identity b28e0706-e50e-4c33-17e8-08daf2898d15\e939baaf-9dac-6126-2137-b82abf373159
$txt = [System.Text.Encoding]::Ascii.GetString([System.Convert]::FromBase64String($e.eml))
[IO.File]::WriteAllText("C:\My Documents\Quarantined Message.eml", $txt)En este ejemplo se exporta el mensaje especificado que se puso en cuarentena como correo no deseado:
- El primer comando exporta el mensaje en cuarentena a la variable
$e. El mensaje se almacena en la propiedad Eml (el$e.emlvalor) como Base64 (en función del$e.BodyEncodingvalor). - El segundo comando convierte la propiedad Eml de Base64 en texto ASCII y almacena el resultado en la variable
$txt. - El tercer comando escribe el mensaje en cuarentena en el archivo .eml especificado.
Nota: No incluya el valor identity entre comillas (puede que se produzca un error).
Ejemplo 2
$f = Export-QuarantineMessage -Identity 9c6bb3e8-db9e-4823-9759-08d594179bd3\7fec89fe-41b0-ae67-4887-5bede017d111
$bytes = [Convert]::FromBase64String($f.eml)
[IO.File]::WriteAllBytes("C:\My Documents\Quarantined Message with Attachments.eml", $bytes)En este ejemplo se exporta el mensaje especificado con datos adjuntos que se pusieron en cuarentena como malware:
- El primer comando exporta el mensaje en cuarentena y los datos adjuntos a la variable
$f. El mensaje y los datos adjuntos se almacenan en la propiedad Eml (el$f.emlvalor) como Base64 (en función del$f.BodyEncodingvalor). - El segundo comando convierte la propiedad Eml de Base64 en bytes y almacena el resultado en la variable
$bytes. - El tercer comando escribe el mensaje en cuarentena y los datos adjuntos en el archivo .eml especificado.
Parámetros
-CompressOutput
El modificador CompressOutput exporta el mensaje como un archivo .zip comprimido. No es necesario especificar un valor con este modificador.
En el caso de los mensajes exportados, incluidos los mensajes con datos adjuntos, el archivo de .zip contiene una carpeta que recibe el nombre del primer valor GUID de la identidad. La carpeta contiene el mensaje .eml que recibe el nombre del segundo valor GUID de identity.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
-ForceConversionToMime
El modificador ForceConversionToMime convierte los mensajes de texto sin formato exportados en formato MIME. No es necesario especificar un valor con este modificador.
Este modificador no tiene ningún efecto si el mensaje ya está codificado como Base64.
| 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. Cada 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.
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 exportar. 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 |
-Password
El parámetro Password especifica la contraseña necesaria para abrir el mensaje exportado.
Puede usar los métodos siguientes como valor para este parámetro:
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force).- Antes de ejecutar este comando, almacene la contraseña como variable (por ejemplo, ) y, a continuación,
$password = Read-Host "Enter password" -AsSecureStringuse la variable ($password) para el valor. (Get-Credential).passwordpara que se le pida que escriba la contraseña de forma segura al ejecutar este comando.
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ReasonForExport
El parámetro ReasonForExport especifica por qué se exportó el mensaje. Si el valor contiene espacios, escriba el valor entre comillas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-RecipientAddress
El parámetro RecipientAddress filtra los resultados por la dirección de correo electrónico del destinatario. Puede especificar distintos valores separados por comas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |