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.comCet 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 |