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 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 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。 错误报告包括下列内容：有关出现问题时服务器状况的信息；所使用的操作系统版本和计算机硬件；可用于标识您的许可证的数字产品 ID。由于您连接到了联机服务以发送错误报告，因此也将发送您计算机的 IP 地址；不过，该 IP 地址仅用于生成汇总统计信息。 该类型必须是下列值之一： - $True - $False 默认值为 $True。 |
ErrorReportingEnabled |
可选 |
System.Management.Automation.SwitchParameter |
指定是否启用错误报告收集。 当系统遇到硬件或软件问题时，就会创建错误报告。Microsoft 及其合作伙伴将积极使用这些报告来改善软件的可靠性。错误报告包括下列内容：有关出现问题时服务器状况的信息；所使用的操作系统版本和计算机硬件；可用于标识您的许可证的数字产品 ID。由于您连接到了联机服务以发送错误报告，因此也将发送您计算机的 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。