Skip to content

New command: planner plan set  #3346

@Jwaegebaert

Description

@Jwaegebaert

Usage

planner plan set

Description

Updates a Microsoft Planner plan

Options

Option Description
-i, --id [id] ID of the plan. Specify either id or title but not both.
-t, --title [title] Title of the plan. Specify either id or title but not both.
--ownerGroupId [ownerGroupId] ID of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using title.
--ownerGroupName [ownerGroupName] Name of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using title.
--newTitle [newTitle] New title of the plan.
--shareWithUserIds [shareWithUserIds] The comma-separated IDs of the users with whom you want to share the plan. Specify either shareWithUserIds or shareWithUserNames but not both.
--shareWithUserNames [shareWithUserNames] The comma-separated UPNs of the users with whom you want to share the plan. Specify either shareWithUserIds or shareWithUserNames but not both.

Unknown Options

Option Description
--category1 [category1] New label for a category. Define the category key within your option to update the related label. Category 1 to 25 available. e.g. --category4, --category12

In the docs section for this command, we'll reference the category options as unknown options in the remarks section. We'll need to validate the unknown options so that only category1-25 can actually be used.

Examples

Updates a Microsoft Planner plan title to New Title for the plan with id gndWOTSK60GfPQfiDDj43JgACDCb.

m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --newTitle 'New Title'

Share a Microsoft Planner plan with title Plan Title that is owned by the group My Group, with the users [email protected] and [email protected]

m365 planner plan set --title 'Plan Title' --ownerGroupName `My Group` --shareWithUserNames `[email protected],[email protected]`

Updates a Microsoft Planner plan category label with the key 21 to ToDo also the category label with the key 25 to Urgent. This for the plan with id gndWOTSK60GfPQfiDDj43JgACDCb.

m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --category25 'Urgent'

Additional Info

Graph docs:

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions