Parameter Attribute DataType Description Allowed Values
Alias Write String Alias of for the attachment.
Uri Write String Uri of the link to the attachment.
Type Write String Type of attachment. PowerPoint, Word, Excel, Other
Title Write String Title of the checklist item.
Completed Write String True if the item is completed, false otherwise.
PlanId Key String Id of the Planner Plan which contains the Task.
Title Key String The Title of the Planner Task.
Categories Write StringArray[] List of categories assigned to the task. Pink, Red, Yellow, Green, Blue, Purple
AssignedUsers Write StringArray[] List of users assigned to the tasks (ex: @('', '')).
Attachments Write InstanceArray[] List of links to attachments assigned to the task.
Checklist Write InstanceArray[] List checklist items associated with the task.
Notes Write String Description of the Task.
Bucket Write String The Id of the bucket that contains the task.
TaskId Write String Id of the Task, if known.
StartDateTime Write String Date and Time for the start of the Task.
DueDateTime Write String Date and Time for the task is due for completion.
PercentComplete Write UInt32 Percentage completed of the Task. Value can only be between 0 and 100.
Priority Write UInt32 Priority of the Task. Value can only be between 1 and 10.
ConversationThreadId Write String Id of the group conversation thread associated with the comments section for this task.
Ensure Write String Present ensures the Plan exists, absent ensures it is removed Present, Absent
Credential Required PSCredential Credentials of the account to authenticate with.



This resource is used to configure the Planner Tasks.

  • This resource deals with content. Using the Monitoring feature of Microsoft365DSC on content resources is not recommended.


Example 1

This example creates a new Planner Task in a Plan.

Configuration Example
    Import-DscResource -ModuleName Microsoft365DSC

    node localhost
        PlannerTask 'ContosoPlannerTask'
            PlanId                = "1234567890"
            Title                 = "Contoso Task"
            StartDateTime         = "2020-06-09"
            Priority              = 7
            PercentComplete       = 75
            Ensure                = "Present"
            ApplicationId         = "12345-12345-12345-12345-12345"
            TenantId              = "12345-12345-12345-12345-12345"
            CertificateThumbprint = "1234567890"