Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Get-AuditLogSearch

 

Applies to: Exchange Server 2013, Exchange Online

Topic Last Modified: 2014-01-15

Use the Get-AuditLogSearch cmdlet to return a list of current audit log searches that were created with the New-AdminAuditLogSearch or New-MailboxAuditLogSearch cmdlets. The Get-AuditLogSearch cmdlet also returns audit log searches that are initiated whenever an administrator uses the Exchange Admin Center (EAC) to export audit logs.

For information about the parameter sets in the Syntax section below, see Syntax.

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

This example displays detailed information for all current audit log searches.

Get-AuditLogSearch | FL

This example returns a list of current administrator audit log searches.

Get-AuditLogSearch -Type admin

Run the Get-AuditLogSearch cmdlet to return a list of pending audit log searches. If an audit log search has been completed, it won’t be displayed in the list of audit log searches.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "View-only administrator audit logging" entry in the Exchange and Shell Infrastructure Permissions topic.

 

Parameter Required Type Description

CreatedAfter

Optional

Microsoft.Exchange.ExchangeSystem.ExDateTime

The CreatedAfter parameter filters the results to audit log searches that were created after the specified date.

Use the short date format defined in the Regional Options settings for the computer on which the command is run. For example, if the computer is configured to use the short date format mm/dd/yyyy, enter 03/01/2010 to specify March 1, 2010. You can enter the date only, or you can enter the date and time of day. If you enter the date and time of day, you must enclose the argument in quotation marks ("), for example, "10/05/2010 5:00 PM".

CreatedBefore

Optional

Microsoft.Exchange.ExchangeSystem.ExDateTime

The CreatedBefore parameter filters the results to audit log searches that were created before the specified date.

Use the short date format defined in the Regional Options settings for the computer on which the command is run. For example, if the computer is configured to use the short date format mm/dd/yyyy, enter 03/01/2010 to specify March 1, 2010. You can enter the date only, or you can enter the date and time of day. If you enter the date and time of day, you must enclose the argument in quotation marks ("), for example, "10/05/2010 5:00 PM".

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.AuditLogSearchIdParameter

The Identity parameter specifies the GUID for an audit log search. You can run the command Get-AuditLogSearch | Format-List Identity to display the GUIDs for all current audit log searches.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

This parameter is reserved for internal Microsoft use.

ResultSize

Optional

System.Int32

The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.

Type

Optional

System.String

The Type parameter specifies the type of audit log searches to return. Use the value Admin to return administrator audit log searches or use mailbox to return mailbox audit log searches. If the Type parameter isn’t used, the cmdlet returns both administrator and mailbox audit log searches.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.