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

特定のクエリに対してサーバーからすべての結果を返すを表すブール値

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Filter

oData v3.0 フィルター ステートメント。 返されるオブジェクトを制御します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Top

返されるレコードの最大数。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False