Skip to main content

planner roster remove

Removes a Microsoft Planner Roster


m365 planner roster remove [options]


--id <id>

ID of the Planner Roster.

-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, response, full. Default is options.

--query [query]

JMESPath query string. See for more information and examples.

-o, --output [output]

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


Runs command with verbose logging.


Runs command with debug logging.



Deleting a Planner Roster will also delete the plan within the Roster.


This command is based on an API that is currently in preview and is subject to change once the API reached general availability.


Removes a Planner Roster

m365 planner roster remove --id 8bc07d47-c06f-41e1-8f00-1c113c8f6067

Removes a Planner Roster without confirmation prompt

m365 planner roster remove --id 8bc07d47-c06f-41e1-8f00-1c113c8f6067 --force


The command won't return a response on success.

More information

Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.