Set-SPLogLevel

参考

模块:: SharePointServer

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

设置一组类别的跟踪级别和事件级别。

语法

Set-SPLogLevel
   [-AssignmentCollection <SPAssignmentCollection>]
   [-EventSeverity <String>]
   [-Identity <String[]>]
   [-InputObject <PSObject>]
   [-TraceSeverity <String>]
   [<CommonParameters>]

说明

cmdlet Set-SPLogLevel 为场中注册的一个或多个诊断日志记录类别设置 Windows 事件日志记录和跟踪日志记录级别。如果出现与某类别关联的事件或跟踪，但其严重性低于该类别的日志记录级别，则事件或跟踪将不会写入到事件日志或跟踪日志中。如果出现与某类别关联的事件或跟踪，且其严重性等于或高于该类别的日志记录级别，则事件或跟踪将会写入到事件日志或跟踪日志中。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

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

set-sploglevel -TraceSeverity Monitorable

此示例将所有类别的 TraceSeverity 值设置为 Monitorable。

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

Set-SPLogLevel -TraceSeverity High -EventSeverity Warning -Identity "Cat1"

此示例设置单个类别的 EventSeverity 和 TraceSeverity 值。

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

C:\PS>"Cat1", "Cat2", "Cat3" | Set-SPLogLevel -EventSeverity Error

此示例设置多个类别的 EventSeverity 值。

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

Set-SPLogLevel -EventSeverity Warning -Identity "AreaName:*"

此示例设置同一区域中所有类别的 EventSeverity 值。

参数

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 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

-EventSeverity

指定要设置的类别级别。该类别级别为下列任意一个值：

无
ErrorCritical
错误
Warning
信息
Verbose

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

-Identity

指定要为其设置限制的类别或类别集的名称；例如，"统一日志记录服务"。如果未指定 Identity 参数，则事件限制设置会应用于服务器场中的所有类别。

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

-InputObject

InputObject 会通过管道传输到该 cmdlet，它可以是格式与 Identity 参数相同的字符串，也可以是 SPDiagnosticsCategory 对象。用户可以从 Get-SPLogLevel cmdlet 中检索一个或多个类别，修改类别值，然后将其管道传递到 Set-SPLogLevel cmdlet 中。

Type:	PSObject
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

-TraceSeverity

指定要为指定的类别设置的跟踪限制。跟踪日志文件是写入到跟踪日志路径的文本文件，跟踪日志路径是在 SharePoint 管理中心网站的"诊断日志记录设置"页上定义的。键入的值必须是下列值中的任何一个：

None （不向跟踪日志中写入任何跟踪）
Unexpected
Monitorable
High
Medium
Verbose
VerboseEx

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

通过