Merge-SPLogFile

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

将所有服务器场计算机中的跟踪日志条目合并到本地计算机上的一个日志文件中。

语法

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>]

说明

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 Subscription Edition

-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 Subscription Edition

-Category

指定筛选所依据的类别 ID。

键入的值必须是有效的类别名称；例如，category1。

支持使用通配符。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ContextFilter

在特定的上下文中指定跟踪条目的筛选器，格式为 key=value，例如，user=contoso\joeuser。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Correlation

指定筛选所依据的互联 ID。键入的值必须是有效的 GUID（格式为 F0BB0790-4323-A153-096F-ABCDC80E24D4）。

Type:	Guid[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EndTime

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

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

-EventID

指定筛选所依据的事件 ID。支持使用通配符。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ExcludeNestedCorrelation

从结果中排除嵌套的互联值。仅当使用 ContextFilter 参数筛选结果时才使用此参数

默认情况下， ContextFilter 参数返回的记录中除了包含符合筛选条件的记录之外，还包含所有相关记录。指定此选项将只包含符合筛选条件的记录，而排除任何相关记录。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Level

指定筛选所依据的级别名称。

结果包含指定的级别以及所有更高的级别。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-Path

指定要将合并的日志文件写入其中的文件的路径和文件名。支持相对路径。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Process

指定筛选所依据的进程名称。

支持使用通配符。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-StartTime

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

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

-ThreadID

指定筛选所依据的线程 ID。

键入的值必须是介于 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 Subscription Edition

Merge-SPLogFile

语法

说明

示例

--------------示例 1-----------------

--------------示例 2-----------------

--------------示例 3-----------------

--------------示例 4-----------------

--------------示例 5-----------------

--------------示例 6-----------------

--------------示例 7-----------------

--------------示例 8-----------------

参数

-Area

-AssignmentCollection

-Category

-ContextFilter

-Correlation

-EndTime

-EventID

-ExcludeNestedCorrelation

-Level

-Message

-Overwrite

-Path

-Process

-StartTime

-ThreadID

反馈

反馈

其他资源