import Global from '../../_global.mdx'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
Removes the Microsoft Planner plan
m365 planner plan remove [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.If you wish to delete a Planner plan contained within a Planner Roster, you'll have to remove the roster using planner roster remove.
| Resource | Permissions |
|---|---|
| Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
| Resource | Permissions |
|---|---|
| Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
Removes the Microsoft Planner plan by ID
m365 planner plan remove --id gndWOTSK60GfPQfiDDj43JgACDCbRemoves 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-000000000000Removes 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" --forceThe command won't return a response on success.