Get-EntraBetaApplicationSignInSummary

モジュール:
Microsoft.Entra.Beta.Reports Module v1.3

過去数日間のサインインの概要を取得します。

構文

Default (既定) 

Get-EntraBetaApplicationSignInSummary

    -Days <Int32>
    [-Top <Int32>]
    [-Filter <String>]
    [<CommonParameters>]

説明

Get-EntraBetaApplicationSignInSummary コマンドレットは、過去 7 日間または 30 日間のサインインの概要を取得します。

次のプロパティを返します。

  • appDisplayName - ユーザーがサインインしたアプリケーションの名前。
  • failedSignInCount - アプリケーションによって行われた失敗したサインインの数。
  • successPercentage - アプリケーションによって成功したサインインの割合。
  • successfulSignInCount - アプリケーションによって成功したサインインの数。

例

例 1: 過去 1 週間のアプリケーション別のサインインの概要を取得する

Connect-Entra -Scopes 'Reports.Read.All'
Get-EntraBetaApplicationSignInSummary -Days 7 -Filter "appDisplayName eq 'Graph Explorer'"

Id                                   AppDisplayName FailedSignInCount SuccessPercentage SuccessfulSignInCount
--                                   -------------- ----------------- ----------------- ---------------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Graph Explorer 0                 100               14

次の使用例は、過去 7 日間の Graph Explorer へのすべてのサインインの概要を返します。

  • -Days パラメーターは、サマリーに含まれる過去の日数を指定します。 有効な値は 7 と 30 のみです。

例 2: 先月のサインインの概要を取得する

Connect-Entra -Scopes 'Reports.Read.All'
Get-EntraBetaApplicationSignInSummary -Days 30

Id                                   AppDisplayName                         FailedSignInCount SuccessPercentage SuccessfulSignInCount
--                                   --------------                         ----------------- ----------------- ---------------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Graph Explorer                         3                 96.74             89
bbbbbbbb-1111-2222-3333-cccccccccccc Azure Portal                           3                 99.15             350
cccccccc-2222-3333-4444-dddddddddddd Microsoft Community v2                 0                 100               4

次の使用例は、過去 30 日間のすべてのサインインの概要を返します。

  • -Days パラメーターは、サマリーに含まれる過去の日数を指定します。 有効な値は 7 と 30 のみです。

例 3: 先月の上位 2 つのサインインの概要を取得する

Connect-Entra -Scopes 'Reports.Read.All'
Get-EntraBetaApplicationSignInSummary -Days 30 -Top 2

Id                                   AppDisplayName                         FailedSignInCount SuccessPercentage SuccessfulSignInCount
--                                   --------------                         ----------------- ----------------- ---------------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Graph Explorer                         3                 96.74             89
bbbbbbbb-1111-2222-3333-cccccccccccc Azure Portal                           3                 99.15             350

この例では、過去 30 日間の上位 2 件の概要サインインを返します。 -Limitのエイリアスとして-Topを使用できます。

  • -Days パラメーターは、サマリーに含まれる過去の日数を指定します。 有効な値は 7 と 30 のみです。

パラメーター

-Days

過去の日数の概要に含まれる日数。 有効な値は 7 と 30 です

パラメーターのプロパティ

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Filter

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

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Top

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

パラメーターのプロパティ

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:極限

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

Microsoft.Online.Administration.GetApplicationSignInSummaryObjectsResponse