New-SPPerformancePointServiceApplication
Updated: September 13, 2011
Creates a new service application for the PerformancePoint Service.
New-SPPerformancePointServiceApplication [-Name] <String> -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AnalyticQueryCellMax <Int32>] [-AnalyticQueryLoggingEnabled <$true | $false>] [-AnalyticResultCacheMinimumHitCount <Int32>] [-ApplicationCacheEnabled <$true | $false>] [-ApplicationCacheMinimumHitCount <Int32>] [-ApplicationProxyCacheEnabled <$true | $false>] [-AssignmentCollection <SPAssignmentCollection>] [-CommentsDisabled <$true | $false>] [-CommentsScorecardMax <Int32>] [-Confirm [<SwitchParameter>]] [-DatabaseFailoverServer <String>] [-DatabaseName <String>] [-DatabaseServer <String>] [-DatabaseSQLAuthenticationCredential <PSCredential>] [-DataSourceQueryTimeoutSeconds <Int32>] [-DecompositionTreeMaximum <Int32>] [-ElementCacheSeconds <Int32>] [-FilterRememberUserSelectionsDays <Int32>] [-FilterTreeMembersMax <Int32>] [-IndicatorImageCacheSeconds <Int32>] [-MSMQEnabled <$true | $false>] [-MSMQName <String>] [-SelectMeasureMaximum <Int32>] [-SessionHistoryHours <Int32>] [-ShowDetailsInitialRows <Int32>] [-ShowDetailsMaxRows <Int32>] [-ShowDetailsMaxRowsDisabled <$true | $false>] [-TrustedContentLocationsRestricted <$true | $false>] [-TrustedDataSourceLocationsRestricted <$true | $false>] [-WhatIf [<SwitchParameter>]]
Parameters
| Parameter | Required | Type | Description | ||
|---|---|---|---|---|---|
|
Name |
Required |
System.String |
Specifies the name of the new PerformancePoint Service application. The type must be a valid name of a PerformancePoint Service application; for example, PerfPointApp1. |
||
|
ApplicationPool |
Optional |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
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. |
||
|
AnalyticQueryCellMax |
Optional |
System.Int32 |
Specifies the maximum number of returned cells in an analytic grid. A valid integer value from 1 through 1,000,000,000. The default value is 100,000. |
||
|
AnalyticQueryLoggingEnabled |
Optional |
System.Nullable |
Turns on verbose logging of query events. The type must be one of the following: True or False. The default value is False. |
||
|
ApplicationCacheEnabled |
Optional |
System.Nullable |
Specifies whether the rendered output cache on the application server is on (True) or off (False). The default value is True. |
||
|
ApplicationCacheMinimumHitCount |
Optional |
System.Nullable |
Specifies the minimum number of times rendered output must be requested before it is added to cache. The default value is 2. |
||
|
ApplicationProxyCacheEnabled |
Optional |
System.Nullable |
Specifies rendered output cache on the front end Web server. The default value is True. |
||
|
AssignmentCollection |
Optional |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
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.
|
||
|
CommentsDisabled |
Optional |
System.Nullable |
Specifies that users can add comments to scorecard cells. The type must be one of the following: true or false. |
||
|
CommentsScorecardMax |
Optional |
System.Nullable |
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 from 1 through 1,000,000. |
||
|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters |
||
|
DatabaseFailoverServer |
Optional |
System.String |
Specifies the name of the database server that contains the PerformancePoint Services database that must be mirrored. This parameter was introduced in Microsoft SharePoint Server 2010 with Service Pack 1 (SP1) and Microsoft SharePoint Foundation 2010 with Service Pack 1 (SP1). |
||
|
DatabaseName |
Optional |
System.String |
Specifies the name of the PerformancePoint Services database that will be created when the service application is provisioned. This parameter was introduced in Microsoft SharePoint Server 2010 with Service Pack 1 (SP1) and Microsoft SharePoint Foundation 2010 with Service Pack 1 (SP1). |
||
|
DatabaseServer |
Optional |
System.String |
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 Microsoft SharePoint Server 2010 with Service Pack 1 (SP1) and Microsoft SharePoint Foundation 2010 with Service Pack 1 (SP1). |
||
|
DatabaseSQLAuthenticationCredential |
Optional |
System.Management.Automation.PSCredential |
Determines whether to use Windows authentication or SQL Server authentication when connecting to a PerformancePoint Services database. This parameter was introduced in Microsoft SharePoint Server 2010 with Service Pack 1 (SP1) and Microsoft SharePoint Foundation 2010 with Service Pack 1 (SP1). |
||
|
DataSourceQueryTimeoutSeconds |
Optional |
System.Nullable |
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. |
||
|
DecompositionTreeMaximum |
Optional |
System.Nullable |
Specifies the maximum number of items (per level) returned to the decomposition tree visualization. A valid integer value from 1 through 1,000,000. The default value is 25. |
||
|
ElementCacheSeconds |
Optional |
System.Int32 |
Specifies the first class object cache expiration time. The default value is 15. |
||
|
FilterRememberUserSelectionsDays |
Optional |
System.Nullable |
Specifies the number of days that user filter selections are remembered. The default value is 90. The type must be an integer value from 1 through 10,000. |
||
|
FilterTreeMembersMax |
Optional |
System.Nullable |
Specifies the maximum number of records to show in filter treeview control. The default value is 500. The type must be an integer value from 1 through 100,000. |
||
|
IndicatorImageCacheSeconds |
Optional |
System.Nullable |
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 from 1 through 3,600. |
||
|
MSMQEnabled |
Optional |
System.Nullable |
Specifies that notifications are sent to Microsoft Message Queuing (MSMQ) on content change. The type must be one of the following: true or false. The default value is False. |
||
|
MSMQName |
Optional |
System.String |
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. |
||
|
SelectMeasureMaximum |
Optional |
System.Nullable |
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 from 1 through 1,000,000. |
||
|
SessionHistoryHours |
Optional |
System.Nullable |
Specifies the number of hours between clearing expired user navigation history. The default value is 2. The type must be an integer value from 1 through 48. |
||
|
ShowDetailsInitialRows |
Optional |
System.Nullable |
Specifies the initial number of rows to retrieve for show details. The default value is 1,000. The type must be an integer value from 1 through 100,000. |
||
|
ShowDetailsMaxRows |
Optional |
System.Nullable |
Specifies the maximum number of rows to retrieve for show details. The type must be an integer value from 1 through 1,000,000. The default value is 10,000. |
||
|
ShowDetailsMaxRowsDisabled |
Optional |
System.Nullable |
Turns off the ShowDetailsInitialRows setting. If set to True, Analysis Services controls limit. The type must be one of the following: True or False. The default value is False. |
||
|
TrustedContentLocationsRestricted |
Optional |
System.Nullable |
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 or False. The default value is False. |
||
|
TrustedDataSourceLocationsRestricted |
Optional |
System.Nullable |
Specifies that only specified locations are trusted. The default setting is false (trust all data source locations). The type must be one of the following: True or False. The default value is False. |
||
|
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
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 |
Detailed Description
The New-SPPerformancePointServiceApplication cmdlet creates a new PerformancePoint Service on the farm.
Input Types
Return Types
-----------------EXAMPLE------------------------
New-SPPerformancePointServiceApplication -Name PPS_Application_01 -ApplicationPool PPS_Application_Pool_01
This example creates a new PerformancePoint Service application named PPSApp_01 and sets it to run under an application pool named PPS_Application_Pool_01.
Change History
| Date | Description | Reason |
|---|---|---|
|
September 13, 2011 |
Added the following parameters: DatabaseFailoverServer, DatabaseName, DatabaseServer, DatabaseSQLAuthenticationCredential. |
Content update |
|
May 12, 2010 |
Initial publication |
|
Note: