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 |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 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
。