Get-EntraBetaApplicationSignInSummary

Módulo:
Microsoft.Entra.Beta.Reports Module v1.3

Obtenha o resumo de login pelos últimos dias.

Sintaxe

Default (Predefinição) 

Get-EntraBetaApplicationSignInSummary

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

Descrição

O Get-EntraBetaApplicationSignInSummary cmdlet recebe resumos de registo dos últimos 7 ou 30 dias.

Devolve as propriedades abaixo:

  • appDisplayName - o nome da aplicação em que o utilizador iniciou sessão.
  • failedSignInCount - contagem de falhas de início de sessão feitas pela aplicação.
  • Percentual de sucesso - a percentagem de registos bem-sucedidos feitos pela aplicação.
  • successfulLogInCount - contagem de logins bem-sucedidos feitos pela aplicação.

Exemplos

Exemplo 1: Obtenha o resumo de login por candidatura para a última semana

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

Este exemplo devolve um resumo de todos os logins no Graph Explorer dos últimos sete dias.

  • -Days O parâmetro especifica o número de dias passados que o resumo contém. Os valores válidos são apenas 7 e 30.

Exemplo 2: Obtenha resumos de login do último mês

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

Este exemplo devolve resumos de todos os registos dos últimos 30 dias.

  • -Days O parâmetro especifica o número de dias passados que o resumo contém. Os valores válidos são apenas 7 e 30.

Exemplo 3: Obtenha os dois principais resumos de login do último mês

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

Este exemplo devolve os dois principais resumos de login dos últimos 30 dias. Você pode usar -Limit como um alias para -Top.

  • -Days O parâmetro especifica o número de dias passados que o resumo contém. Os valores válidos são apenas 7 e 30.

Parâmetros

-Days

O número de resumos dos dias anteriores contém. Os valores válidos são 7 e 30

Propriedades dos parâmetros

Tipo:System.Int32
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Filter

A instrução do filtro OData v4.0. Controla quais os objetos que são devolvidos.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Top

O número máximo de registros a serem retornados.

Propriedades dos parâmetros

Tipo:System.Int32
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Limit

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

Microsoft.Online.Administration.GetApplicationSignInSummaryObjectsResponse