Edit

Share via


Set-SPPowerPointConversionServiceApplication

Configures settings for a PowerPoint Conversion Service application.

Syntax

Default (Default)

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

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Parameter properties

Type:SPAssignmentCollection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-CacheExpirationPeriodInSeconds

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifies the unique name of this PowerPoint Conversion Service application.

Parameter properties

Type:SPPowerPointConversionServiceApplicationPipeBind
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-MaximumConversionsPerWorker

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WorkerKeepAliveTimeoutInSeconds

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WorkerProcessCount

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WorkerTimeoutInSeconds

Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.