Set-SPLogLevel

  • 参考
模块:
sharepoint-server
适用于:
SharePoint Server Subscription Edition

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

语法

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

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

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

-Identity

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

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

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

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