Skip to content

planner task set

Updates a Microsoft Planner task

Usage

m365 planner task set [options]

Options

-i, --id <id>
ID of the task.
-t, --title [title]
New title of the task.
--bucketId [bucketId]
ID of the bucket to move the task to. Specify either bucketId or bucketName but not both.
--bucketName [bucketName]
Name of the bucket to move the task to. The bucket needs to exist in the selected plan. Specify either bucketId or bucketName but not both.
--planId [planId]
ID of the plan to which the bucket belongs to. Specify either planId or planName when using bucketName.
--planName [planName]
Name of the plan to which the bucket belongs to. Specify either planId or planName when using bucketName.
--ownerGroupId [ownerGroupId]
ID of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using planName.
--ownerGroupName [ownerGroupName]
Name of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using planName.
--startDateTime [startDateTime]
The date and time when the task started. This should be defined as a valid ISO 8601 string. 2021-12-16T18:28:48.6964197Z
--dueDateTime [dueDateTime]
The date and time when the task is due. This should be defined as a valid ISO 8601 string. 2021-12-16T18:28:48.6964197Z
--percentComplete [percentComplete]
Percentage of task completion. Number between 0 and 100.
--assignedToUserIds [assignedToUserIds]
Comma-separated IDs of the assignees that should be added to the task assignment. Specify either assignedToUserIds or assignedToUserNames but not both.
--assignedToUserNames [assignedToUserNames]
Comma-separated UPNs of the assignees that should be added to the task assignment. Specify either assignedToUserIds or assignedToUserNames but not both.
--description [description]
Description of the task
--orderHint [orderHint]
Hint used to order items of this type in a list view
--assigneePriority [assigneePriority]
Hint used to order items of this type in a list view
--appliedCategories [appliedCategories]
Comma-separated categories that should be added to the task
-h, --help
output usage information
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

When you specify the value for percentageComplete, consider the following:

  • when set to 0, the task is considered Not started
  • when set between 1 and 99, the task is considered In progress
  • when set to 100, the task is considered Completed

You can add up to 6 categories to the task. An example to add category1 and category3 would be category1,category3.

Examples

Updates a Microsoft Planner task name to My Planner Task for the task with the ID Z-RLQGfppU6H3663DBzfs5gAMD3o

m365 planner task set --id "Z-RLQGfppU6H3663DBzfs5gAMD3o" --title "My Planner Task"

Moves a Microsoft Planner task with the ID Z-RLQGfppU6H3663DBzfs5gAMD3o to the bucket named My Planner Bucket. Based on the plan with the name My Planner Plan owned by the group My Planner Group

m365 planner task set  --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --bucketName "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"

Marks a Microsoft Planner task with the ID Z-RLQGfppU6H3663DBzfs5gAMD3o as 50% complete and assigned to categories 1 and 3.

m365 planner task set --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"  --percentComplete 50 --appliedCategories "category1,category3"

Additional information