Set-SPPowerPointServiceApplication

 

Applies to: SharePoint Server 2010

Topic Last Modified: 2010-02-11

Banner stating end of support date for Office 2010 with link to more info

Configures global settings for a PowerPoint Service application.

Syntax

Set-SPPowerPointServiceApplication [-Identity] <SPPowerPointServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-BroadcastStateIdleTimeoutInSeconds <UInt32>] [-BroadcastStateSessionTimeoutInSeconds <UInt32>] [-DisableBinaryScan <$true | $false>] [-EditingWorkerProcessCount <UInt32>] [-EditingWorkerTimeoutInSeconds <UInt32>] [-EnableSandboxedEditing <$true | $false>] [-EnableSandboxedViewing <$true | $false>] [-EnableViewing97To2003Formats <$true | $false>] [-EnableViewingOpenXmlFormats <$true | $false>] [-ViewingCacheExpirationPeriodInSeconds <UInt32>] [-ViewingMaximumConversionsPerWorker <UInt32>] [-ViewingWorkerKeepAliveTimeoutInSeconds <UInt32>] [-ViewingWorkerProcessCount <UInt32>] [-ViewingWorkerTimeoutInSeconds <UInt32>]

Detailed Description

The Set-SPPowerPointServiceApplication cmdlet sets global properties and settings for an instance of a PowerPoint Service application that is in a farm.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Office.Server.Powerpoint.SharePoint.PowerShell.SPPowerPointServiceApplicationPipeBind

Specifies the unique name of this PowerPoint Service application.

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.

Note

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.

BroadcastStateIdleTimeoutInSeconds

Optional

System.UInt32

Specifies the maximum total time, in seconds, that a broadcast connection is allowed to be idle before being automatically disconnected. The default value is 5400 seconds (90 minutes).

BroadcastStateSessionTimeoutInSeconds

Optional

System.UInt32

Specifies the maximum total time, in seconds, that a broadcast session is allowed to be active before being automatically disconnected. Set this parameter to the same value as BroadcastSessionTimeoutInSeconds. The default value is 43200 seconds (12 hours).

DisableBinaryScan

Optional

System.Boolean

Specifies if binary files are scanned by using the GateKeeper - Validator feature before a Microsoft PowerPoint file is opened. The default value is $True.

EditingWorkerProcessCount

Optional

System.UInt32

Specifies the number of active instances of the named application. This value must be less than the Windows Communication Foundation (WCF) connection limit for this computer. The default value is 100.

EditingWorkerTimeoutInSeconds

Optional

System.UInt32

Specifies the time-out in seconds that the editing service is given for a request sent to the editing service. The default value is 60 seconds.

EnableSandboxedEditing

Optional

System.Boolean

Specifies if the Microsoft PowerPoint Web App editing code should run in a sandboxed (low-permission mode) environment. The default value is $True.

EnableSandboxedViewing

Optional

System.Boolean

Specifies if the Microsoft PowerPoint Web App viewing code should run in a sandboxed (low-permission mode) environment. The default value is $True.

EnableViewing97To2003Formats

Optional

System.Boolean

Specifies if the Microsoft PowerPoint Web App can open presentation (*.ppt) files written in Office PowerPoint 1997 to 2003 versions. If this parameter is disabled, the PowerPoint Web App is prevented from viewing that file type. The default value is $True.

EnableViewingOpenXmlFormats

Optional

System.Boolean

Specifies if the Microsoft PowerPoint Web App can open Office Open XML files (*.pptx) in PowerPoint. If this parameter is disabled, the PowerPoint Web App is prevented from viewing that file type. The default value is $True.

ViewingCacheExpirationPeriodInSeconds

Optional

System.UInt32

Specifies the maximum time, in seconds, that items are kept in the back-end server cache. The default value is 600 seconds (10 minutes).

ViewingMaximumConversionsPerWorker

Optional

System.UInt32

Specifies the number of conversion jobs that a given instance of the worker process is allowed to convert before recycling. The default value is 5.

ViewingWorkerKeepAliveTimeoutInSeconds

Optional

System.UInt32

Specifies the time-out in seconds, for the keep alive signal interval between the start and end of a process on the viewing back-end. The default value is 120 seconds.

ViewingWorkerProcessCount

Optional

System.UInt32

Specifies the number of active instances of the named application. This value must be less than the Windows Communication Foundation (WCF) connection limit for this computer. The default value is 3.

ViewingWorkerTimeoutInSeconds

Optional

System.UInt32

Specifies the time-out in seconds that the viewing service is given for any job submitted by the application manager. The default is 300 seconds (5 minutes).

Input Types

Return Types

Example

---------------------EXAMPLE 1-------------------

Set-SPPowerPointServiceApplication -Identity "MyWorkgroupPPTApp" -ViewingCacheExpirationPeriodInSeconds 1200

This example establishes new operational defaults for the viewing cache expiration.

---------------------EXAMPLE 2-------------------

Set-SPPowerPointServiceApplication -Identity "MyWorkgroupPPTApp" -DisableBinaryScan:$false

This example disables binary scanning of documents.