Get-AzureADAuditSignInLogs
取得登入的稽核記錄。
語法
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
布爾值,表示從伺服器傳回特定查詢的所有結果
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Filter
oData v3.0 filter 語句。 控制傳回的物件。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Top
要傳回的記錄數目上限。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |