SPWordAutomationServiceApp

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
Name	Key	string	THe name of the service application
Ensure	Write	string	Present to ensure the app exists, absent to ensure that it does not	Present, Absent
ApplicationPool	Write	string	The name of the application pool to run the service app in
DatabaseName	Write	string	The name of the database for the service app
DatabaseServer	Write	string	The name of the server that will host the database
SupportedFileFormats	Write	string	The list of supported file types	docx, doc, mht, rtf, xml
DisableEmbeddedFonts	Write	boolean	Should embedded fonts be disabled
MaximumMemoryUsage	Write	uint32	What is the maximum amount of memory the service app should use (in MB)
RecycleThreshold	Write	uint32	What is the recycle threshold for this service app
DisableBinaryFileScan	Write	boolean	Should binary file scans be disabled
ConversionProcesses	Write	uint32	How many conversion processes can be run at once
JobConversionFrequency	Write	uint32	How frequently should new jobs be started from the queue (in minutes)
NumberOfConversionsPerProcess	Write	uint32	How many document conversions should be included in a single process
TimeBeforeConversionIsMonitored	Write	uint32	How long can a conversion be run before it becomes monitored
MaximumConversionAttempts	Write	uint32	What is the maximum number of attempts to convert a document
MaximumSyncConversionRequests	Write	uint32	What is the maximum number of sync conversion requests for the service app
KeepAliveTimeout	Write	uint32	How long is the keep alive timeout set to for the service app
MaximumConversionTime	Write	uint32	What is the maximum time in seconds for a document conversion to be allowed to run
InstallAccount	Write	string	POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsAccount if using PowerShell 5

Description

The resource is able to provision, unprovision and configure the Word Automation Service Application. All settings that you can configure on the Service Application administration page are configurable using this resource.

Important: When you specify Ensure=Present, the Application Pool and DatabaseName parameters are required. When you specify Ensure=Absent, no other parameters are allowed (with the exception of Name, InstallAccount or PsDscRunAsCredential).

Example

Make sure the service application exists and has a specific configuration

SPWordAutomationServiceApp Word Automation 
{ 
    Name = "Word Automation Service Application" 
    Ensure = "Present"
    ApplicationPool = "SharePoint Web Services"
    DatabaseName = "WordAutomation_DB"
    DatabaseServer = "SQLServer"
    SupportedFileFormats = "docx", "doc", "mht", "rtf", "xml"
    DisableEmbeddedFonts = $false
    MaximumMemoryUsage = 100
    RecycleThreshold = 100
    DisableBinaryFileScan = $false
    ConversionProcesses = 8
    JobConversionFrequency = 15                         (in minutes)
    NumberOfConversionsPerProcess = 12
    TimeBeforeConversionIsMonitored = 5                 (in minutes)
    MaximumConversionAttempts = 2
    MaximumSyncConversionRequests = 25 
    KeepAliveTimeout = 30                               (in seconds)
    MaximumConversionTime = 300                         (in seconds)
    PsDscRunAsCredential = $InstallAccount 
} 

Make sure the service application does not exist and remove when it does

SPWordAutomationServiceApp Word Automation 
{ 
    Name = "Word Automation Service Application" 
    Ensure = "Absent"
    PsDscRunAsCredential = $InstallAccount 
}