SPWorkflowService - dsccommunity/SharePointDsc GitHub Wiki

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
SPSiteUrl	Key	String	The URL of the Site Collection to associate with the Workflow Service Proxy
WorkflowHostUri	Key	String	The URL of the Workflow Service
AllowOAuthHttp	Write	Boolean	Specify whether or not to allow connection to the Workflow Service over Http
ScopeName	Write	String	Specify scope name. If not specified SharePoint will use the default scope name 'SharePoint'

Description

Type: Distributed Requires CredSSP: No

This resource is used to register the SharePoint Server against a Workflow Manager Instance.

Requirements: Provide the url of the Workflow Manager instance to connect to. Scope name is optional and defaults to SharePoint. If scope name is not specified any configured scope name is allowed by this resource.

Remarks

Change or configuration drift for AllowOAuthHttp is not detected by this resource.

Examples

Example 1

This example registers the workflow service over http.

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

    Import-DscResource -ModuleName SharePointDsc

    node localhost
    {
        SPWorkflowService WorkflowService
        {
            WorkflowHostUri      = "http://workflow.sharepoint.contoso.com"
            SPSiteUrl            = "http://sites.sharepoint.com"
            AllowOAuthHttp       = $true
            PsDscRunAsCredential = $SetupAccount
        }
    }
}

Example 2

This example registers the workflow service specifying a custom scope name.

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

    Import-DscResource -ModuleName SharePointDsc

    node localhost
    {
        SPWorkflowService WorkflowService
        {
            WorkflowHostUri      = "http://workflow.sharepoint.contoso.com"
            ScopeName            = "SharePointWorkflow"
            SPSiteUrl            = "http://sites.sharepoint.com"
            AllowOAuthHttp       = $true
            PsDscRunAsCredential = $SetupAccount
        }
    }
}