Skip to content

planner task add

Adds a new Microsoft Planner task

Usage

m365 planner task add [options]

Options

-t, --title <title>
Title of the task to add.
--planId [planId]
Plan ID to which the task belongs. Specify either planId or planName but not both.
--planName [planName]
Plan Name to which the task belongs. Specify either planId or planName but not both.
--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.
--bucketId [bucketId]
Bucket ID to which the task belongs. The bucket needs to exist in the selected plan. Specify either bucketId or bucketName but not both.
--bucketName [bucketName]
Bucket Name to which the task belongs. The bucket needs to exist in the selected plan. Specify either bucketId or bucketName but not both.
--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. - 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.
--assignedToUserIds [assignedToUserIds]
The comma-separated IDs of the assignees the task is assigned to. Specify either assignedToUserIds or assignedToUserNames but not both.
--assignedToUserNames [assignedToUserNames]
The comma-separated UPNs of the assignees the task is assigned to. 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. The format is defined as outlined here.
-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

Examples

Adds a Microsoft Planner task with the name My Planner Task for plan with the ID 8QZEH7b3wkSbGQobscsM5gADCBa and for the bucket with the ID IK8tuFTwQEa5vTonM7ZMRZgAKdna

m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna"

Adds a Completed Microsoft Planner task with the name My Planner Task for plan with the name My Planner Plan owned by group My Planner Group and for the bucket with the ID IK8tuFTwQEa5vTonM7ZMRZgAKdna

m365 planner task add --title "My Planner task" --planName "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100

Adds a Microsoft Planner task with the name My Planner Task for plan with the ID 8QZEH7b3wkbGQobscsM5gADCBa and for the bucket with the ID IK8tuFTwQEa5vTonM7ZMRZgAKdna. The new task will be assigned to the users Allan.Carroll@contoso.com and Ida.Stevens@contoso.com and receive a due date for 2021-12-16

m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --assignedToUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com" --dueDateTime "2021-12-16"