Partager via


Get-AipServiceTrackingLog

Obtient des informations de suivi pour les documents protégés par Azure Information Protection.

Cette applet de commande est prise en charge par les clients d’étiquetage classiques et unifiés Azure Information Protection, avec une utilisation différente, comme décrit ci-dessous.

Syntaxe

Get-AipServiceTrackingLog
   -ContentId <Guid>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Get-AipServiceTrackingLog exécute une requête pour renvoyer des informations de protection sur les documents suivis.

Les informations retournées incluent :

  • ID de contenu du document, avec le nom du document s’il est disponible.
  • Émetteur Rights Management.
  • Utilisateurs qui ont accédé au document, quand et à 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é.
  • La propriété IsHiddenInfo, qui sera toujours false. Cette propriété est utilisée pour masquer les événements pour les utilisateurs sur lesquels le suivi est désactivé.

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

L’applet de commande Get-AipServiceTracking retourne des informations de suivi sur un document protégé avec un contentID spécifié.

Pour récupérer l’ID de contenu d’un document spécifique, utilisez l’applet de commande Get-AipServiceDocumentLog .

Exemples

Exemple 1 : Obtenir des données de suivi pour un document spécifique, à l’aide de son contentId

PS C:\>Get-AipServiceDocumentLog -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

Cette commande exécute une requête pour retourner des informations de suivi pour un document spécifique, avec une valeur contentID de c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-ContentId

Spécifie la valeur contentID du document pour lequel vous souhaitez retourner les données de suivi.

Pour récupérer l’ID de contenu d’un document spécifique, utilisez l’applet de commande Get-AipServiceDocumentLog .

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

-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, tapez 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 de votre système. Pour plus d’informations, tapez 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 des 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:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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