Set-SPLogLevel
適用版本: SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間: 2015-03-09
設定一組類別的追蹤及事件層級。
Syntax
Set-SPLogLevel [-AssignmentCollection <SPAssignmentCollection>] [-EventSeverity <String>] [-Identity <String[]>] [-InputObject <PSObject>] [-TraceSeverity <String>]
詳細描述
Set-SPLogLevel Cmdlet 針對在伺服器陣列中登錄的一個或多個診斷記錄類別,設定 Windows 事件記錄層級和追蹤記錄層級。若發生與類別相關的事件或追蹤,但嚴重性低於該類別的記錄層級,則該事件或追蹤不會寫入事件記錄檔或追蹤記錄檔。若發生與類別相關的事件或追蹤,且嚴重性等於或高於該類別的記錄層級,則該事件或追蹤會寫入事件記錄檔或追蹤記錄檔。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
參數 | 必要 | 輸入 | 描述 |
---|---|---|---|
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。 注意 使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。 |
EventSeverity |
選用 |
System.String |
指定要設定的類別層級。類別層級為下列任一值: - None - ErrorCritical - Error - Warning - Information - Verbose |
Identity |
選用 |
System.String[] |
指定要設定節流的類別或類別集合名稱,例如「一致的記錄服務」。若不指定 Identity 參數,伺服器陣列中的所有類別都會套用事件節流設定。 |
InputObject |
選用 |
System.Management.Automation.PSObject |
InputObject 會被輸送到 Cmdlet,而且可以是格式與 Identity 參數完全一致的字串,或為 SPDiagnosticsCategory 物件。使用者可自 Get-SPLogLevel Cmdlet 擷取一個或多個類別,修改類別值之後,再將其輸送至 Set-SPLogLevel Cmdlet。 |
TraceSeverity |
選用 |
System.String |
指定所指定之類別要設定的追蹤節流。追蹤記錄檔案是寫入追蹤記錄路徑的文字檔案,此路徑是在 SharePoint 管理中心網站的 [診斷記錄設定] 頁面中定義。此類型必須是下列任一值: - None (追蹤項目不會寫入追蹤記錄檔) - Unexpected - Monitorable - High - Medium - Verbose - VerboseEx |
輸入類型
傳回類型
Example
------------------範例 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
值。