Set-SPFarmConfig
Sets a global property or a collection of global properties for the local farm.
Syntax
Set-SPFarmConfig
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-DataFormWebPartAutoRefreshEnabled <Boolean>]
[-Force]
[-InstalledProductsRefresh]
[-ServiceConnectionPointBindingInformation <String>]
[-ServiceConnectionPointDelete]
[-WhatIf]
[-WorkflowBatchSize <Int32>]
[-WorkflowEventDeliveryTimeout <Int32>]
[-WorkflowPostponeThreshold <Int32>]
[-ASPScriptOptimizationEnabled <Boolean>]
[-UserAccountDirectoryPathIsImmutable]
[-DefaultActivateOnSiteMasterValue <Boolean>]
[-MaxSiteSubscriptionSettingsValueLength <UInt32>]
[-MaxTenantStoreValueLength <UInt32>]
[-SiteMasterMode <SPSiteMasterMode>]
[-SiteMasterValidationIntervalInHours <UInt32>]
[<CommonParameters>] Description
The Set-SPFarmConfig cmdlet updates a collection of global settings for the local farm that are not members of the SPFarm object.
Use the Get-SPFarmConfig cmdlet to read global settings for the local farm and to create a new PSCustomObject object from the collection of properties returned from the local farm and then add this object to the pipeline.
Modify the PSCustomObject object and pass it to the Set-SPFarmConfig cmdlet to change the parameter values.
The properties collected in the PSCustomObject object must be farm-wide settings and must be configurable only once for the entire farm.
The parameter name added to the PSCustomObject object must match exactly the input parameter name for the Set-SPFarmConfig cmdlet.
For permissions and the most current information about Windows PowerShell for SharePoint Products, see the online documentation at SharePoint Server Cmdlets.
Examples
---------------------EXAMPLE--------------------------
Set-SPFarmConfig -WorkflowBatchSize 50This example sets the WorkflowBatdhSize to 50.
Parameters
-ASPScriptOptimizationEnabled
Specifies if ASP Script optimization is enabled. The default value is false (off).
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.
When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
Prompts you for confirmation before executing the command.
For more information, type the following command: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DataFormWebPartAutoRefreshEnabled
Specifies whether any DataFormWebPart on any page in this farm is allowed to periodically refresh its contents asynchronously (after the page has finished rendering).
When set to false, all DataFormWebParts will ignore the automatic refresh interval provided in Web Part properties.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DefaultActivateOnSiteMasterValue
Specifies whether to activate site master as default.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
Forces the deletion or updating of the service connection point.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-InstalledProductsRefresh
Updates the current machine license state with the list of products that are installed in the farm.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-MaxSiteSubscriptionSettingsValueLength
Sets the maximum size of a SiteSubscription property value.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-MaxTenantStoreValueLength
Sets the maximum size of a Tenant Store property value.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServiceConnectionPointBindingInformation
Adds or updates the service connection point for the current farm in Active Directory Domain Service (AD DS).
The type must be an array of strings that are key value pairs that will be added to the service connection point.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServiceConnectionPointDelete
Delete the service connection point for the current farm in AD DS.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SiteMasterMode
Specifies if site master mode is turned on or off. The default value is off.
| Type: | SPSiteMasterMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SiteMasterValidationIntervalInHours
Determines the length of time, in hours, to validate the Site Master.
The default value is 24.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UserAccountDirectoryPathIsImmutable
Specifies if the UserAccountDirectoryPath property on an SPSite object is immutable.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Displays a message that describes the effect of the command instead of executing the command.
For more information, type the following command: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WorkflowBatchSize
Specifies the paging size for events delivered to a single workflow instance.
For each request, the events are streamed out 100 at a time.
Batch size is the number of events processed for a single workflow instance, which can have many events queued at the same time. Throttle will override batch size; if the workflow instance cannot be started or restarted because there are too many instances running across all front-end Web servers, none of the events will be fetched, regardless of the batch size.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WorkflowEventDeliveryTimeout
Specifies the time as an integer in which a workflow job must run without the job timing out.
If the workflow job does time out, it gets put back in the queue to be run again.
For example, if the value is set to 5, the workflow job must run within 5 minutes are the workflow job will time out. Any workflow job that does time out is placed back in the queue to run again.The default value is 5.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WorkflowPostponeThreshold
Specifies the number of workflows that can be running in IIS against a content database at a time before new workflow instances get postponed into a queue.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |