Get-AzureADAuditSignInLogs
Obtenga registros de auditoría de inicios de sesión.
Sintaxis
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
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Filter
Instrucción de filtro oData v3.0. Controla qué objetos se devuelven.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Top
Número máximo de registros que se van a devolver.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |