Sdílet prostřednictvím


Get-AzureADAuditSignInLogs

Získejte protokoly auditu přihlášení.

Syntaxe

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

Description

Rutina Get-AzureADAuditSignInLogs získá protokol přihlášení k Azure Active Directory.

Poznámka

Výsledky této rutiny nezahrnují neinteraktivní přihlášení.

Příklady

Příklad 1: Získání protokolů přihlášení po určitém datu

PS C:\>Get-AzureADAuditSignInLogs -Filter "createdDateTime gt 2019-03-20"

Tento příkaz získá všechny protokoly přihlášení k 20. 3. 2019 nebo později.

Příklad 2: Získání protokolů přihlášení pro uživatele nebo aplikaci

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'"

Tyto příkazy představují různé způsoby, jak získat všechny protokoly přihlášení pro určitého uživatele nebo aplikaci.

Příklad 3: Získání protokolů přihlášení z určitého umístění

PS C:\>Get-AzureADAuditSignInLogs -Filter "location/city eq 'Redmond' and location/state eq 'Washington' and location/countryOrRegion eq 'US'"

Tento příkaz ukazuje, jak získat protokoly auditu podle umístění.

Příklad 4: Získání všech protokolů přihlášení s daným stavem

PS C:\>Get-AzureADAuditSignInLogs -Filter "status/errorCode eq 0" -All $true
PS C:\>Get-AzureADAuditSignInLogs -Filter "status/errorCode ne 0"

Tyto příkazy ukazují, jak získat protokoly přihlášení pro úspěšné (eq 0) a neúspěšné (ne 0).

Parametry

-All

Logická hodnota pro vyjádření, která vrací všechny výsledky ze serveru pro konkrétní dotaz

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Filter

Příkaz filtru oData v3.0. Určuje, které objekty se vrátí.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Top

Maximální počet záznamů, které se mají vrátit.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False