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. Você pode liberar mensagens para todos os destinatários originais ou para destinatários específicos.

Para arquivos que foram colocados em quarentena por Anexos Seguros para SharePoint, OneDrive e Microsoft Teams, você pode desbloquear os arquivos nos respectivos sites de equipe e bibliotecas de documentos usando o cmdlet Release-QuarantineMessage para que os usuários possam acessar, compartilhar e baixar os arquivos.

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

Syntax

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 essa mensagem em duas cópias que são roteadas para quarentena como phishing na Microsoft. Um administrador libera ambas as mensagens para admin@contoso.com. A primeira mensagem lançada que atinge a caixa de correio do administrador é entregue. A segunda mensagem liberada é identificada como entrega duplicada e é ignorada. A mensagem será identificada como duplicatas se elas tiverem a mesma ID da mensagem e receberem 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 usa o cmdlet Get-QuarantineMessage para liberar a mensagem em quarentena com o valor <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> ID de mensagem 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 libera todas as mensagens para todos os destinatários originais.

Exemplo 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

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

Este exemplo libera um arquivo que foi colocado em quarentena como parte de Anexos Seguros para SharePoint, OneDrive e Microsoft Teams. O primeiro comando armazena todos os arquivos em quarentena na variável $q. O segundo comando libera o último arquivo na lista. Para obter mais informações sobre elementos em matrizes e números de índice, consulte Acessando e usando 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:

Aprovar
Negar
Lançar
Solicitação

Type:	ReleaseActionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 é necessário 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.

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

-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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, cmdlets 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Versão Prévia)

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

-Force

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

Use essa opção sempre que tentar relançar mensagens liberadas anteriormente da quarentena.

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

O parâmetro Identidades identifica mensagens em quarentena para operações em massa. Você identifica as mensagens usando 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).

Você pode encontrar o valor de identidade de uma mensagem em quarentena usando 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.

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

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.

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

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

Essa opção é necessária para o tipo de quarentena SPOMalware.

Se você usou anteriormente o parâmetro User ou a opção ReleaseToAll para liberar a mensagem em quarentena para alguns ou todos os destinatários originais, esses destinatários serão ignorados quando você usar a opção ReleaseToAll novamente.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

A opção ReportFalsePositive especifica se deve relatar a mensagem como um falso positivo para a Microsoft (boa mensagem marcada como ruim). Não é preciso especificar um valor com essa opção.

Essa opção está disponível apenas para mensagens de spam em quarentena.

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

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

Você pode usar esse parâmetro para liberar a mensagem para os destinatários da mensagem original ou para quaisquer outros endereços de email 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.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Conformidade de Segurança & .

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Compartilhar via