Get-AgentLog
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-AgentLog 指令程式來剖析您指定為參數的記錄檔，並從反垃圾郵件代理程式套用的篩選中，在您指定的期間收集原始統計資料。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Get-AgentLog
[-EndDate <DateTime>]
[-Location <LocalLongFullPath>]
[-StartDate <DateTime>]
[-TransportService <TransportService>]
[<CommonParameters>] Description
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-AgentLog -StartDate "01/04/2018 9:00:00 AM" -EndDate "01/08/2018 6:00:00 PM" -TransportService FrontEnd此範例會傳回一份報告，其中包含在前端傳輸服務的 09：00 (9 A.M.) 、2018 年 1 月 4 日和 18：00 (6 P.M.) ，2018 年 1 月 8 日之間收集的統計資料。
參數
-EndDate
EndDate 參數會指定日期範圍的結束日期。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Location
Location 參數會指定包含記錄檔的目錄，您可以用記錄檔來建立使用報告。 預設路徑為 %ExchangeInstallPath%TransportRoles\Logs\AgentLog。 您必須將檔案路徑包括在引號 (") 中。
| Type: | LocalLongFullPath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StartDate
StartDate 參數會指定日期範圍的開始日期。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransportService
TransportService 參數會指定您想要檢視或修改的傳輸服務。 此參數的有效值為：
- Hub，用於信箱伺服器上的傳輸服務。
- Hub，用於信箱伺服器上的傳輸服務。
- MailboxSubmission，用於信箱伺服器上的信箱傳輸提交服務。
- MailboxDelivery，用於信箱伺服器上的信箱傳輸傳遞服務。
- FrontEnd，用於信箱伺服器上的前端傳輸服務。
| Type: | TransportService |
| 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 |
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。