Compartir a través de

Export-QuarantineMessage

Módulo:
Exchange PowerShell

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 .eml archivos de mensajes 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.

Sintaxis

Identities 

Export-QuarantineMessage
    -Identities <QuarantineMessageIdentity[]>
    [-Identity <QuarantineMessageIdentity>]
    [-CompressOutput]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-ForceConversionToMime]
    [-Password <SecureString>]
    [-PasswordV2 <String>]
    [-ReasonForExport <String>]
    [-RecipientAddress <String>]
    [<CommonParameters>]

IdentityOnly 

Export-QuarantineMessage
    -Identity <QuarantineMessageIdentity>
    [-CompressOutput]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-ForceConversionToMime]
    [-Password <SecureString>]
    [-PasswordV2 <String>]
    [-ReasonForExport <String>]
    [-RecipientAddress <String>]
    [<CommonParameters>]

Description

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 se le asignan. 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

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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 de .eml que recibe el nombre del segundo valor GUID de la identidad.

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

-EntityType

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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

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

Propiedades de parámetro

Tipo:Microsoft.Exchange.Management.FfoQuarantine.EntityType
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

-ForceConversionToMime

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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.

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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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.

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

-Identity

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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.

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:False
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:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Password

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

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.

Para escribir la contraseña en texto sin formato, use el parámetro PasswordV2.

Propiedades de parámetro

Tipo:SecureString
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

-PasswordV2

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El parámetro PasswordV2 especifica el valor de texto sin formato de la contraseña necesaria para abrir el mensaje exportado. Incluya el valor entre comillas (por ejemplo, '<password>').

Propiedades de parámetro

Tipo:String
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

-ReasonForExport

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El parámetro ReasonForExport especifica por qué se exportó el mensaje. Si el valor contiene espacios, escriba el valor entre comillas (").

Propiedades de parámetro

Tipo:String
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

-RecipientAddress

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El parámetro RecipientAddress filtra los resultados por la dirección de correo electrónico del destinatario. Puede especificar distintos valores separados por comas.

Propiedades de parámetro

Tipo:

String[]

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

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.