Get-AuditLogSearch

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-AuditLogSearch para devolver una lista de las búsquedas del registro de auditoría actuales que se crearon con los cmdlets New-AdminAuditLogSearch o New-MailboxAuditLogSearch. El cmdlet Get-AuditLogSearch también devuelve búsquedas de registros de auditoría que se inician cada vez que un administrador usa el Centro de administración de Exchange (EAC) para exportar registros de auditoría.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-AuditLogSearch
   [[-Identity] <AuditLogSearchIdParameter>]
   [-CreatedAfter <ExDateTime>]
   [-CreatedBefore <ExDateTime>]
   [-ResultSize <Int32>]
   [-Type <String>]
   [<CommonParameters>]

Description

Ejecute el cmdlet Get-AuditLogSearch para devolver una lista de las búsquedas del registro de auditoría pendientes. Si se completó una búsqueda del registro de auditoría, no se mostrará en la lista de búsquedas del registro de auditoría.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-AuditLogSearch | Format-List

En este ejemplo, se muestra información detallada de todas las búsquedas del registro de auditoría actuales.

Ejemplo 2

Get-AuditLogSearch -Type admin

Este ejemplo devuelve una lista de las búsquedas actuales del registro de auditoría de administradores.

Parámetros

-CreatedAfter

El parámetro CreatedAfter filtra los resultados para auditar las búsquedas del registro que se crearon después de la fecha especificada.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:	ExDateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreatedBefore

El parámetro CreatedBefore filtra los resultados para auditar las búsquedas del registro que se crearon antes de la fecha especificada.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:	ExDateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

El parámetro Identity especifica el GUID de una búsqueda del registro de auditoría. Puede ejecutar el comando Get-AuditLogSearch | Format-List Identity para mostrar los GUID de todas las búsquedas del registro de auditoría actuales.

Type:	AuditLogSearchIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Type

El parámetro Type especifica el tipo de búsquedas del registro de auditoría que se devolverán. Use el valor Admin para devolver las búsquedas del registro de auditoría de administradores, o use mailbox para devolver las búsquedas del registro de auditoría de buzones. Si no se usa el parámetro Type, el cmdlet devuelve las búsquedas del registro de auditoría de administradores y de buzones.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.