Get-AzureADAuditSignInLogs

參考

模組:: AzureADPreview

取得登入的稽核記錄。

Syntax

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

Description

Get-AzureADAuditSignInLogs Cmdlet 會取得 Azure Active Directory 登入記錄。

注意

此 Cmdlet 的結果不包含非互動式登入。

範例

範例 1：在特定日期之後取得登入記錄

PS C:\>Get-AzureADAuditSignInLogs -Filter "createdDateTime gt 2019-03-20"

此命令會在 2019/3/20 或之後取得所有登入記錄

範例 2：取得使用者或應用程式的登入記錄

PS C:\>Get-AzureADAuditSignInLogs -Filter "startsWith(userPrincipalName,'JNiyomugabo@Contoso.com')"
PS C:\>Get-AzureADAuditSignInLogs -Filter "userDisplayName eq 'Jean Niyomugabo'"
PS C:\>Get-AzureADAuditSignInLogs -Filter "appId eq 'de8bc8b5-d9f9-48b1-a8ad-b748da725064'"
PS C:\>Get-AzureADAuditSignInLogs -Filter "appDisplayName eq 'myApp'"

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

範例 3：從特定位置取得登入記錄

PS C:\>Get-AzureADAuditSignInLogs -Filter "location/city eq 'Redmond' and location/state eq 'Washington' and location/countryOrRegion eq 'US'"

此命令示範如何依位置取得稽核記錄

範例 4：取得具有指定狀態的所有登入記錄

PS C:\>Get-AzureADAuditSignInLogs -Filter "status/errorCode eq 0" -All $true
PS C:\>Get-AzureADAuditSignInLogs -Filter "status/errorCode ne 0"

這些命令示範如何取得登入記錄，以取得成功 (eq 0) 和失敗 (ne 0)

參數

-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