Set-SPFarmConfig

适用于: SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题: 2015-03-09

设置本地服务器场的一个全局属性,或者一个全局属性的集合。

Syntax

Set-SPFarmConfig [-ASPScriptOptimizationEnabled <$true | $false>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DataFormWebPartAutoRefreshEnabled <$true | $false>] [-Force <SwitchParameter>] [-InstalledProductsRefresh <SwitchParameter>] [-ServiceConnectionPointBindingInformation <String>] [-ServiceConnectionPointDelete <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WorkflowBatchSize <Int32>] [-WorkflowEventDeliveryTimeout <Int32>] [-WorkflowPostponeThreshold <Int32>]

详细说明

Set-SPFarmConfig cmdlet 将更新本地服务器场的全局设置的集合,并且这些设置不是 SPFarm 对象的成员。使用 Get-SPFarmConfig cmdlet 可读取本地服务器场的全局设置,并且可基于从本地服务器场返回的属性集合创建新的 PSCustomObject 对象,然后将此对象添加到管道。修改该 PSCustomObject 对象,并将其传给 Set-SPFarmConfig cmdlet 以修改参数值。

PSCustomObject 对象中收集的属性必须是服务器场范围的设置,并且对于整个服务器场只能配置一次。添加到 PSCustomObject 对象的参数名必须与 Set-SPFarmConfig cmdlet 的输入参数名完全相同。

Parameters

参数 是否必需 类型 说明

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWebSPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWebSPSiteSPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

注意Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Confirm

可选

System.Management.Automation.SwitchParameter

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

DataFormWebPartAutoRefreshEnabled

可选

System.Boolean

指定是否允许此服务器场中的任何页面上的任何 DataFormWebPart 以异步方式(在页面呈现完成之后)定期刷新其内容。如果设置为 false,所有 DataFormWebParts 将忽略在 Web 部件属性中提供的自动刷新间隔。

Force

可选

System.Management.Automation.SwitchParameter

强制删除或更新服务连接点。

InstalledProductsRefresh

可选

System.Management.Automation.SwitchParameter

使用服务器场中安装的产品的列表更新当前计算机的许可证状态。

ServiceConnectionPointBindingInformation

可选

System.String

在 Active Directory 域服务 (AD DS) 中添加或更新当前服务器场的服务连接点。

键入的值必须是将添加到此服务连接点的键值对的字符串数组。

ServiceConnectionPointDelete

可选

System.Management.Automation.SwitchParameter

在 AD DS 中删除当前服务器场的服务连接点。

WhatIf

可选

System.Management.Automation.SwitchParameter

显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters

WorkflowBatchSize

可选

System.Int32

指定传递到单个工作流实例的事件的分页大小。对于每个请求,每次将以 100 个事件的批大小输出事件流。

批大小是指为单个工作流实例处理的事件数,它可以同时包含多个队列事件。阈值将改写批大小;如果由于所有前端 Web 服务器上运行的实例过多而导致无法启动或重新启动工作流实例,则将不会获取任何事件,这与批大小无关。

WorkflowEventDeliveryTimeout

可选

System.Int32

指定工作流作业在不出现作业超时的情况下必须运行的时间(作为整数)。如果工作流作业超时,则会被放回到队列末尾以便再次运行。

例如,如果该值设置为 5,则工作流作业必须在 5 分钟内完成,否则工作流作业将超时。任何超时的工作流作业都将被放回到队列末尾以便再次运行。默认值为 5

WorkflowPostponeThreshold

可选

System.Int32

指定在将新工作流实例延迟到队列中之前的某一时间可在 IIS 中针对内容数据库运行的工作流的数目。

输入类型

返回类型

Example

---------------------示例--------------------------

$a = Get-SPFarmConfig

$a.AjaxTimeout = 200

$a | Set-SPFarmConfig

此示例使用 Get-SPFarmConfig cmdlet 将 Ajax Timeout 设置添加到 PSCustomObject 对象,设置 Ajax Timeout 的值,然后将 PSCustomObject 传给 Set-SPFarmConfig cmdlet 来更改 Ajax Timeout 设置。Ajax Timeout 是服务器场范围的设置,它是 SPWebService 对象的成员,不能使用 Windows PowerShell cmdlet 来访问它。

可以使用以下任一命令执行相同的操作。

Set-SPFarmConfig -AjaxTimeout 200

See Also

Reference

Get-SPFarmConfig