Get-AipServiceTrackingLog

Ruft Nachverfolgungsinformationen für Dokumente ab, die von Azure Information Protection geschützt sind.

Dieses Cmdlet wird sowohl von den klassischen als auch einheitlichen Bezeichnungsclients von Azure Information Protection unterstützt, wie unten beschrieben.

Syntax

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

Beschreibung

Das Cmdlet Get-AipServiceTrackingLog führt eine Abfrage aus, um Schutzinformationen zu nachverfolgten Dokumenten zurückzugeben.

Zurückgegebene Informationen umfassen:

  • Die Dokumentinhalts-ID mit dem Dokumentnamen, falls verfügbar.
  • Der Aussteller für die Rechteverwaltung.
  • Die Benutzer, die auf das Dokument zugegriffen haben, wann und von welchem Speicherort.
  • Welche Schutzvorlagen-ID oder bestimmte Nutzungsrechte verwendet wurden, um das Dokument zu schützen und ob der Zugriff gewährt oder verweigert wurde.
  • Die IsHiddenInfo-Eigenschaft , die immer falsch sein wird. Diese Eigenschaft wird verwendet, um Ereignisse für Benutzer auszublenden, in denen die Nachverfolgung deaktiviert ist.

Sie können einen Startzeitpunkt und einen Endzeitpunkt für die zu berücksichtigenden Einträge angeben. Die Ausgabe wird als Liste der PowerShell-Objekte in der PowerShell-Konsole zurückgegeben.

Das Cmdlet Get-AipServiceTracking gibt Nachverfolgungsinformationen zu einem geschützten Dokument mit einer angegebenen ContentID zurück.

Um die contentID für ein bestimmtes Dokument abzurufen, verwenden Sie das Cmdlet "Get-AipServiceDocumentLog ".

Beispiele

Beispiel 1: Abrufen von Nachverfolgungsdaten für ein bestimmtes Dokument mithilfe seiner contentId

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

Dieser Befehl führt eine Abfrage aus, um Nachverfolgungsinformationen für ein bestimmtes Dokument mit einem InhaltsID-Wert von c03bf90c-6e40-4f3f-9ba0-2bcd77524b87 zurückzugeben.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContentId

Gibt den ContentID-Wert für das Dokument an, für das Sie Nachverfolgungsdaten zurückgeben möchten.

Um die contentID für ein bestimmtes Dokument abzurufen, verwenden Sie das Cmdlet "Get-AipServiceDocumentLog ".

Typ:String
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FromTime

Gibt die Startzeit (inklusive) für die Protokolldatei als DateTime-Objekt an. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ". Geben Sie das Datum und die Uhrzeit gemäß Ihren Systemschemaeinstellungen an. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ToTime

Gibt die Stoppzeit (inklusive) für die Protokolldatei als DateTime-Objekt an. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ". Geben Sie das Datum und die Uhrzeit gemäß Ihren Systemschemaeinstellungen an. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserEmail

Gibt die E-Mail-Adresse des Benutzers an. Das Cmdlet ruft die Nachverfolgungsinformationen für Dokumente ab, die geschützt wurden oder von dem Benutzer, der über diese E-Mail-Adresse verfügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False