Freigeben über

Get-AipServiceDocumentLog

  • Referenz
Modul:
AIPService

Ruft Schutzinformationen zu Dokumenten ab, die von Azure Information Protection nachverfolgt werden.

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

Syntax

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

Beschreibung

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

Die zurückgegebenen Informationen umfassen:

  • Die Dokumentinhalts-ID mit dem Dokumentnamen, falls verfügbar.
  • Der Rechteverwaltungsbesitzer und der Rechteverwaltungsherausgeber.
  • Die Benutzer und Gruppen, denen der Zugriff gewährt wurde.
  • Die Schutzvorlagen-ID oder bestimmte Nutzungsrechte, die das Dokument schützen.
  • Alle Ablauf-, Offlinezugriffs- oder Sperreinstellungen.

Sie können eine Start- und Stoppzeit von Einträgen angeben, die einbezogen werden sollen. Die Ausgabe wird als Liste der PowerShell-Objekte in der PowerShell-Konsole zurückgegeben.

Weitere Informationen finden Sie unter Rights Management-Besitzer und IRights Management-Aussteller.

Bei Verwendung mit dem Client für einheitliche Bezeichnungen basiert die Abfrage auf dem Dokumentnamen, der E-Mail-Adresse des Besitzers oder beides.

Sie müssen mindestens einen der folgenden Parameter angeben:

  • ContentName-
  • Besitzer-

Trinkgeld

Wenn Sie den parameter ContentName verwenden, empfiehlt es sich, auch die FromTime- und ToTime Parameter zu verwenden, um Ihre Inhalte nach einem bestimmten Zeitraum zu filtern.

Beispiele

Beispiel 1: (nur einheitlicher Bezeichnungsclient) Abrufen von Schutzinformationen zu allen nachverfolgten Dokumenten mit einem bestimmten Dateinamen, die in einem bestimmten Zeitrahmen geschützt wurden

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

Dieser Befehl führt eine Abfrage aus und gibt Schutzinformationen zu allen nachverfolgten Dokumenten zurück, die auf Ihrem Mandanten gespeichert sind, mit dem Dateinamen test.docx, die im Dezember 2020 geschützt wurden.

Beispiel 2: (Nur einheitlicher Bezeichnungsclient) Abrufen von Schutzinformationen zu allen nachverfolgten Dokumenten mit einem bestimmten Dateinamen und Besitzer, die in einem bestimmten Zeitrahmen geschützt wurden

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

Dieser Befehl führt eine Abfrage aus und gibt Schutzinformationen zu allen nachverfolgten Dokumenten zurück, die auf Ihrem Mandanten gespeichert sind, die den folgenden Details entsprechen:

  • Der Dateiname ist test.docx
  • Die Datei wurde von einem Benutzer mit der E-Mail-alice@contoso.com geschützt.
  • Die Datei wurde im Dezember 2020 geschützt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-ContentName

Gibt den vollständigen Namen des nachverfolgten Dokuments an, einschließlich der Dateierweiterung.

Wenn Sie über den Client für einheitliche Bezeichnungen verfügen, müssen Sie entweder diesen Parameter oder den parameter Owner einschließen, oder Sie können beides einschließen.

Trinkgeld

Wenn Sie diesen Parameter verwenden, empfiehlt es sich, auch die FromTime- und ToTime- Datumsfilter zum Filtern der zurückgegebenen Daten zu verwenden.

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

-FromTime

Gibt die Startzeit (einschließlich) für die Protokolldatei als DateTime- -Objekt an. Um ein DateTime--Objekt abzurufen, verwenden Sie das Cmdlet Get-Date. Geben Sie das Datum und die Uhrzeit entsprechend ihren Systemgebietsschemaeinstellungen an.

Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.

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

-Owner

Gibt die E-Mail-Adresse des Benutzers an, der das Dokument geschützt hat (der Rechteverwaltungsherausgeber oder -besitzer).

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

-ToTime

Gibt die Stoppzeit (einschließlich) für die Protokolldatei als DateTime- -Objekt an. Um ein DateTime--Objekt abzurufen, verwenden Sie das Cmdlet Get-Date. Geben Sie das Datum und die Uhrzeit entsprechend ihren Systemgebietsschemaeinstellungen an.

Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.

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

-WhatIf

Zeigt, was passiert, 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