Skip to content

SPWorkManagementServiceApp

dscbot edited this page Mar 17, 2023 · 21 revisions

SPWorkManagementServiceApp

Parameters

Parameter Attribute DataType Description Allowed Values
Name Key String The name of the work management service application
ProxyName Write String The proxy name, if not specified will be /Name of service app/ Proxy
Ensure Write String Present to ensure the app exists, Absent to ensure it is removed Present, Absent
ApplicationPool Write String The name of the application pool this will run in
MinimumTimeBetweenEwsSyncSubscriptionSearches Write UInt32 The minimum amount of time bween EWS sync subscription searches
MinimumTimeBetweenProviderRefreshes Write UInt32 The minimum time between provider refreshes
MinimumTimeBetweenSearchQueries Write UInt32 The minimum time between search queries
NumberOfSubscriptionSyncsPerEwsSyncRun Write UInt32 The number of subscription syncronisations per EWS sync run
NumberOfUsersEwsSyncWillProcessAtOnce Write UInt32 How many users will EWS calls include at once
NumberOfUsersPerEwsSyncBatch Write UInt32 How many users are included in a batch for EWS

Description

Type: Distributed Requires CredSSP: No

This resource is used to provision and manage an instance of the Work Management Services Service Application. It will identify an instance of the work management service application through the application display name. Currently the resource will provision the app if it does not yet exist, and will change the application pool associated to the app if it does not match the configuration.

Remarks

  • Parameters MinimumTimeBetweenEwsSyncSubscriptionSearches, MinimumTimeBetweenProviderRefreshes, MinimumTimeBetweenSearchQueries are in minutes.

The default value for the Ensure parameter is Present. When not specifying this parameter, the service application is provisioned.

NOTE: You cannot use this resource with SharePoint 2016/2019, since the Work Management functionality has been removed in SharePoint 2016/2019. More information: https://docs.microsoft.com/en-us/SharePoint/what-s-new/what-s-deprecated-or-removed-from-sharepoint-server-2016

Examples

Example 1

This example creates a new work management service app in the local farm

Configuration Example
{
    param
    (
        [Parameter(Mandatory = $true)]
        [PSCredential]
        $SetupAccount
    )

    Import-DscResource -ModuleName SharePointDsc

    node localhost
    {
        SPWorkManagementServiceApp WorkManagementServiceApp
        {
            Name                                          = "Work Management Service Application"
            ApplicationPool                               = "SharePoint web services"
            MinimumTimeBetweenEwsSyncSubscriptionSearches = 10
            PsDscRunAsCredential                          = $SetupAccount
        }
    }
}
Clone this wiki locally