Get-SafeLinksAggregateReport

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Get-SafeLinksAggregateReport pour retourner des informations générales sur les résultats des liens fiables pour les 90 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-SafeLinksAggregateReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-StartDate <System.DateTime>]
   [-SummarizeBy <String>]
   [<CommonParameters>]

Description

Remarque : Si vous exécutez Get-SafeLinksAggregateReport 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.

Pour la période de rapport spécifiée, la cmdlet renvoie les informations suivantes :

  • Action
  • Application
  • MessageCount
  • RecipientCount

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-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

Cet exemple retourne des résultats résumés par Email résultats client et Teams pour la plage de dates spécifiée.

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.

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

-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 à 90 jours.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 à 90 jours.

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

-SummarizeBy

Le paramètre SummarizeBy renvoie des totaux basés sur les valeurs que vous spécifiez. Si votre rapport filtre des données à l’aide d’une des valeurs acceptées par ce paramètre, vous pouvez utiliser le paramètre SummarizeBy pour récapituler les résultats en fonction de ces valeurs. Pour réduire le nombre de lignes renvoyées dans ce rapport, utilisez le paramètre SummarizeBy. La récapitulation réduit le nombre de données extraites pour le rapport, et permet de le livrer plus rapidement. Par exemple, au lieu de voir chaque instance d’une valeur spécifique de Action ou AppNameList sur une ligne individuelle du rapport, vous pouvez utiliser le paramètre SummarizeBy pour voir le nombre total d’instances de cette action ou application spécifique sur une ligne du rapport.

Pour cette applet de commande, les valeurs valides sont les suivantes :

  • Action : seules les valeurs spécifiées par le paramètre Action sont retournées.
  • Application : seules les valeurs spécifiées par le paramètre AppNameList sont retournées.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online