共用方式為


Set-SPLogLevel

設定一組類別的追蹤及事件層級。

語法

Default (預設值)

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

Description

Set-SPLogLevel Cmdlet 會針對在伺服器數位註冊的一或多個診斷記錄類別,設定 Windows 事件記錄和追蹤記錄層級。 如果發生與類別相關聯的事件或追蹤,但其嚴重性低於該類別的記錄層級,則不會將事件或追蹤寫入事件記錄檔或追蹤記錄檔。 如果發生與類別相關聯的事件或追蹤,且其嚴重性或嚴重程度等於該類別的記錄層級,則會將事件或追蹤寫入事件記錄檔或追蹤記錄檔。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

範例 1

set-sploglevel -TraceSeverity Monitorable

本範例會將所有類別的 TraceSeverity 值設定為 [可監視]。

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

適用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

參數屬性

類型:SPAssignmentCollection
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EventSeverity

適用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要設定的類別層級。 類別層級為下列任一值:

  • ErrorCritical
  • 錯誤
  • 警告
  • Information
  • 詳細資訊

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要設定節流的類別或類別集合名稱,例如「一致的記錄服務」。 如果未指定 Identity 參數,調整事件流速的設定會套用至伺服器陣列中的所有類別。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InputObject

適用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

InputObject 會被輸送到 Cmdlet,而且可以是格式與 Identity 參數完全一致的字串,或為 SPDiagnosticsCategory 物件。 用戶可以從 Get-SPLogLevel Cmdlet 擷取一或多個類別、修改類別值,然後將它們管線至 Set-SPLogLevel Cmdlet。

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TraceSeverity

適用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定所指定之類別要設定的追蹤節流。 追蹤記錄檔案是寫入追蹤記錄路徑的文字檔案,此路徑是在 SharePoint 管理中心網站的 [診斷記錄設定] 頁面中定義。 此類型必須是下列任一值:

  • None (追蹤項目不會寫入追蹤記錄檔)
  • 未預期
  • 可監控
  • 詳細資訊
  • VerboseEx

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters