Merge-SPUsageLog
傳回使用記錄檔的記錄。
Syntax
Merge-SPUsageLog
[-Identity] <SPUsageDefinitionPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-DiagnosticLogPath <String>]
[-EndTime <DateTime>]
[-OverWrite]
[-Partial]
[-Servers <String[]>]
[-StartTime <DateTime>]
[<CommonParameters>] Description
Merge-SPUsageLog Cmdlet 會將每部陣列伺服器上符合準則的使用記錄檔之記錄傳回，並將結果寫入管線。
命令會根據使用者指定的準則收集、篩選和彙總記錄檔，我們建議您使用 StartTime 和 EndTime 參數來篩選以達到此 Cmdlet 的最佳效能。
您應指定至少一個使用類型。 如需有效使用類型的詳細資訊，請參閱 Get-SPUsageDefinition。
此 Cmdlet 需要啟用 PowerShell 遠端處理。
範例
範例 1
Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1將使用量定義「計時器工作」的使用量記錄從指定的伺服器合併，並輸出至 PowerShell 主控台。
參數
-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 2016, SharePoint Server 2019 |
-DiagnosticLogPath
指定要寫入診斷資訊的檔案。 支援相對路徑。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-EndTime
指定記錄項目傳回的結束時間。
此類型必須是符合管理語言文化的有效 DateTime 格式，如美國英文的 2/16/2007 12:15:12。
預設值是目前時間。
如果您想要指定 UTC 時間，必須將「Z」加入至參數結尾。 例如「2016-06-15 03:29:18.199 Z」。 如果未指定「Z」，則會顯示本機電腦時間而不是 UTC。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Identity
指定使用記錄檔名稱。
| Type: | SPUsageDefinitionPipeBind |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-OverWrite
診斷記錄檔若位在指定的路徑，即予以覆寫。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Partial
不會使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Servers
要篩選的伺服器位址。
若要在陣列中取得有效位址的清單，請使用 Get-SPServer | Select Address。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-StartTime
指定記錄項目傳回的開始時間。
此類型必須是符合管理語言文化的有效 DateTime 格式，如美國英文的「2/16/2007 12:15:12」。
預設值為本機電腦目前時間的一小時前。
如果您想要指定 UTC 時間，必須將「Z」加入至參數結尾。 例如「2016-06-15 03:29:18.199 Z」。 如果未指定「Z」，則會顯示本機電腦時間而不是 UTC。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
輸入
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind
Microsoft.SharePoint.PowerShell.SPAssignmentCollection
輸出
System.Object