Set-SPLogLevel
設定一組類別的追蹤及事件層級。
Syntax
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 值。
------------------EXAMPLE 4-----------------------
Set-SPLogLevel -EventSeverity Warning -Identity "AreaName:*"此範例會設定相同區域中所有類別的 EventSeverity 值。
參數
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EventSeverity
指定要設定的類別層級。 類別層級為下列任一值：
- 無
- ErrorCritical
- 錯誤
- 警告
- 資訊
- 詳細資訊
| 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 (追蹤項目不會寫入追蹤記錄檔)
- 未預期
- 可監控
- 高
- 中
- 詳細資訊
- 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 |