Get-QuarantineMessage

Syntaxe

Details

Get-QuarantineMessage
    -Identity <QuarantineMessageIdentity>
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-RecipientAddress <String[]>]
    [-SenderAddress <String[]>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [<CommonParameters>]

Summary

Get-QuarantineMessage

    [-Direction <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageDirectionEnum>]
    [-Domain <String[]>]
    [-EndExpiresDate <System.DateTime>]
    [-EndReceivedDate <System.DateTime>]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-IncludeMessagesFromBlockedSenderAddress]
    [-MessageId <String>]
    [-MyItems]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-PolicyName <String>]
    [-PolicyTypes <QuarantinePolicyTypeEnum[]>]
    [-QuarantineTypes <QuarantineMessageTypeEnum[]>]
    [-RecipientAddress <String[]>]
    [-RecipientTag <String[]>]
    [-ReleaseStatus <ReleaseStatus[]>]
    [-Reported <Boolean>]
    [-SenderAddress <String[]>]
    [-StartExpiresDate <System.DateTime>]
    [-StartReceivedDate <System.DateTime>]
    [-Subject <String>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [-Type <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageTypeEnum>]
    [<CommonParameters>]

Description

Exemples

Exemple 1

Get-QuarantineMessage -StartReceivedDate 06/13/2017 -EndReceivedDate 06/15/2017

Exemple 2

Get-QuarantineMessage -PageSize 50 -Page 3

Exemple 3

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

Exemple 4

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

Exemple 5

Get-QuarantineMessage -QuarantineTypes SPOMalware | Format-List

Paramètres

-Direction

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Direction permet de filtrer les résultats selon les messages qui entrent ou qui sortent. Les valeurs valides sont les suivantes :

• Entrant
• Sortant

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-Domain

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Ce paramètre est réservé à l’usage interne chez Microsoft.

Propriétés du paramètre

Jeux de paramètres

-EndExpiresDate

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre EndExpiresDate spécifie les derniers messages qui sont automatiquement supprimés de la mise en quarantaine. Utilisez ce paramètre avec le paramètre StartExpiresDate.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Par exemple, si vous spécifiez la valeur StartExpiresDate de la date du jour et la valeur EndExpiresDate de la date de trois jours à partir d’aujourd’hui, vous voyez uniquement les messages qui sont définis pour expirer de la quarantaine dans les trois prochains jours.

Propriétés du paramètre

Jeux de paramètres

-EndReceivedDate

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre EndReceivedDate désigne les messages les plus anciens dans les résultats. Utilisez ce paramètre avec le paramètre StartReceivedDate.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Propriétés du paramètre

Jeux de paramètres

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

• E-mail
• SharePointOnline
• Teams (actuellement en préversion)
• DataLossPrevention

Propriétés du paramètre

Jeux de paramètres

-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 à afficher. 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).

Lorsque vous identifiez le message de mise en quarantaine à l’aide de ce paramètre, les propriétés RecipientAddress, QuarantineUser et ReleasedUser sont disponibles. Pour afficher ces valeurs, vous devez utiliser une cmdlet de mise en forme. Par exemple : Get-QuarantineMessage -Identity <Identity> | Format-List.

Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

Propriétés du paramètre

Jeux de paramètres

-IncludeMessagesFromBlockedSenderAddress

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le commutateur IncludeMessagesFromBlockedSenderAddress spécifie s’il faut inclure des messages mis en quarantaine provenant d’expéditeurs bloqués dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Jeux de paramètres

-MessageId

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre MessageId permet de filtrer les résultats en tenant compte de l’en-tête Message-ID dans un message. Cette valeur est également appelée ID client. Le format du paramètre Message-ID est fonction du serveur de messagerie. La valeur doit être unique pour chaque message. Toutefois, les serveurs ne sont pas tous en mesure de créer des valeurs Message-ID identiques. Veillez à inclure la chaîne d’ID de message complète (qui peut inclure des crochets) et à placer la valeur entre guillemets (par exemple, "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>").

Propriétés du paramètre

Jeux de paramètres

-MyItems

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le commutateur MyItems filtre les résultats par messages dans lesquels vous (l’utilisateur qui exécute la commande) êtes le destinataire. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Jeux de paramètres

-Page

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Page indique le numéro de page des résultats que vous voulez afficher. L’entrée valide pour ce paramètre est un entier entre 1 et 1 000. La valeur par défaut est 1.

Propriétés du paramètre

Jeux de paramètres

-PageSize

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PageSize indique le nombre maximal d’entrées par page. L’entrée valide pour ce paramètre est un entier entre 1 et 1 000. La valeur par défaut est 100.

Propriétés du paramètre

Jeux de paramètres

-PolicyName

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PolicyName filtre les résultats en fonction de la stratégie de menace qui a mis en quarantaine le message (par exemple, une stratégie anti-programme malveillant ou une stratégie anti-courrier indésirable). Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

• Nom
• Nom unique (DN)
• GUID

Propriétés du paramètre

Jeux de paramètres

-PolicyTypes

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PolicyTypes filtre les résultats en fonction du type de stratégie de menace qui a mis le message en quarantaine. Les valeurs valides sont les suivantes :

• AntiMalwarePolicy
• AntiPhishPolicy
• DataLossPreventionRule
• ExchangeTransportRule (règle de flux de courrier)
• HostedContentFilterPolicy (stratégie anti-courrier indésirable)
• SafeAttachmentPolicy (Microsoft Defender pour Office 365 uniquement)

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-QuarantineTypes

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre QuarantineTypes filtre les résultats en fonction de ce qui a provoqué la mise en quarantaine du message. Les valeurs valides sont les suivantes :

• Courrier en nombre
• DataLossPrevention
• FileTypeBlock (filtre de pièces jointes courantes dans les stratégies anti-programme malveillant dans les fonctionnalités de sécurité intégrées pour toutes les boîtes aux lettres cloud)
• HighConfPhish
• Programmes malveillants (stratégies anti-programme malveillant dans les fonctionnalités de sécurité intégrées pour toutes les stratégies de boîtes aux lettres cloud ou de pièces jointes sécurisées dans Defender pour Office 365)
• Phish
• Courrier indésirable
• SPOMalware (Microsoft Defender pour Office 365 uniquement)
• Transportrule

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Vous ne devez pas utiliser ce paramètre avec le paramètre Type.

Pour les fichiers mis en quarantaine par pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams, les informations de détection se trouvent dans le champ CustomData dans la sortie.

Propriétés du paramètre

Jeux de paramètres

-RecipientAddress

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre RecipientAddress permet de filtrer les résultats par adresse de messagerie du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-RecipientTag

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre RecipientTag filtre les résultats en fonction de la valeur de balise utilisateur du destinataire (par exemple, Priority Account). Pour plus d’informations sur les balises utilisateur, consultez Balises utilisateur dans Defender pour Office 365.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-ReleaseStatus

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre ReleaseStatus filtre les résultats en fonction du status de publication du message. Les valeurs valides sont les suivantes :

• Approuvé
• Denied
• Error
• NotReleased
• PrepareToRelease
• Date de publication
• Demandé

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Remarque : Les messages mis en quarantaine et publiés par Microsoft en raison d’un problème de service ont la valeur de propriété SystemReleased TRUE. Pour filtrer les résultats en fonction des messages libérés par le système, exécutez la commande suivante : Get-QuarantineMessage | where {$_.systemreleased -like "True"}.

Propriétés du paramètre

Jeux de paramètres

-Reported

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Reported permet de filtrer les résultats par message (lorsqu'ils sont faux positifs). Les valeurs valides sont les suivantes :

• $true : la commande retourne uniquement les messages mis en quarantaine qui ont déjà été signalés comme faux positifs.
• $false : la commande retourne uniquement les messages mis en quarantaine qui n’ont pas été signalés comme faux positifs.

Propriétés du paramètre

Jeux de paramètres

-SenderAddress

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre SenderAddress permet de filtrer les résultats par adresse de messagerie de l’expéditeur. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-StartExpiresDate

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre StartExpiresDate spécifie les messages les plus anciens qui sont automatiquement supprimés de la quarantaine. Utilisez ce paramètre avec le paramètre EndExpiresDate.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Par exemple, si vous spécifiez la valeur StartExpiresDate de la date du jour et la valeur EndExpiresDate de la date de trois jours à partir d’aujourd’hui, vous voyez uniquement les messages qui sont définis pour expirer de la quarantaine dans les trois prochains jours.

Propriétés du paramètre

Jeux de paramètres

-StartReceivedDate

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre StartReceivedDate désigne les messages les plus récents dans les résultats. Utilisez ce paramètre avec le paramètre EndReceivedDate.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Par défaut, si vous n’utilisez pas les paramètres StartReceivedDate et EndReceivedDate, la commande retourne les données des 16 derniers jours. La valeur maximale de ce paramètre est de 30 jours. Si vous utilisez une valeur antérieure à 30 jours, la valeur est ignorée et seules les données des 30 derniers jours sont retournées.

Propriétés du paramètre

Jeux de paramètres

-Subject

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Subject permet de filtrer les résultats en fonction de l'objet du message. Si la valeur contient des espaces, placez-la entre guillemets (").

Propriétés du paramètre

Jeux de paramètres

-TeamsConversationTypes

Applicable : Sécurité & Conformité

Ce paramètre est disponible uniquement dans Security & Compliance PowerShell.

Les paramètres TeamsConversationTypes filtrent les résultats par types de conversation Microsoft Teams. Les valeurs valides sont les suivantes :

• Canal
• Conversation

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Jeux de paramètres

-Type

Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Type permet de filtrer les résultats en tenant compte des causes de la quarantaine. Les valeurs valides sont les suivantes :

• Courrier en nombre
• DataLossPrevention
• HighConfPhish
• Programme malveillant
• Phish
• Courrier indésirable
• SPOMalware (Microsoft Defender pour Office 365 uniquement)
• Transportrule

Vous ne devez pas utiliser ce paramètre avec le paramètre QuarantineTypes.

Pour les fichiers protégés par des pièces jointes fiables pour SharePoint, OneDrive et Microsoft Teams, les informations de détection se trouvent dans le champ CustomData dans la sortie.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

Input types

Sorties

Output types