Get-AipServiceDocumentLog
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
Default (Standard)
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-
- Eigentümer
Tipp
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 zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Tipp
Wenn Sie diesen Parameter verwenden, empfiehlt es sich, auch die FromTime- und ToTime- Datumsfilter zum Filtern der zurückgegebenen Daten zu verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FromTime
Gibt die Startzeit (einschließlich) 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 entsprechend ihren Systemgebietsschemaeinstellungen an.
Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.
Parametereigenschaften
| Typ: | DateTime |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Owner
Gibt die E-Mail-Adresse des Benutzers an, der das Dokument geschützt hat (der Rechteverwaltungsherausgeber oder -besitzer).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ToTime
Gibt die Stoppzeit (einschließlich) 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 entsprechend ihren Systemgebietsschemaeinstellungen an.
Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.
Parametereigenschaften
| Typ: | DateTime |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.