Partilhar via

Release-QuarantineMessage

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online, Security & Compliance, Exchange Online Protection

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Release-QuarantineMessage para liberar mensagens da quarentena em sua organização baseada em nuvem. Pode libertar mensagens para todos os destinatários originais ou para destinatários específicos.

Para ficheiros que foram colocados em quarentena por Anexos Seguros para SharePoint, OneDrive e Microsoft Teams, pode desbloquear os ficheiros nos respetivos sites de equipa e bibliotecas de documentos através do cmdlet Release-QuarantineMessage para que os utilizadores possam aceder, partilhar e transferir os ficheiros.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Release-QuarantineMessage
       -User <String[]>
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-ReleaseToAll]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       -Identities <QuarantineMessageIdentity[]>
       [-Identity <QuarantineMessageIdentity>]
       [-ActionType <ReleaseActionType>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       -Identity <QuarantineMessageIdentity>
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Description

Considere o seguinte cenário: john@gmail.com envia uma mensagem para faith@contoso.com e john@subsidiary.contoso.com. O Gmail bifurca esta mensagem em duas cópias que são ambas encaminhadas para quarentena como phishing na Microsoft. Um administrador lança ambas as mensagens para admin@contoso.com. A primeira mensagem lançada que chega à caixa de correio de administrador é entregue. A segunda mensagem lançada é identificada como entrega duplicada e é ignorada. As mensagens são identificadas como duplicadas se tiverem o mesmo ID de mensagem e tiverem recebido tempo.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.com

Este exemplo utiliza o cmdlet Get-QuarantineMessage para libertar a mensagem em quarentena com o valor <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID para um destinatário julia@contoso.comoriginal .

Exemplo 2

Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll

Este exemplo libera a mensagem em quarentena com o valor Identity especificado para todos os destinatários originais.

Exemplo 3

Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll

Este exemplo lança todas as mensagens para todos os destinatários originais.

Exemplo 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

$q[-1] | Release-QuarantineMessage -ReleaseToAll

Este exemplo lança um ficheiro que foi colocado em quarentena como parte de Anexos Seguros para SharePoint, OneDrive e Microsoft Teams. O primeiro comando armazena todos os ficheiros em quarentena na variável $q. O segundo comando liberta o último ficheiro na lista. Para obter mais informações sobre elementos em matrizes e números de índice, veja Aceder e Utilizar Elementos de Matriz.

Parâmetros

-ActionType

O parâmetro ActionType especifica o tipo de ação de versão. Os valores válidos são:

  • Negar
  • Versão: utilize este valor para libertar mensagens ou aprovar pedidos para libertar mensagens.
  • Solicitação
Tipo:ReleaseActionType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-AllowSender

A opção AllowSender especifica que todas as mensagens futuras do remetente não entrarão em quarentena. Não é preciso especificar um valor com essa opção.

No entanto, se essa mensagem foi colocada em quarentena devido a uma regra de transporte ou a um remetente bloqueado, o remetente continuará sendo bloqueado para mensagens futuras.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

O parâmetro EntityType filtra os resultados por EntityType. Os valores válidos são:

  • Email
  • SharePointOnline
  • Teams (atualmente em Pré-visualização)
  • DataLossPrevention
Tipo:Microsoft.Exchange.Management.FfoQuarantine.EntityType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Force

O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Utilize este comutador sempre que tentar voltar a lançar mensagens lançadas anteriormente da quarentena.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

O parâmetro Identities identifica as mensagens em quarentena para operações em massa. Pode identificar as mensagens com a sintaxe: value1,value2,...valueN. 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).

Pode encontrar o valor de identidade de uma mensagem em quarentena com 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.

Tipo:QuarantineMessageIdentity[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

O parâmetro Identity especifica a mensagem em quarentena que você deseja liberar. 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.

Tipo:QuarantineMessageIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-ReleaseToAll

A opção ReleaseToAll libera a mensagem em quarentena para todos os destinatários originais. Não é preciso especificar um valor com essa opção.

Este comutador é necessário para o tipo de quarentena SPOMalware.

Se utilizou anteriormente o parâmetro Utilizador ou o comutador ReleaseToAll para libertar a mensagem em quarentena para alguns ou todos os destinatários originais, esses destinatários são ignorados quando utilizar novamente o comutador ReleaseToAll.

Não é possível usar a opção ReleaseToAll e o parâmetro User no mesmo comando.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

O comutador ReportFalsePositive especifica se pretende comunicar a mensagem como um falso positivo para a Microsoft (mensagem boa marcada como incorreta). Não é preciso especificar um valor com essa opção.

Este comutador só está disponível para mensagens de spam em quarentena.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-User

O parâmetro User especifica o endereço de email do usuário para o qual você deseja liberar a mensagem em quarentena. Você pode especificar vários endereços de email separados por vírgulas.

Pode utilizar este parâmetro para libertar a mensagem para os destinatários da mensagem original ou para quaisquer outros endereços de e-mail na organização.

Se anteriormente você tiver usado a opção ReleaseToAll para liberar a mensagem em quarentena para todos os destinatários originais e depois liberou a mensagem novamente com o parâmetro User, qualquer destinatário original especificado com o User será ignorado.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.