Get-AadrmDocumentLog

  • Référence
Module:
AADRM

Obtient des informations de protection sur les documents suivis.

Syntax

Get-AadrmDocumentLog
   -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-AadrmDocumentLog retourne des informations de protection sur les documents suivis pour un utilisateur spécifié si cet utilisateur a protégé des documents (l’émetteur Rights Management) ou a été propriétaire de Rights Management pour les documents, ou les documents protégés ont été configurés pour accorder l’accès directement à l’utilisateur. Cette applet de commande permet de répondre à la question « Comment les documents sont-ils protégés pour un utilisateur spécifié ? » Les informations retournées incluent :

  • ID de contenu du document, avec le nom du document s’il est disponible.
  • Propriétaire rights Management et émetteur Rights Management.
  • Utilisateurs et groupes auxquels l’accès a été accordé.
  • ID du modèle de protection ou droits d’utilisation spécifiques qui protègent le document.
  • Tout paramètre d’expiration, d’accès hors connexion ou de révocation.

Plus d’informations sur le propriétaire Rights Management et l’émetteur Rights Management.

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 du client Azure Information Protection.

Exemples

Exemple 1 : Obtenir des informations de protection sur tous les documents suivis pour un utilisateur

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

Cette commande obtient des informations de protection sur les documents suivis pour un utilisateur qui a l’adresse e-mail «test@contoso.com » et cet utilisateur est l’émetteur Rights Management ou le propriétaire Rights Management pour le document, ou le document a été configuré pour accorder l’accès à cet utilisateur.

Exemple 2 : Obtenir des informations de protection sur les documents suivis pour un utilisateur, pour une période spécifique

PS C:\>Get-AadrmDocumentLog -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 protégés dans un délai spécifique à l’aide des paramètres FromTime et ToTime . Dans cet exemple, la période est tous les jours en janvier 2018, à l’aide du format de date américain.

Exemple 3 : Obtenir des informations de protection sur tous les documents suivis pour un utilisateur et enregistrer les résultats dans un fichier .csv

PS C:\>$documentLogs = Get-AadrmDocumentLog -UserEmail "test@microsoft.com"
PS C:\>$documentLogs | Export-Csv 'C:\Temp\DocumentLog.csv' -NoTypeInformation

La première commande obtient les informations de protection sur les documents suivis pour un utilisateur qui a l’adresse e-mail «test@contoso.com » et cet utilisateur est l’émetteur Rights Management ou le propriétaire Rights Management pour le document, ou le document a été configuré pour accorder l’accès à cet utilisateur. Les informations sont enregistrées dans une variable.

La deuxième commande utilise ensuite l’applet de commande Export-Csv pour convertir les informations de protection au format .csv et les enregistre dans le fichier C:\Temp\DocumentLog.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 de votre système. Pour plus d'informations, voir Get-Help Get-Date.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 de votre système. Pour plus d'informations, voir Get-Help Get-Date.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserEmail

Spécifie l’adresse e-mail de l’utilisateur. L’applet de commande obtient les informations de protection des documents si ces documents protégés par l’utilisateur (l’émetteur Rights Management) ou le propriétaire Rights Management pour les documents ou les documents protégés ont été configurés pour accorder l’accès directement à l’utilisateur. Les adresses de groupe ne sont pas prises en charge avec cette applet de commande.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False