Get-AzureADAuditSignInLogs

  • リファレンス
モジュール:
AzureADPreview

サインインの監査ログを取得します。

構文

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

説明

Get-AzureADAuditSignInLogs コマンドレットは、Azure Active Directory サインイン ログを取得します。

注意

このコマンドレットの結果には、対話型以外のサインインは含まれません。

例

例 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