Get-AzureADAuditSignInLogs

Referencia

Módulo:: AzureADPreview

Obtenga registros de auditoría de inicios de sesión.

Syntax

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

Description

El cmdlet Get-AzureADAuditSignInLogs obtiene un registro de inicio de sesión de Azure Active Directory.

Nota

Los resultados de este cmdlet no incluyen inicios de sesión no interactivos.

Ejemplos

Ejemplo 1: Obtención de registros de inicio de sesión después de una fecha determinada

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

Este comando obtiene todos los registros de inicio de sesión en o después del 20/3/2019

Ejemplo 2: Obtención de registros de inicio de sesión para un usuario o aplicación

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

Estos comandos son diferentes maneras de obtener todos los registros de inicio de sesión de un usuario o aplicación determinados.

Ejemplo 3: Obtención de registros de inicio de sesión desde una ubicación determinada

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

Este comando muestra cómo obtener registros de auditoría por ubicación

Ejemplo 4: Obtención de todos los registros de inicio de sesión con un estado determinado

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

Estos comandos muestran cómo obtener registros de inicio de sesión con éxito (eq 0) y errores (ne 0)

Parámetros

-All

Boolean para expresar que devuelve todos los resultados del servidor para la consulta específica

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Filter

Instrucción de filtro oData v3.0. Controla qué objetos se devuelven.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Top

Número máximo de registros que se van a devolver.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Share via