Partager via

Get-AadrmTrackingLog

  • Référence
Module:
AADRM

Obtient des informations de suivi pour les documents protégés.

Syntaxe

Get-AadrmTrackingLog
   -UserEmail <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]

Description

Notes

Cette applet de commande du module AADRM est désormais déconseillée. Après le 15 juillet 2020, ce nom d’applet de commande ne sera pris en charge qu’en tant qu’alias pour son remplacement dans le module AIPService.

Pour plus d’informations, consultez la page de présentation.

L’applet de commande Get-AadrmTrackingLog retourne des informations de suivi sur les documents protégés pour un utilisateur spécifié qui a protégé des documents (l’émetteur Rights Management) ou qui a accédé à des documents protégés. Cette applet de commande permet de répondre à la question « Quels documents protégés ont-ils suivi ou accès à un utilisateur spécifié ? » Les informations retournées incluent :

  • ID de contenu du document, avec le nom du document s’il est disponible.
  • Émetteur Rights Management.
  • Les utilisateurs qui ont accédé au document, quand et à partir de quel emplacement.
  • Quel ID de modèle de protection ou droits d’utilisation spécifiques ont été utilisés pour protéger le document et si l’accès a été accordé ou refusé.

Vous pouvez spécifier une heure de début et une heure de fin des entrées à inclure. La sortie est retournée sous la forme d’une liste d’objets PowerShell dans la console PowerShell.

Vous pouvez également utiliser le site de suivi des documents pour obtenir les informations de protection sur les documents suivis. Pour plus d’informations, consultez la section Suivi et révocation de documents pour les utilisateurs dans le guide d’administration.

Exemples

Exemple 1 : Obtenir toutes les informations de suivi pour un utilisateur

PS C:\>Get-AadrmTrackingLog -UserEmail "test@contoso.com"

Cette commande génère un journal de toutes les informations de suivi pour les documents protégés ou accessibles par l’utilisateur avec l’adresse e-mail «test@contoso.com ».

Exemple 2 : Obtenir des informations de suivi pour un utilisateur, pendant une période spécifique

PS C:\>Get-AadrmTrackingLog -UserEmail "test@contoso.com" -FromTime "01/01/2018 00:00:00" -ToTime "01/31/2018 23:59:59"

Cette commande est identique à l’exemple précédent, sauf que les résultats sont limités aux documents qui ont été suivis dans une période spécifique à l’aide des paramètres FromTime et ToTime . Dans cet exemple, la période est toutes les jours en janvier 2018, à l’aide du format de date américain.

Exemple 3 : Obtenir toutes les informations de suivi pour un utilisateur et enregistrer les résultats dans un fichier .csv

PS C:\>$trackingLogs = Get-AadrmTrackingLog -UserEmail "test@contoso.com"
PS C:\>$trackingLogs | Export-Csv 'C:\Temp\TrackingLog.csv' -NoTypeInformation

La première commande génère un journal de toutes les informations de suivi pour les documents protégés ou accessibles par l’utilisateur avec l’adresse e-mail «test@contoso.com » et enregistre le résultat dans une variable.

La deuxième commande utilise ensuite l’applet de commande Export-Csv pour convertir les informations de suivi au format .csv et l’enregistre dans le fichier C:\Temp\TrackingLog.csv.

Paramètres

-FromTime

Spécifie l’heure de début (inclusive) du fichier journal en tant qu’objet DateTime . Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date . Spécifiez la date et l’heure en fonction des paramètres régionaux système. Pour plus d'informations, voir Get-Help Get-Date.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ToTime

Spécifie l’heure d’arrêt (inclusive) du fichier journal en tant qu’objet DateTime . Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date . Spécifiez la date et l’heure en fonction des paramètres régionaux système. Pour plus d'informations, voir Get-Help Get-Date.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserEmail

Spécifie l’adresse e-mail de l’utilisateur. L’applet de commande obtient les informations de suivi pour les documents protégés ou accessibles par l’utilisateur disposant de cette adresse e-mail.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False