Get-AipServiceDocumentLog

Obtient des informations de protection sur les documents suivis 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.

Syntaxe

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Get-AIPServiceDocumentLog 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.
  • Propriétaire de 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.

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.

Pour plus d’informations, consultez les propriétaires Rights Management et les émetteurs IRights Management.

Lorsqu’elle est utilisée avec le client d’étiquetage unifié, la requête est basée sur le nom du document, l’e-mail du propriétaire ou les deux.

Vous devez spécifier au moins l’un des paramètres suivants :

  • ContentName
  • Propriétaire

Conseil

Si vous utilisez le paramètre ContentName , nous vous recommandons également d’utiliser les paramètres FromTime et ToTime pour filtrer votre contenu sur une période spécifique.

Exemples

Exemple 1 : (Client d’étiquetage unifié uniquement) Obtenir des informations de protection sur tous les documents suivis avec un nom de fichier spécifique, qui ont été protégés dans un délai spécifique

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Cette commande exécute une requête et retourne des informations de protection sur tous les documents suivis stockés sur votre locataire avec le nom de fichiertest.docx, qui ont été protégés en décembre 2020.

Exemple 2 : (Client d’étiquetage unifié uniquement) Obtenir des informations de protection sur tous les documents suivis avec un nom de fichier et un propriétaire spécifiques, qui ont été protégés dans un délai spécifique

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Cette commande exécute une requête et retourne des informations de protection sur tous les documents suivis stockés sur votre locataire qui correspondent aux détails suivants :

  • Le nom de fichier est test.docx
  • Le fichier a été protégé par un utilisateur avec l’e-mail alice@contoso.com
  • Le fichier a été protégé en décembre 2020.

Paramètres

-Confirm

Vous demande une confirmation 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

-ContentName

Spécifie le nom complet du document suivi, y compris l’extension de fichier.

Si vous avez le client d’étiquetage unifié, vous devez inclure ce paramètre, ou le paramètre Owner , ou vous pouvez inclure les deux.

Conseil

Si vous utilisez ce paramètre, nous vous recommandons également d’utiliser les filtres de date FromTime et ToTime pour filtrer les données retournées.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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 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

-Owner

Spécifie l’adresse e-mail de l’utilisateur qui a protégé le document (émetteur ou propriétaire Rights Management).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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

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