你当前正在访问 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

用于表示的布尔值,该布尔值从服务器返回特定查询的所有结果

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

-Filter

oData v3.0 筛选器语句。 控制返回的对象。

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