planner bucket remove

Removes the Microsoft Planner bucket from a plan

Usage

m365 planner bucket remove [options]

Options

-i, --id [id]

ID of the bucket to remove. Specify either id or name but not both.

-n, --name [name]

Name of the bucket to remove. Specify either id or name but not both.

--planId [planId]

ID of the plan to which the bucket to remove belongs. Specify either planId, planTitle, or rosterId but not multiple when using name.

--planTitle [planTitle]

Title of the plan to which the bucket to remove belongs. Specify either planId, planTitle, or rosterId but not multiple when using name.

--rosterId [rosterId]

ID of the Planner Roster. Specify either planId, planTitle, or rosterId but not multiple when using name.

--ownerGroupId [ownerGroupId]

ID of the group to which the plan belongs. Specify either ownerGroupId or ownerGroupName when using planTitle.

--ownerGroupName [ownerGroupName]

Name of the group to which the plan belongs. Specify either ownerGroupId or ownerGroupName when using planTitle.

-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

warning

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

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 bucket by ID

m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz"

Removes the Microsoft Planner bucket by ID without confirmation

m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz" --force

Removes the Microsoft Planner bucket by its name based on the plan ID

m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"

Removes the Microsoft Planner bucket by its name based on the plan title and owner group name

m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"

Removes the Microsoft Planner bucket by its name based on the Roster ID

m365 planner bucket remove --name "My Bucket" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI"

Response

The command won't return a response on success.