Export-QuarantineMessage
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Export-QuarantineMessage para exportar ficheiros e mensagens em quarentena da sua organização com base na cloud. As mensagens são exportadas para .eml ficheiros de mensagens para que possa abri-las no Outlook.
Para ficheiros que foram colocados em quarentena por Anexos Seguros para SharePoint, OneDrive e Microsoft Teams, os ficheiros 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 escreve a mensagem em quarentena no ficheiro de .eml especificado.
Nota: não coloque o valor de Identidade entre aspas (poderá obter 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 software maligno:
- 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 escreve a mensagem em quarentena e anexos no ficheiro de .eml especificado.
Parâmetros
-CompressOutput
Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O comutador CompressOutput exporta a mensagem como um ficheiro de .zip comprimido. Não é preciso especificar um valor com essa opção.
Para mensagens exportadas, incluindo mensagens com anexos, o ficheiro .zip contém uma pasta com o nome do primeiro valor GUID na Identidade. A pasta contém o .eml mensagem com 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro EntityType filtra os resultados por EntityType. Os valores válidos são:
- SharePointOnline
- Teams (atualmente em Pré-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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O comutador ForceConversionToMime converte as mensagens de texto simples exportadas para a formatação MIME. Não é preciso especificar um valor com essa opção.
Este comutador não tem 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Identities identifica as mensagens em quarentena para operações em massa. Pode identificar as mensagens com 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 utiliza este parâmetro, o parâmetro Identidade é necessário, mas o valor é ignorado. Por exemplo, utilize 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Identity especifica a mensagem em quarentena que pretende 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Palavra-passe especifica a palavra-passe necessária para abrir a mensagem exportada.
Pode utilizar os seguintes métodos como um valor para este parâmetro:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Antes de executar este comando, armazene a palavra-passe como uma variável (por exemplo, ) e, em seguida,
$password = Read-Host "Enter password" -AsSecureStringutilize a variável ($password) para o valor. -
(Get-Credential).passworda ser pedido para introduzir a palavra-passe de forma segura quando executar este comando.
Para introduzir a palavra-passe em texto simples, utilize 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PasswordV2 especifica o valor de texto simples da palavra-passe necessária para abrir a mensagem exportada. Coloque 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ReasonForExport especifica o motivo pelo qual 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.