Merge-SPLogFile
將所有伺服器陣列電腦中的追蹤記錄項目，合併為本機電腦中的單一記錄檔案。
Syntax
Merge-SPLogFile
-Path <String>
[-Area <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Category <String[]>]
[-ContextFilter <String[]>]
[-Correlation <Guid[]>]
[-EndTime <DateTime>]
[-EventID <String[]>]
[-ExcludeNestedCorrelation]
[-Level <String>]
[-Message <String[]>]
[-Overwrite]
[-Process <String[]>]
[-StartTime <DateTime>]
[-ThreadID <UInt32[]>]
[<CommonParameters>] Description
Merge-SPLogFile Cmdlet 會從整合記錄服務 (ULS 傳回記錄，) 符合準則的每部伺服器陣列伺服器上的追蹤記錄檔，並將結果寫入本機電腦上的新記錄檔。 如果未傳回任何結果，則會將警告寫入Windows PowerShell主控台視窗。
建議您使用 StartTime 與 EndTime 參數加以篩選，將此 Cmdlet 的效能最佳化。 有些篩選參數 (例如 Process、Area、Category、EventID 及 Message) 支援萬用字元。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
--------------範例 1-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite此範例會合併所有伺服器陣列電腦中最後一小時的記錄資料，而不加以篩選。
--------------範例 2-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area Search此範例會合併 Search 區域中最後一小時的記錄資料。
--------------範例 3-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"此範例會合併 SharePoint Foundation 及 Web Analytics Services 區域中最後一小時的記錄資料。
--------------範例 4-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level High此範例會合併 High 等級 (含) 以上的記錄資料。
--------------範例 5-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"此範例會合併特定時間範圍內的事件記錄資料，依美國的文化習慣而定。
--------------範例 6-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"此範例會合併訊息文字中具有 permission changed 的事件記錄資料。
--------------範例 7-----------------
Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"此範例會合併所有搜尋計時器工作中的記錄資料。
--------------範例 8-----------------
Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"此範例會針對具有 contoso\joeuser 或 Contoso/joeuser 格式的所有使用者名稱，顯示如何合併其記錄資料。
參數
-Area
指定要篩選的區域名稱。
此類型必須是有效的名稱，例如 SharePoint Foundation。
支援萬用字元的使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。 若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Category
指定要篩選的類別識別碼。
此類型必須是有效的類別名稱，例如 category1。
支援萬用字元的使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ContextFilter
指定特定內容的追蹤項目篩選，格式為「機碼=值」，例如 user=contoso\joeuser。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Correlation
指定要篩選的相互關聯識別碼。 此類型必須是格式為 F0BB0790-4323-A153-096F-ABCDC80E24D4 的有效 GUID。
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EndTime
指定記錄項目傳回的結束時間。
此類型必須是符合管理語言文化的有效 DateTime 格式，如美國英文的 2/16/2007 12:15:12。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EventID
指定要篩選的事件識別碼。 支援萬用字元的使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ExcludeNestedCorrelation
排除結果中的巢狀關聯值。 唯有在使用 ContextFilter 參數篩選結果時，才使用此參數。
根據預設，除符合篩選的記錄外，從 ContextFilter 參數傳回的記錄預設還包括所有的相關記錄。 指定此選項僅包括符合篩選的記錄，並會排除所有相關的記錄。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Level
指定要篩選的等級名稱。
結果包括指定的等級及所有更嚴重的事項。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Message
指定要篩選的訊息文字。
此類型必須是有效的文字。 有空格的文字應以引號括住，例如 "This is a test"。
支援萬用字元的使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Overwrite
記錄檔若位在指定的路徑，即予以覆寫。
此類型必須是下列其中一個值：
- $True
- $False
預設值為 $False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Path
指定寫入合併記錄檔案的路徑及檔案名稱。 支援相對路徑。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Process
指定要篩選的處理程序名稱。
支援萬用字元的使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-StartTime
指定記錄項目傳回的開始時間。
此類型必須是符合管理語言文化的有效 DateTime 格式，如美國英文的 2/16/2007 12:15:12。
預設為本機電腦目前時間的一小時前。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ThreadID
指定要篩選的執行緒識別碼。
此類型必須是從 0 到 4,294,967,295 之間的有效整數。
| Type: | UInt32[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |