Export-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.

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.eml valor) como Base64 (en función del $e.BodyEncoding valor).
  • 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.eml valor) como Base64 (en función del $f.BodyEncoding valor).
  • 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).password para 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