Get-AzureADAuditDirectoryLogs

Referenz

Modul:: AzureADPreview

Abrufen von Verzeichnisüberwachungsprotokollen

Syntax

Get-AzureADAuditDirectoryLogs
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzureADAuditDirectoryLogs ruft ein Azure Active Directory-Überwachungsprotokoll ab.

Beispiele

Beispiel 1: Abrufen von Überwachungsprotokollen nach einem bestimmten Datum

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "activityDateTime gt 2019-03-20"

Mit diesem Befehl werden alle Überwachungsprotokolle am oder nach dem 20.03.2019 abgerufen.

Beispiel 2: Abrufen von Überwachungsprotokollen, die von einem Benutzer oder einer Anwendung initiiert wurden

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/user/userPrincipalName eq 'JNiyomugabo@Contoso.com'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/user/displayName eq 'Jean Niyomugabo'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/app/appId eq 'de8bc8b5-d9f9-48b1-a8ad-b748da725064'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/app/displayName eq 'myApp'"

Diese Befehle sind verschiedene Möglichkeiten, um alle Überwachungsprotokolle für einen bestimmten Benutzer oder eine bestimmte Anwendung abzurufen.

Beispiel 3: Abrufen von Überwachungsprotokollen mit einer bestimmten Zielressource

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "targetResources/any(tr:tr/displayName eq 'Active Directory Example')"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "targetResources/any(tr:tr/type eq 'ServicePrincipal')"

Diese Befehle zeigen, wie Überwachungsprotokolle nach Anzeigename oder Typ der Zielressource abgerufen werden.

Beispiel 4: Abrufen aller Überwachungsprotokolle mit einem bestimmten Ergebnis

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "result eq 'success'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "result eq 'failure'" -All $true

Diese Befehle zeigen, wie Überwachungsprotokolle nach Ergebnis abgerufen werden.

Parameter

-All

Boolescher Ausdruck, der alle Ergebnisse vom Server für die spezifische Abfrage zurückgibt

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

-Filter

Die oData v3.0-Filter-Anweisung. Steuert, welche Objekte zurückgegeben werden.

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

-Top

Die maximale Anzahl von Datensätzen, die zurückgegeben werden sollen.

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

Freigeben über