Merge-SPUsageLog

參考

模組:: SharePointServer

適用於:: SharePoint Server 2016, SharePoint Server 2019

傳回使用記錄檔的記錄。

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」。

預設值為本機電腦目前時間的一小時前。