共用方式為


Set-SPDiagnosticConfig

 

適用版本: SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間: 2015-03-09

設定伺服器陣列的診斷組態設定。

Syntax

Set-SPDiagnosticConfig [-AllowLegacyTraceProviders <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-CustomerExperienceImprovementProgramEnabled <SwitchParameter>] [-DaysToKeepLogs <Int32>] [-DownloadErrorReportingUpdatesEnabled <SwitchParameter>] [-ErrorReportingAutomaticUploadEnabled <SwitchParameter>] [-ErrorReportingEnabled <SwitchParameter>] [-EventLogFloodProtectionEnabled <SwitchParameter>] [-EventLogFloodProtectionNotifyInterval <Int32>] [-EventLogFloodProtectionQuietPeriod <Int32>] [-EventLogFloodProtectionThreshold <Int32>] [-EventLogFloodProtectionTriggerPeriod <Int32>] [-InputObject <PSObject>] [-LogCutInterval <Int32>] [-LogDiskSpaceUsageGB <Int32>] [-LogLocation <String>] [-LogMaxDiskSpaceUsageEnabled <SwitchParameter>] [-ScriptErrorReportingDelay <Int32>] [-ScriptErrorReportingEnabled <SwitchParameter>] [-ScriptErrorReportingRequireAuth <SwitchParameter>]

詳細描述

Set-SPDiagnosticConfig cmdlet 可用於設定整個伺服器陣列的診斷組態設定。

如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數 必要 類型 描述

AllowLegacyTraceProviders

選用

System.Management.Automation.SwitchParameter

指定為舊版 SharePoint 產品及技術所建的追蹤提供者,可寫入 SharePoint 2010 產品的追蹤工作階段。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

CustomerExperienceImprovementProgramEnabled

選用

System.Management.Automation.SwitchParameter

指定是否參與客戶經驗改進計畫 (CEIP)。

CEIP 之目的是改進 Microsoft 產品和技術的品質、可靠性和執行效能。經由您的許可,關於您伺服器的匿名資訊將會傳送至 Microsoft,以協助我們改進 SharePoint 產品及技術。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

DaysToKeepLogs

選用

System.Int32

指定追蹤記錄檔要保留的天數。此類型必須是 1 到 366 之間的有效數字。預設值為 14 天。

DownloadErrorReportingUpdatesEnabled

選用

System.Management.Automation.SwitchParameter

指定是否下載錯誤報告遠端控制檔案。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

ErrorReportingAutomaticUploadEnabled

選用

System.Management.Automation.SwitchParameter

指定錯誤報告是否自動上傳至 Microsoft。

錯誤報告包含下列資訊:發生問題時的伺服器狀態相關資訊;作業系統版本和使用中的電腦硬體;以及可用來識別授權的數位產品識別碼。電腦的 IP 位址也會一併傳送,因為您是連線到線上服務來傳送錯誤報告;然而,IP 位址只會用來產生彙總的統計資料。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

ErrorReportingEnabled

選用

System.Management.Automation.SwitchParameter

指定是否採集錯誤報告。

當您的系統遇到硬體或軟體問題時,會建立錯誤報告。Microsoft 及其協力廠商會主動使用這些報告以改進您軟體的可靠性。錯誤報告包含下列資訊:發生問題時的伺服器狀態相關資訊;作業系統版本和使用中的電腦硬體;以及可用來識別您的授權數位產品識別碼。電腦的 IP 位址也會一併傳送,因為您是連線到線上服務來傳送錯誤報告;然而,IP 位址只會用來產生彙總的統計資料。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

EventLogFloodProtectionEnabled

選用

System.Management.Automation.SwitchParameter

指定是否啟用防止事件記錄檔濫記功能。

若有多件相似事件寫入事件記錄檔, Microsoft SharePoint Foundation 2010 會隱藏某些重複的訊息,並在一段時間之後寫入摘要訊息,指出隱藏的事件數。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

EventLogFloodProtectionNotifyInterval

選用

System.Int32

指定以分鐘計的摘要事件寫入頻率,指出因防止濫記而隱藏的事件數。

此整數範圍介於 1 到 1440 之間。預設值為 5

EventLogFloodProtectionQuietPeriod

選用

System.Int32

指定不激發事件即結束防止濫記的時間,以分鐘計。

此整數範圍介於 1 到 1440 之間。預設值為 2

EventLogFloodProtectionThreshold

選用

System.Int32

指定設定時間範圍內允許的事件數,超過此數即視為事件記錄檔濫記的事件。

此整數範圍介於 1 到 100 之間。預設值為 5

EventLogFloodProtectionTriggerPeriod

選用

System.Int32

指定留意可能濫記事件的時間範圍,以分鐘計。

此整數範圍介於 1 到 1440 之間。預設值為 2

InputObject

選用

System.Management.Automation.PSObject

使用 Get-SPDiagnosticConfig cmdlet 的結果,予以修改後再將此物件輸送至 Set-SPDiagnosticConfig cmdlet,以更新 Windows SharePoint Services 資料庫。

LogCutInterval

選用

System.Int32

指定變換成下一份記錄檔案的時間。

此類型必須是 0 到 1440 之間的有效數字。

預設值為 30

LogDiskSpaceUsageGB

選用

System.Int32

指定用於追蹤記錄檔的儲存量上限,以 GB 計。

預設值為 1000,且只有在 LogMaxDiskSpaceusageEnabled cmdlet 設為 True 時才生效。

此類型必須是 1 到 1000 之間的有效數字。

LogLocation

選用

System.String

指定記錄檔所在位置的路徑。

此類型必須是有效的路徑,格式為 C:\Logs。

預設位置為 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Logs。

LogMaxDiskSpaceUsageEnabled

選用

System.Management.Automation.SwitchParameter

指定是否要限制用於追蹤記錄檔的空間上限。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $False

ScriptErrorReportingDelay

選用

System.Int32

指定指令碼錯誤報告的間隔時間 (以分鐘計)。

此類型必須是 0 到 1440 之間的有效整數。此值以分鐘計。

預設值為 30

ScriptErrorReportingEnabled

選用

System.Management.Automation.SwitchParameter

指定是否要啟用用戶端指令碼錯誤的錯誤報告。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

ScriptErrorReportingRequireAuth

選用

System.Management.Automation.SwitchParameter

指定指令碼錯誤報告是否需要驗證。

此類型必須是下列其中一個值:

- $True

- $False

預設值為 $True

輸入類型

傳回類型

Example

------------------範例 1-----------------------

set-spdiagnosticconfig -errorReportingEnable -DownloadErrorReportingUpdatesEnabled:$false -DaysToKeepLog  60

此範例會將記錄檔的保留天數設為 60

------------------範例 2-----------------------

$L = get-spdiagnosticconfig

$L.CustomerExperienceImprovementProgramEnabled = $false

$L.LogCutInterval = 60

$L | Set-SPDiagnosticConfig

此範例會啟用 ErrorReporting、停用 DownloadErrorReportingUpdates,然後將 DaysToKeepLog 設為 60

See Also

Reference

Get-SPDiagnosticConfig