Get-AipServiceDocumentLog

Referenz

Modul:: AIPService

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

Dieses Cmdlet wird sowohl von den klassischen als auch einheitlichen Bezeichnungsclients von Azure Information Protection 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.

Zurückgegebene Informationen umfassen:

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

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.

Weitere Informationen finden Sie unter Rechteverwaltungsbesitzer und IRights Management-Ausstellern.

Bei Verwendung mit dem einheitlichen Bezeichnungsclient basiert die Abfrage auf dem Dokumentnamen, der Besitzer-E-Mail oder beides.

Sie müssen mindestens einen der folgenden Parameter angeben:

ContentName
Besitzer

Tipp

Wenn Sie den ContentName-Parameter verwenden, empfehlen wir, dass Sie auch die FromTime- und ToTime-Parameter verwenden, um Ihre Inhalte in einen bestimmten Zeitraum zu filtern.

Beispiele

Beispiel 1: (Nur einheitliche 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 auf Ihrem Mandanten gespeicherten Dokumenten mit dem Dateinamen test.docxzurück, die im Dezember 2020 geschützt wurden.

Beispiel 2: (Nur einheitliche 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 auf Ihrem Mandanten gespeicherten Dokumenten zurück, die den folgenden Details entsprechen:

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

Parameter

-Confirm

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

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

-ContentName

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

Wenn Sie über den einheitlichen Bezeichnungsclient verfügen, müssen Sie entweder diesen Parameter oder den Owner-Parameter einschließen oder beides einschließen.

Tipp

Wenn Sie diesen Parameter verwenden, empfehlen wir Ihnen, auch die FromTime- und ToTime-Datumsfilter zu verwenden, um die zurückgegebenen Daten zu filtern.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-Owner

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.