planner bucket set

Updates a Microsoft Planner bucket

Usage

m365 planner bucket set [options]

Options

-i, --id [id]

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

-n, --name [name]

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

--planId [planId]

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

--planTitle [planTitle]

Title of the plan to update the bucket of. Specify either planId, planTitle, or rosterId but not multiple when using name. Always use in combination with either ownerGroupId or ownerGroupName.

--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 ownerGroupId or ownerGroupName when using planTitle.

--ownerGroupName [ownerGroupName]

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

--newName [newName]

New name of the bucket.

--orderHint [orderHint]

Hint used to order items of this type in a list view. The format is defined as outlined here.

-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

Updates the Microsoft Planner bucket by its ID

m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucket name"

Updates the Microsoft Planner bucket with a given name based on its plan title and owner group name

m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group" --newName "New bucket name"

Updates the Microsoft Planner bucket with a given name based on its plan title and owner group ID

m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"

Updates the Microsoft Planner bucket with a given name based on its Roster ID

m365 planner bucket set --name "My Bucket" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI" --newName "New bucket name"

Response

The command won't return a response on success.