Merge-SPUsageLog

参考

模块:: SharePointServer

适用于:: SharePoint Server 2016, SharePoint Server 2019

从使用率日志文件返回记录。

语法

Merge-SPUsageLog
     [-Identity] <SPUsageDefinitionPipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-DiagnosticLogPath <String>]
     [-EndTime <DateTime>]
     [-OverWrite]
     [-Partial]
     [-Servers <String[]>]
     [-StartTime <DateTime>]
     [<CommonParameters>]

说明

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

指定所返回日志条目的结束时间。

键入的值必须是管理语言的区域性特定的有效日期时间格式，即美国英语的日期时间格式为 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

指定返回日志条目的开始时间。

键入的值必须是管理语言的区域性特定的有效日期时间格式，如美国英语的日期时间格式为"2/16/2007 12:15:12"。

默认值比本地计算机上的当前时间早一个小时。