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 différentes utilisations, comme décrit ci-dessous.

Syntax

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.
  • 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é.
  • Propriété IsHiddenInfo , qui sera toujours false. Cette propriété est utilisée pour masquer les événements pour les utilisateurs où le suivi est désactivé.

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.

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 renvoyer des informations de suivi pour un document spécifique, avec une valeur contentID de c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentId

Spécifie la valeur contentID du document pour lequel vous souhaitez retourner des 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
Aliases:cf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 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 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 suivi pour les documents protégés ou accessibles par l’utilisateur disposant de cette adresse e-mail.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False