Partager via

Release-QuarantineMessage

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online, Security & Compliance, Exchange Online Protection

Cette cmdlet est disponible uniquement dans le service cloud.

La cmdlet Release-QuarantineMessage permet de libérer les messages en quarantaine dans votre organisation en nuage. Vous pouvez publier des messages à tous les destinataires d’origine ou à des destinataires spécifiques.

Pour les fichiers mis en quarantaine par les pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams, vous pouvez débloquer les fichiers dans les sites d’équipe et bibliothèques de documents respectifs à l’aide de l’applet de commande Release-QuarantineMessage afin que les utilisateurs puissent accéder aux fichiers, les partager et les télécharger.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

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

Considérez le scénario suivant : john@gmail.com envoie un message à faith@contoso.com et john@subsidiary.contoso.com. Gmail bifurque ce message en deux copies qui sont toutes deux routées vers la mise en quarantaine en tant que hameçonnage dans Microsoft. Un administrateur libère ces deux messages sur admin@contoso.com. Le premier message publié qui atteint la boîte aux lettres d’administration est remis. Le deuxième message libéré est identifié comme une remise en double et est ignoré. Les messages sont identifiés en tant que doublons s’ils ont le même ID de message et la même heure de réception.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

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

Cet exemple utilise l’applet de commande Get-QuarantineMessage pour libérer le message mis en quarantaine avec la valeur <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID sur un destinataire julia@contoso.comd’origine .

Exemple 2

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

Cet exemple libère le message en quarantaine avec la valeur Identity vers tous les destinataires d’origine.

Exemple 3

Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll

Cet exemple montre comment libérer tous les messages pour tous les destinataires d’origine.

Exemple 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

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

Cet exemple montre comment publier un fichier mis en quarantaine dans le cadre des pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams. La première commande stocke tous les fichiers mis en quarantaine dans la variable $q. La deuxième commande libère le dernier fichier de la liste. Pour plus d’informations sur les éléments dans les tableaux et les numéros d’index, consultez Accès et utilisation d’éléments de tableau.

Paramètres

-ActionType

Le paramètre ActionType spécifie le type d’action de mise en production. Les valeurs valides sont les suivantes :

  • Approuver
  • Refuser
  • Version
  • Demande
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

Le commutateur AllowSender spécifie que tous les futurs messages de l’expéditeur ne sont pas mis en quarantaine. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si le message a été mis en quarantaine en raison d’une règle de transport ou d’un expéditeur bloqué, les messages de cet expéditeur peuvent toujours être bloqués à l’avenir.

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

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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

Le paramètre EntityType filtre les résultats par EntityType. Les valeurs valides sont les suivantes :

  • E-mail
  • SharePointOnline
  • Teams (actuellement en préversion)
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

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Utilisez ce commutateur chaque fois que vous tentez de re-libérer des messages précédemment libérés de la quarantaine.

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

Le paramètre Identities identifie les messages mis en quarantaine pour les opérations en bloc. Vous identifiez les messages à l’aide de la syntaxe : value1,value2,...valueN. La valeur est un identificateur de message en quarantaine unique au format GUID1\GUID2 (par exemple c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).

Vous pouvez trouver la valeur d’identité d’un message mis en quarantaine à l’aide de l’applet de commande Get-QuarantineMessage.

Lorsque vous utilisez ce paramètre, le paramètre Identity est obligatoire, mais la valeur est ignorée. Par exemple, utilisez la valeur 000 pour le paramètre 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

Le paramètre Identity spécifie le message en quarantaine à libérer. La valeur est un identificateur de message en quarantaine unique au format GUID1\GUID2 (par exemple c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).

Vous pouvez trouver la valeur Identity pour un message en quarantaine à l’aide de la 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

Le commutateur ReleaseToAll libère le message en quarantaine vers tous les destinataires d’origine. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur est requis pour le type de quarantaine SPOMalware.

Si vous avez précédemment utilisé le paramètre User ou le commutateur ReleaseToAll pour libérer le message mis en quarantaine sur une partie ou la totalité des destinataires d’origine, ces destinataires sont ignorés lorsque vous utilisez à nouveau le commutateur ReleaseToAll.

Vous ne pouvez pas utiliser le commutateur ReleaseToAll et le paramètre User dans la même commande.

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

Le commutateur ReportFalsePositive spécifie s’il faut signaler le message en tant que faux positif à Microsoft (bon message marqué comme mauvais). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur est disponible uniquement pour les courriers indésirables mis en quarantaine.

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

Le paramètre User spécifie l’adresse de messagerie électronique de l’utilisateur pour qui libérer le message en quarantaine. Vous pouvez spécifier plusieurs adresses e-mail séparées par des virgules.

Vous pouvez utiliser ce paramètre pour libérer le message aux destinataires du message d’origine ou à toute autre adresse e-mail dans le organization.

Si vous avez déjà utilisé le commutateur ReleaseToAll pour libérer le message en quarantaine vers tous les destinataires d’origine, et que vous libérez de nouveau le message ultérieurement à l’aide du paramètre User, tous les destinataires d’origine spécifiés avec le paramètre User sont ignorés.

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

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le commutateur WhatIf ne fonctionne pas dans PowerShell conformité de la sécurité & .

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

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.