Release-QuarantineMessage
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.
Syntaxe
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre ActionType spécifie le type d’action de mise en production. Les valeurs valides sont les suivantes :
- Refuser
- Version : utilisez cette valeur pour libérer des messages ou approuver les demandes de publication de messages.
- Demande
Propriétés du paramètre
| Type: | ReleaseActionType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllowSender
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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-*) comportent 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EntityType
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre EntityType filtre les résultats par EntityType. Les valeurs valides sont les suivantes :
- SharePointOnline
- Teams (actuellement en préversion)
- DataLossPrevention
Propriétés du paramètre
| Type: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identities
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | QuarantineMessageIdentity[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identities
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
OrgReleaseToAll
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
OrgReleaseToUser
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | QuarantineMessageIdentity |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identities
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
OrgReleaseToAll
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
OrgReleaseToUser
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
IdentityOnly
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ReleaseToAll
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
OrgReleaseToAll
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReportFalsePositive
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-User
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
OrgReleaseToUser
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 le Centre de sécurité et de conformité PowerShell.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.