New command: planner roster add #4389

Usage

m365 planner roster add [options]

Description

Creates a new Microsoft Planner Roster

Options

None!

Examples

Create a new Planner Roster

m365 planner roster add

Default properties

No response

Additional Info

API request: https://learn.microsoft.com/en-us/graph/api/planner-post-rosters?view=graph-rest-beta&tabs=http

Let's also add this to the docs:

• Attention: The Roster will be automatically deleted when it doesn't contain a plan 24 hours after its creation. Membership information will be completely erased within 30 days of this deletion.
• Attention: This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
• Important: To be able to create a new Roster, the Planner Roster creation tenant setting should be enabled. Point them to our planner tenant settings list command.
• Additional info: 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.