Partager via

Get-AipServiceDocumentLog

  • Référence
Module:
AIPService

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 une utilisation différente, 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 retourner 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 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.

Pour plus d’informations, consultez propriétaires Rights Management et é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

Pourboire

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 donnée.

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 une période 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 fichier test.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 une période 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 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

-ContentName

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

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

Pourboire

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

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

-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