Get-AuditLogSearch

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Get-AuditLogSearch Cmdlet 可傳回使用 New-AdminAuditLogSearch 或 New-MailboxAuditLogSearch Cmdlet 建立的目前稽核記錄搜尋清單。 Get-AuditLogSearch Cmdlet 也會傳回每當系統管理員使用 Exchange 系統管理中心 (EAC) 匯出稽核記錄時，就會起始的稽核記錄搜尋。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

執行 Get-AuditLogSearch Cmdlet 可傳回擱置的稽核記錄搜尋得清單。 稽核記錄搜尋在完成後，便不會顯示在稽核記錄搜尋清單中。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-AuditLogSearch | Format-List

本範例會顯示所有目前稽核記錄搜尋的詳細資訊。

範例 2

Get-AuditLogSearch -Type admin

本範例會傳回目前系統管理員稽核記錄搜尋的清單。

參數

-CreatedAfter

CreatedAfter 參數會篩選結果，以稽核在所指定日期之後建立的記錄搜尋。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/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

CreatedBefore 參數會篩選結果，以稽核在所指定日期之前建立的記錄搜尋。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/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

Identity 參數可指定稽核記錄搜尋的 GUID。 您可以執行 Get-AuditLogSearch | Format-List Identity 命令，以顯示所有目前稽核記錄搜尋的 GUID。

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

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 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

Type 參數可指定要傳回的稽核記錄搜尋類型。 使用值 Admin 來傳回系統管理員稽核記錄搜尋，或使用 mailbox 來傳回信箱稽核記錄搜尋。 如果未使用 Type 參數，則此 Cmdlet 會同時傳回系統管理員和信箱稽核記錄搜尋。

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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。