Set-SPPowerPointConversionServiceApplication

Configures settings for a PowerPoint Conversion Service application.

Syntax

Set-SPPowerPointConversionServiceApplication
   [-Identity] <SPPowerPointConversionServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CacheExpirationPeriodInSeconds <UInt32>]
   [-MaximumConversionsPerWorker <UInt32>]
   [-WorkerKeepAliveTimeoutInSeconds <UInt32>]
   [-WorkerProcessCount <UInt32>]
   [-WorkerTimeoutInSeconds <UInt32>]
   [<CommonParameters>]

Description

Use the Set-SPPowerPointConversionServiceApplication cmdlet to set properties and settings for an instance of a PowerPoint Conversion Service application that is in a farm.

Examples

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

Set-SPPowerPointConversionServiceApplication -Identity "MyWorkgroupPPTApp" -CacheExpirationPeriodInSeconds 1200

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

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

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

This example disables binary scanning of documents.

Parameters

-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 2013, SharePoint Server 2016, SharePoint Server 2019

-CacheExpirationPeriodInSeconds

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifies the unique name of this PowerPoint Conversion Service application.

Type:SPPowerPointConversionServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionsPerWorker

Specifies the maximum number of presentations that a conversion worker process can convert before recycling. The default value is 5.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WorkerKeepAliveTimeoutInSeconds

Specifies the maximum time, in seconds, that a conversion worker process can be unresponsive before being terminated. The default value is 120 seconds.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WorkerProcessCount

Specifies the number of active instances of the conversion worker process on each back-end. This value must be less than the Windows Communication Foundation (WCF) connection limit for this computer. The default value is 3.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WorkerTimeoutInSeconds

Specifies the maximum time, in seconds, that a conversion worker process is given for any single conversion. The default is 300 seconds (5 minutes).

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019