planner plan remove

Removes the Microsoft Planner plan

Usage

m365 planner plan remove [options]

Options

-i, --id [id]

ID of the plan to remove. Specify either id or title but not both.

-t, --title [title]

Title of the plan to remove. Specify either id or title but not both.

--ownerGroupId [ownerGroupId]

ID of the Group that owns the plan. Specify either ownerGroupId or ownerGroupName when using title.

--ownerGroupName [ownerGroupName]

Name of the Group that owns the plan. Specify either ownerGroupId or ownerGroupName when using title.

-f, --force

Don't prompt for confirmation.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks

If you wish to delete a Planner plan contained within a Planner Roster, you'll have to remove the roster using planner roster remove.

Permissions

Delegated

Resource	Permissions
Microsoft Graph	Tasks.ReadWrite, GroupMember.Read.All

Application

Resource	Permissions
Microsoft Graph	Tasks.ReadWrite.All, GroupMember.Read.All

Examples

Removes the Microsoft Planner plan by ID

m365 planner plan remove --id gndWOTSK60GfPQfiDDj43JgACDCb

Removes the Microsoft Planner plan with title My Plan in group with specific ID

m365 planner plan remove --title "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000

Removes the Microsoft Planner plan with title My Plan in group with name My Planner Group without confirmation prompt

m365 planner plan remove --title "My Plan" --ownerGroupName "My Planner Group" --force

Response

The command won't return a response on success.