Partilhar via


Get-AzureADAuditDirectoryLogs

Obter registos de auditoria de diretórios

Sintaxe

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

Description

O cmdlet Get-AzureADAuditDirectoryLogs obtém um registo de auditoria do Azure Active Directory.

Exemplos

Exemplo 1: Obter registos de auditoria após uma determinada data

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "activityDateTime gt 2019-03-20"

Este comando obtém todos os registos de auditoria em ou depois de 20/03/2019

Exemplo 2: Obter registos de auditoria iniciados por um utilizador ou aplicação

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/user/userPrincipalName eq 'JNiyomugabo@Contoso.com'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/user/displayName eq 'Jean Niyomugabo'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/app/appId eq 'de8bc8b5-d9f9-48b1-a8ad-b748da725064'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "initiatedBy/app/displayName eq 'myApp'"

Estes comandos são diferentes formas de obter todos os registos de auditoria de um determinado utilizador ou aplicação

Exemplo 3: Obter registos de auditoria que contenham um determinado recurso de destino

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "targetResources/any(tr:tr/displayName eq 'Active Directory Example')"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "targetResources/any(tr:tr/type eq 'ServicePrincipal')"

Estes comandos mostram como obter registos de auditoria por nome ou tipo de apresentação de recursos de destino

Exemplo 4: Obter todos os registos de auditoria com um determinado resultado

PS C:\>Get-AzureADAuditDirectoryLogs -Filter "result eq 'success'"
PS C:\>Get-AzureADAuditDirectoryLogs -Filter "result eq 'failure'" -All $true

Estes comandos mostram como obter registos de auditoria por resultado

Parâmetros

-All

Booleano para expressar que devolve todos os resultados do servidor para a consulta específica

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Filter

A instrução de filtro oData v3.0. Controla os objetos que são devolvidos.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Top

O número máximo de registos a devolver.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False