Set-SPPerformancePointServiceApplication

Sets global runtime properties for a PerformancePoint Services application.

Syntax

Set-SPPerformancePointServiceApplication
   [-Identity] <SPPerformancePointMonitoringServiceApplicationPipeBind>
   [-AnalyticQueryCellMax <Int32>]
   [-AnalyticQueryLoggingEnabled <Boolean>]
   [-ApplicationCacheEnabled <Boolean>]
   [-ApplicationCacheMinimumHitCount <Int32>]
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-ApplicationProxyCacheEnabled <Boolean>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CommentsDisabled <Boolean>]
   [-CommentsScorecardMax <Int32>]
   [-Confirm]
   [-DatabaseFailoverServer <String>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-DatabaseSQLAuthenticationCredential <PSCredential>]
   [-DataSourceQueryTimeoutSeconds <Int32>]
   [-DecompositionTreeMaximum <Int32>]
   [-ElementCacheSeconds <Int32>]
   [-FilterRememberUserSelectionsDays <Int32>]
   [-FilterTreeMembersMax <Int32>]
   [-IndicatorImageCacheSeconds <Int32>]
   [-MSMQEnabled <Boolean>]
   [-MSMQName <String>]
   [-SelectMeasureMaximum <Int32>]
   [-SessionHistoryHours <Int32>]
   [-SettingsDatabase <String>]
   [-ShowDetailsInitialRows <Int32>]
   [-ShowDetailsMaxRows <Int32>]
   [-ShowDetailsMaxRowsDisabled <Boolean>]
   [-TrustedContentLocationsRestricted <Boolean>]
   [-TrustedDataSourceLocationsRestricted <Boolean>]
   [-WhatIf]
   [-AnalyticResultCacheMinimumHitCount <Int32>]
   [-DatabaseUseWindowsAuthentication <Boolean>]
   [-DataSourceUnattendedServiceAccountTargetApplication <String>]
   [-FilterSearchResultsMax <Int32>]
   [-UseEffectiveUserName <Boolean>]
   [<CommonParameters>]

Description

The Set-SPPerformancePointServiceApplication cmdlet updates global runtime properties for a PerformancePoint Service application. The changes made to properties by using this cmdlet affect all servers in the farm that run the instance of the specified PerformancePoint Service application.

For permissions and the most current information about Windows PowerShell for SharePoint Products, see the online documentation at http://go.microsoft.com/fwlink/p/?LinkId=251831 (http://go.microsoft.com/fwlink/p/?LinkId=251831).

Examples

----------------EXAMPLE----------------------

C:\PS>Set-SPPerformancePointServiceApplication -Identity PPSApp_01 -DataSourceQueryTimeoutSeconds 5000

This example sets the Data Source Query Timeout setting to a value of 5000. This cmdlet is equivalent to the PerformancePoint Service Settings page on the SharePoint Central Administration Web site.

Required Parameters

-Identity

Specifies the PerformancePoint Service application to update.

The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid name of a PerformancePoint Service application (for example, PerfPointApp1); or an instance of a valid SPPerformancePointMonitoringServiceApplication object.

Type:SPPerformancePointMonitoringServiceApplicationPipeBind
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016

Optional Parameters

-AnalyticQueryCellMax

Specifies the maximum number of returned cells in an analytic grid.

A valid integer between 1-1,000,000,000. The default value is 100,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-AnalyticQueryLoggingEnabled

Turns on verbose logging of query events.

The type must be one of the following: True, False. The default value is False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-AnalyticResultCacheMinimumHitCount

{{Fill AnalyticResultCacheMinimumHitCount Description}}

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ApplicationCacheEnabled

Specifies whether rendered output cache on the application server is on (True) or off (False). The default value is True.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ApplicationCacheMinimumHitCount

Specifies the minimum number of times rendered output must be requested before it is added to cache. The default value is 2.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ApplicationPool

Specifies the existing IIS application pool to run the Web service in for the service application.

The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid name of an application pool (for example, AppPoolName1); or an instance of a valid IISWebServiceApplicationPool object.

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ApplicationProxyCacheEnabled

Specifies rendered output cache on the web front end. The default value is True.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-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
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-CommentsDisabled

Specifies that users can add comments to scorecard cells.

The type must be one of the following: $True, $False. The default value is $False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-CommentsScorecardMax

Specifies the maximum number of comments that can be added to a scorecard. The default value is 1000.

The type must be an integer value in the range of 1 to 1,000,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DataSourceQueryTimeoutSeconds

Specifies the time, in seconds, before a data source query times out. The default value is 300.

The type must be an integer value in the range of 1 to 36,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DataSourceUnattendedServiceAccountTargetApplication

{{Fill DataSourceUnattendedServiceAccountTargetApplication Description}}

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DatabaseFailoverServer

Specifies the name of the database server that contains the PerformancePoint Services database that must be mirrored.

This parameter was introduced in SharePoint Server with Service Pack 1 (SP1) and SharePoint Foundation 2010 with Service Pack 1 (SP1).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DatabaseName

Specifies the name of the PerformancePoint Services database that will be created when the service application is provisioned.

This parameter was introduced in SharePoint Server with Service Pack 1 (SP1) and SharePoint Foundation 2010 with Service Pack 1 (SP1).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DatabaseSQLAuthenticationCredential

Determines whether to use Windows authentication or SQL Server authentication when connecting to a PerformancePoint Services database.

This parameter was introduced in SharePoint Server with Service Pack 1 (SP1) and SharePoint Foundation with Service Pack 1 (SP1).

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DatabaseServer

Specifies the name of the database server where the PerformancePoint Services database will be created. This should be the same server name that is used for the SharePoint content and configuration databases.

The value may be written as SQL instance\server if it is not referring to the default instance.

This parameter was introduced in SharePoint Server with Service Pack 1 (SP1) and SharePoint Foundation with Service Pack 1 (SP1).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DatabaseUseWindowsAuthentication

{{Fill DatabaseUseWindowsAuthentication Description}}

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-DecompositionTreeMaximum

Specifies the maximum number of items (per level) returned to the decomposition tree visualization.

A valid integer value between 1-1,000,000. The default value is 25.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ElementCacheSeconds

Specifies the first class object cache expiration time. The default value is 15.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-FilterRememberUserSelectionsDays

Specifies the number of days that user filter selections are remembered. The default value is 90.

The type must be an integer value in the range of 1 to 10,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-FilterSearchResultsMax

{{Fill FilterSearchResultsMax Description}}

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-FilterTreeMembersMax

The maximum number of records to show in filter treeview control. The default value is 500.

An integer value in the range of 1 to 100,000

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-IndicatorImageCacheSeconds

Specifies the time, in seconds, that key performance indicator (KPI) icons are cached. The default value is 10.

The type must be an integer value in the range of 1 to 3600.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-MSMQEnabled

Specifies that notifications are sent to Microsoft Message Queuing (MSMQ) on content change.

The type must be one of the following: True, False. The default value is False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-MSMQName

Specifies the name of the queue. The queue name can contain a maximum of 380 characters and cannot contain the following characters: CR (ASCII 13), LF (ASCII 10), backslash (\), plus sign (+), comma (,), or quotation marks ("").

The type must be a valid MSMQ name; for example, MessageQueue1.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-SelectMeasureMaximum

Specifies the maximum number of measures to show in a dashboard Select Measure control. The default value is 1000.

The type must be an integer value in the range of 1 to 1,000,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-SessionHistoryHours

Specifies the number of hours between clearing of expired user navigation history. The default value is 2.

The type must be an integer value in the range of 1 to 48.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-SettingsDatabase

Specifies the name of the PerformancePoint Service database used for that service application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ShowDetailsInitialRows

Specifies the initial number of rows to retrieve for show details. The default value is 1000.

The type must be an integer value in the range of 1 to 100,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ShowDetailsMaxRows

Specifies the maximum number of rows to retrieve for show details.

The type must be an integer value in the range of 1 to 1,000,000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-ShowDetailsMaxRowsDisabled

Turns off the ShowDetailsInitialRows setting. If set to true, Analysis Services controls limit.

The type must be one of the following: True, False. The default value is False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-TrustedContentLocationsRestricted

Specifies that only specified locations are trusted. The default setting is false (trust all content locations).

The type must be one of the following: True, False. The default value is False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-TrustedDataSourceLocationsRestricted

Specify to trust only specified data source locations. The default is to trust all data source locations.

The type must be one of the following: True, False. The default value is False.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-UseEffectiveUserName

{{Fill UseEffectiveUserName Description}}

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016