Export-QuarantineMessage
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Export-QuarantineMessage para exportar mensagens e arquivos em quarentena de sua organização baseada em nuvem. As mensagens são exportadas para .eml arquivos de mensagens para que você possa abri-los no Outlook.
Para arquivos que foram colocados em quarentena por anexos seguros para SharePoint, OneDrive e Microsoft Teams, os arquivos são exportados no formato Base64.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
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
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 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)
Este exemplo exporta a mensagem especificada que foi colocada em quarentena como spam:
- O primeiro comando exporta a mensagem em quarentena para a variável
$e. A mensagem é armazenada na propriedade Eml (o$e.emlvalor) como Base64 (com base no$e.BodyEncodingvalor). - O segundo comando converte a propriedade Eml de Base64 em texto ASCII e armazena o resultado na variável
$txt. - O terceiro comando grava a mensagem em quarentena no arquivo .eml especificado.
Observação: não coloque o valor Identidade entre aspas (você pode receber um erro).
Exemplo 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)
Este exemplo exporta a mensagem especificada com anexos que foram colocados em quarentena como malware:
- O primeiro comando exporta a mensagem em quarentena e os anexos para a variável
$f. A mensagem e os anexos são armazenados na propriedade Eml (o$f.emlvalor) como Base64 (com base no$f.BodyEncodingvalor). - O segundo comando converte a propriedade Eml de Base64 em bytes e armazena o resultado na variável
$bytes. - O terceiro comando grava a mensagem em quarentena e os anexos no arquivo .eml especificado.
Parâmetros
-CompressOutput
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção CompressOutput exporta a mensagem como um arquivo .zip compactado. Não é preciso especificar um valor com essa opção.
Para mensagens exportadas, incluindo mensagens com anexos, o arquivo .zip contém uma pasta com o nome do primeiro valor GUID na Identidade. A pasta contém a mensagem .eml que recebeu o nome do segundo valor GUID na identidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EntityType
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro EntityType filtra os resultados por EntityType. Os valores válidos são:
- SharePointOnline
- Teams (atualmente em visualização)
- DataLossPrevention
Propriedades do parâmetro
| Tipo: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceConversionToMime
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O comutador ForceConversionToMime converte mensagens de texto sem formatação exportadas para formatação MIME. Não é preciso especificar um valor com essa opção.
Esta opção não terá efeito se a mensagem já estiver codificada como Base64.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identities
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Identities identifica mensagens em quarentena para operações em massa. Você identifica as mensagens usando a sintaxe: value1,value2...valueN. Cada valor é um identificador de mensagem em quarentena exclusivo no formato GUID1\GUID2 (por exemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).
Para encontrar o valor Identity de uma mensagem em quarentena, use o cmdlet Get-QuarantineMessage.
Quando você usa esse parâmetro, o parâmetro Identity é necessário, mas o valor é ignorado. Por exemplo, use o valor 000 para o parâmetro Identity.
Propriedades do parâmetro
| Tipo: | QuarantineMessageIdentity[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identities
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Identity especifica a mensagem em quarentena que você deseja exportar. O valor é um identificador de mensagem em quarentena exclusivo no formato GUID1\GUID2 (por exemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).
Para encontrar o valor Identity de uma mensagem em quarentena, use o cmdlet Get-QuarantineMessage.
Propriedades do parâmetro
| Tipo: | QuarantineMessageIdentity |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identities
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
IdentityOnly
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Password
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Password especifica a senha necessária para abrir a mensagem exportada.
Você pode usar os seguintes métodos como um valor para esse parâmetro:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Antes de executar esse comando, armazene a senha como uma variável (por exemplo,
$password = Read-Host "Enter password" -AsSecureString) e use a variável ($password) para o valor. -
(Get-Credential).passwordserá solicitado a inserir a senha com segurança ao executar esse comando.
Para inserir a senha em texto sem formatação, use o parâmetro PasswordV2.
Propriedades do parâmetro
| Tipo: | SecureString |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PasswordV2
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro PasswordV2 especifica o valor de texto sem formatação da senha que é necessário para abrir a mensagem exportada. Delimite o valor entre aspas (por exemplo, '<password>').
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReasonForExport
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro ReasonForExport especifica por que a mensagem foi exportada. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientAddress
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro RecipientAddress filtra os resultados pelo endereço de email do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.