Delete-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 Delete-QuarantineMessage para excluir mensagens de quarentena de sua organização baseada em nuvem

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

Syntax

Delete-QuarantineMessage
      -Identities <QuarantineMessageIdentity[]>
      [-Identity <QuarantineMessageIdentity>]
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]
Delete-QuarantineMessage
      -Identity <QuarantineMessageIdentity>
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]

Description

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

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

Este exemplo exclui a mensagem em quarentena com o valor de Identidade especificado.

Exemplo 2

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identity $ids[4]

Este exemplo exclui a 5ª mensagem em quarentena na lista de resultados do Get-QuarantineMessage. A primeira mensagem tem o índice número 0, a segunda tem o índice número 1 e assim por diante.

Exemplo 3

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identities $ids -Identity 000

Este exemplo exclui todas as mensagens em quarentena. O parâmetro Identity é necessário, mas o valor 000 é ignorado.

Parâmetros

-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

-HardDelete

A opção HardDelete especifica que a mensagem é excluída permanentemente e não é recuperável. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, a mensagem será excluída, mas potencialmente recuperável.

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

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 excluir. 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, Exchange Online Protection

-RecipientAddress

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.

Type:String[]
Position:Named
Default value:None
Required:False
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