Delete-QuarantineMessage

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Online, Security & Compliance, Exchange Online Protection

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Delete-QuarantineMessage para eliminar mensajes de cuarentena de la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

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

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se elimina el mensaje en cuarentena con el valor de identidad especificado.

Ejemplo 2

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identity $ids[4]

En este ejemplo se elimina el quinto mensaje en cuarentena de la lista de resultados de Get-QuarantineMessage. El primer mensaje tiene el número de índice 0, el segundo tiene el número de índice 1, etc.

Ejemplo 3

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identities $ids -Identity 000

En este ejemplo se eliminan todos los mensajes en cuarentena. Se requiere el parámetro Identity, pero se omite el valor 000.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el 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

El parámetro EntityType filtra los resultados por EntityType. Los valores admitidos son:

  • Correo electrónico
  • SharePointOnline
  • Teams (actualmente en versión preliminar)
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

El modificador HardDelete especifica que el mensaje se elimina permanentemente y no se puede recuperar. No es necesario especificar un valor con este modificador.

Si no usa este modificador, el mensaje se elimina, pero es potencialmente recuperable.

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

El parámetro Identities identifica los mensajes en cuarentena para las operaciones masivas. Los mensajes se identifican mediante la sintaxis : value1,value2...valueN. Cada valor es un identificador de mensaje en cuarentena único en el formato GUID1\GUID2 (por ejemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Puede buscar el valor Identity para un mensaje en cuarentena con el cmdlet Get-QuarantineMessage.

Cuando se usa este parámetro, se requiere el parámetro Identity, pero se omite el valor. Por ejemplo, use el valor 000 para el 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

El parámetro Identity especifica el mensaje en cuarentena que desea eliminar. El valor es un identificador de mensaje en cuarentena único en el formato GUID1\GUID2 (por ejemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Puede buscar el valor Identity para un mensaje en cuarentena con el 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

El parámetro RecipientAddress filtra los resultados por la dirección de correo electrónico del destinatario. Puede especificar distintos valores separados por comas.

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

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .

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