Get-AzureADAuditDirectoryLogs

參考

模組:: AzureADPreview

取得目錄稽核記錄

Syntax

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

Description

Get-AzureADAuditDirectoryLogs Cmdlet 會取得 Azure Active Directory 稽核記錄。

範例

範例 1：在特定日期之後取得稽核記錄

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

此命令會在 2019 年 3 月 20 日或之後取得所有稽核記錄

範例 2：取得使用者或應用程式起始的稽核記錄

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'"

這些命令是取得特定使用者或應用程式之所有稽核記錄的不同方式

範例 3：取得包含指定目標資源的稽核記錄

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')"

這些命令示範如何依目標資源顯示名稱或類型取得稽核記錄

範例 4：取得具有指定結果的所有稽核記錄

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

這些命令示範如何依結果取得稽核記錄

參數

-All

布林值，表示從伺服器傳回特定查詢的所有結果

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

-Filter

oData v3.0 filter 語句。控制傳回的物件。

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

-Top

要傳回的記錄數目上限。

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