Partager via


Get-SafeLinksDetailReport

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Get-SafeLinksDetailReport pour retourner des informations détaillées sur les résultats des liens fiables pour les 7 derniers jours. Hier est la date la plus récente que vous pouvez spécifier.

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

Syntax

Get-SafeLinksDetailReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-Domain <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-RecipientAddress <MultiValuedProperty>]
   [-StartDate <System.DateTime>]
   [<CommonParameters>]

Description

Remarque : Si vous exécutez Get-SafeLinksDetailReport sans spécifier de plage de dates, la commande retourne une erreur non spécifiée.

Les liens fiables sont une fonctionnalité de Microsoft Defender pour Office 365 qui vérifie les liens dans les messages électroniques pour voir s’ils mènent à des sites web malveillants. Lorsqu’un utilisateur clique sur un lien dans un message, l’URL est temporairement réécrite et vérifiée par rapport à une liste de sites web malveillants connus.

Cette applet de commande retourne les informations suivantes :

  • ClickTime
  • NetworkMessageId
  • ClientMessageId
  • SenderAddress
  • RecipientAddress
  • Url
  • UrlDomain
  • Action
  • AppName
  • SourceId
  • Organisation
  • DetectedBy (liens fiables dans Microsoft Defender pour Office 365)
  • UrlType (actuellement vide)
  • Indicateurs (0 : Autorisé 1 : Bloqué 2 : ClickedEvenBlocked 3 : ClickedDuringScan)

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-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com

Cet exemple retourne un filtre des résultats en fonction des informations suivantes :

  • Plage de dates : 7 juin 2020 au 10 juin 2020
  • Action : autorisé et bloqué
  • AppNameList : Email Client et Teams
  • Domaine d’URL : google.com et teams.com
  • Adresse e-mail du destinataire : faith@contoso.com et chris@contoso.com

Paramètres

-Action

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

  • Autorisé
  • Blocked
  • ClickedDuringScan
  • ClickedEvenBlocked
  • Analyse
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

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

Notez que les valeurs de ce paramètre respectent la casse.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AppNameList

Le paramètre AppNameList filtre les résultats en fonction de l’application où le lien a été trouvé. Les valeurs valides sont les suivantes :

  • client Email
  • OfficeDocs
  • Teams

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Domain

Le paramètre Domain filtre les résultats en fonction du domaine dans l’URL.

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-EndDate

Le paramètre EndDate indique la fin de la plage de dates définies.

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 jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018.

Hier est la date la plus récente que vous pouvez spécifier. Vous ne pouvez pas spécifier une date antérieure à 7 jours.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Page

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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PageSize

Le paramètre PageSize indique le nombre maximal d’entrées par page. La valeur valide pour ce paramètre est un entier compris entre 1 et 5 000. Par défaut, la valeur 1 000 s’applique.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecipientAddress

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.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

Le paramètre StartDate indique le début de la plage de dates définies.

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 jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018.

Hier est la date la plus récente que vous pouvez spécifier. Vous ne pouvez pas spécifier une date antérieure à 7 jours.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online