你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Get-AzureADAuditSignInLogs
获取登录的审核日志。
语法
Get-AzureADAuditSignInLogs
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
说明
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 |