@pnp/cli-microsoft365 5.2.0-beta.dc50ce6 → 5.3.0-beta.24cd8e4

package/dist/m365/spo/commands/roledefinition/roledefinition-list.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoRoleDefinitionListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.ROLEDEFINITION_LIST;
+    }
+    get description() {
+        return 'Gets list of role definitions for the specified site';
+    }
+    defaultProperties() {
+        return ['Id', 'Name'];
+    }
+    commandAction(logger, args, cb) {
+        if (this.verbose) {
+            logger.logToStderr(`Getting role definitions list from ${args.options.webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${args.options.webUrl}/_api/web/roledefinitions`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((response) => {
+            logger.log(response.value);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-u, --webUrl <webUrl>'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        return utils_1.validation.isValidSharePointUrl(args.options.webUrl);
+    }
+}
+module.exports = new SpoRoleDefinitionListCommand();
+//# sourceMappingURL=roledefinition-list.js.map

package/dist/m365/spo/commands.js

@@ -41,6 +41,7 @@ exports.default = {
     FEATURE_LIST: `${prefix} feature list`,
     FIELD_ADD: `${prefix} field add`,
     FIELD_GET: `${prefix} field get`,
+    FIELD_LIST: `${prefix} field list`,
     FIELD_REMOVE: `${prefix} field remove`,
     FIELD_SET: `${prefix} field set`,
     FILE_ADD: `${prefix} file add`,
@@ -95,6 +96,8 @@ exports.default = {
     LIST_LABEL_SET: `${prefix} list label set`,
     LIST_LIST: `${prefix} list list`,
     LIST_REMOVE: `${prefix} list remove`,
+    LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
+    LIST_ROLEINHERITANCE_RESET: `${prefix} list roleinheritance reset`,
     LIST_SET: `${prefix} list set`,
     LIST_SITESCRIPT_GET: `${prefix} list sitescript get`,
     LIST_VIEW_GET: `${prefix} list view get`,
@@ -117,6 +120,8 @@ exports.default = {
     LISTITEM_RECORD_DECLARE: `${prefix} listitem record declare`,
     LISTITEM_RECORD_UNDECLARE: `${prefix} listitem record undeclare`,
     LISTITEM_REMOVE: `${prefix} listitem remove`,
+    LISTITEM_ROLEINHERITANCE_BREAK: `${prefix} listitem roleinheritance break`,
+    LISTITEM_ROLEINHERITANCE_RESET: `${prefix} listitem roleinheritance reset`,
     LISTITEM_SET: `${prefix} listitem set`,
     MAIL_SEND: `${prefix} mail send`,
     NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
@@ -159,6 +164,7 @@ exports.default = {
     REPORT_SITEUSAGEPAGES: `${prefix} report siteusagepages`,
     REPORT_SITEUSAGESITECOUNTS: `${prefix} report siteusagesitecounts`,
     REPORT_SITEUSAGESTORAGE: `${prefix} report siteusagestorage`,
+    ROLEDEFINITION_LIST: `${prefix} roledefinition list`,
     SEARCH: `${prefix} search`,
     SERVICEPRINCIPAL_GRANT_ADD: `${prefix} serviceprincipal grant add`,
     SERVICEPRINCIPAL_GRANT_LIST: `${prefix} serviceprincipal grant list`,

package/dist/m365/teams/commands/channel/channel-member-remove.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../../../../cli");
+const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsChannelMemberRemoveCommand extends GraphCommand_1.default {
+    constructor() {
+        super(...arguments);
+        this.teamId = '';
+        this.channelId = '';
+    }
+    get name() {
+        return commands_1.default.CHANNEL_MEMBER_REMOVE;
+    }
+    get description() {
+        return 'Updates the role of the specified member in the specified Microsoft Teams private team channel';
+    }
+    alias() {
+        return [commands_1.default.CONVERSATIONMEMBER_REMOVE];
+    }
+    optionSets() {
+        return [
+            ['teamId', 'teamName'],
+            ['channelId', 'channelName'],
+            ['userId', 'userName', 'id']
+        ];
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.teamId = typeof args.options.teamId !== 'undefined';
+        telemetryProps.teamName = typeof args.options.teamName !== 'undefined';
+        telemetryProps.channelId = typeof args.options.channelId !== 'undefined';
+        telemetryProps.channelName = typeof args.options.channelName !== 'undefined';
+        telemetryProps.userName = typeof args.options.userName !== 'undefined';
+        telemetryProps.userId = typeof args.options.userId !== 'undefined';
+        telemetryProps.id = typeof args.options.id !== 'undefined';
+        telemetryProps.confirm = (!(!args.options.confirm)).toString();
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        this.showDeprecationWarning(logger, commands_1.default.CONVERSATIONMEMBER_REMOVE, commands_1.default.CHANNEL_MEMBER_REMOVE);
+        const removeMember = () => {
+            this
+                .removeMemberFromChannel(args)
+                .then(cb, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+        };
+        if (args.options.confirm) {
+            removeMember();
+        }
+        else {
+            const userName = args.options.userName || args.options.userId || args.options.id;
+            const teamName = args.options.teamName || args.options.teamId;
+            const channelName = args.options.channelName || args.options.channelId;
+            cli_1.Cli.prompt({
+                type: 'confirm',
+                name: 'continue',
+                default: false,
+                message: `Are you sure you want to remove the member ${userName} from the channel ${channelName} in team ${teamName}?`
+            }, (result) => {
+                if (!result.continue) {
+                    cb();
+                }
+                else {
+                    removeMember();
+                }
+            });
+        }
+    }
+    removeMemberFromChannel(args) {
+        return this
+            .getTeamId(args)
+            .then((teamId) => {
+            this.teamId = teamId;
+            return this.getChannelId(args);
+        })
+            .then((channelId) => {
+            this.channelId = channelId;
+            return this.getMemberId(args);
+        })
+            .then((memberId) => {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/teams/${this.teamId}/channels/${this.channelId}/members/${memberId}`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.delete(requestOptions);
+        });
+    }
+    getTeamId(args) {
+        if (args.options.teamId) {
+            return Promise.resolve(args.options.teamId);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.teamName)}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const groupItem = response.value[0];
+            if (!groupItem) {
+                return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
+            }
+            if (groupItem.resourceProvisioningOptions.indexOf('Team') === -1) {
+                return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
+            }
+            if (response.value.length > 1) {
+                return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.teamName} found: ${response.value.map(x => x.id)}`);
+            }
+            return Promise.resolve(groupItem.id);
+        });
+    }
+    getChannelId(args) {
+        if (args.options.channelId) {
+            return Promise.resolve(args.options.channelId);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels?$filter=displayName eq '${encodeURIComponent(args.options.channelName)}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const channelItem = response.value[0];
+            if (!channelItem) {
+                return Promise.reject(`The specified channel does not exist in the Microsoft Teams team`);
+            }
+            return Promise.resolve(channelItem.id);
+        });
+    }
+    getMemberId(args) {
+        if (args.options.id) {
+            return Promise.resolve(args.options.id);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/teams/${this.teamId}/channels/${this.channelId}/members`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const conversationMembers = response.value.filter(x => {
+                var _a, _b;
+                return args.options.userId && ((_a = x.userId) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === args.options.userId.toLocaleLowerCase() ||
+                    args.options.userName && ((_b = x.email) === null || _b === void 0 ? void 0 : _b.toLocaleLowerCase()) === args.options.userName.toLocaleLowerCase();
+            });
+            const conversationMember = conversationMembers[0];
+            if (!conversationMember) {
+                return Promise.reject(`The specified member does not exist in the Microsoft Teams channel`);
+            }
+            if (conversationMembers.length > 1) {
+                return Promise.reject(`Multiple Microsoft Teams channel members with name ${args.options.userName} found: ${response.value.map(x => x.userId)}`);
+            }
+            return Promise.resolve(conversationMember.id);
+        });
+    }
+    options() {
+        const options = [
+            {
+                option: '--teamId [teamId]'
+            },
+            {
+                option: '--teamName [teamName]'
+            },
+            {
+                option: '--channelId [channelId]'
+            },
+            {
+                option: '--channelName [channelName]'
+            },
+            {
+                option: '--userName [userName]'
+            },
+            {
+                option: '--userId [userId]'
+            },
+            {
+                option: '--id [id]'
+            },
+            {
+                option: '--confirm'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (args.options.teamId && !utils_1.validation.isValidGuid(args.options.teamId)) {
+            return `${args.options.teamId} is not a valid GUID`;
+        }
+        if (args.options.channelId && !utils_1.validation.isValidTeamsChannelId(args.options.channelId)) {
+            return `${args.options.channelId} is not a valid Teams Channel ID`;
+        }
+        if (args.options.userId && !utils_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new TeamsChannelMemberRemoveCommand();
+//# sourceMappingURL=channel-member-remove.js.map

package/dist/m365/teams/commands.js

@@ -13,6 +13,7 @@ exports.default = {
     CHANNEL_LIST: `${prefix} channel list`,
     CHANNEL_MEMBER_ADD: `${prefix} channel member add`,
     CHANNEL_MEMBER_LIST: `${prefix} channel member list`,
+    CHANNEL_MEMBER_REMOVE: `${prefix} channel member remove`,
     CHANNEL_MEMBER_SET: `${prefix} channel member set`,
     CHANNEL_REMOVE: `${prefix} channel remove`,
     CHANNEL_SET: `${prefix} channel set`,
@@ -23,6 +24,7 @@ exports.default = {
     CHAT_MESSAGE_SEND: `${prefix} chat message send`,
     CONVERSATIONMEMBER_ADD: `${prefix} conversationmember add`,
     CONVERSATIONMEMBER_LIST: `${prefix} conversationmember list`,
+    CONVERSATIONMEMBER_REMOVE: `${prefix} conversationmember remove`,
     FUNSETTINGS_LIST: `${prefix} funsettings list`,
     FUNSETTINGS_SET: `${prefix} funsettings set`,
     GUESTSETTINGS_LIST: `${prefix} guestsettings list`,

package/dist/m365/tenant/commands/security/security-alerts-list.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const request_1 = require("../../../../request");
+const commands_1 = require("../../commands");
+class TenantSecurityAlertsListCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.SECURITY_ALERTS_LIST;
+    }
+    get description() {
+        return 'Gets the security alerts for a tenant';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.vendor = typeof args.options.vendor !== 'undefined';
+        return telemetryProps;
+    }
+    defaultProperties() {
+        return ['id', 'title', 'severity'];
+    }
+    commandAction(logger, args, cb) {
+        this
+            .listAlert(args.options)
+            .then((res) => {
+            logger.log(res);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    listAlert(options) {
+        let queryFilter = '';
+        if (options.vendor) {
+            let vendorName = options.vendor;
+            switch (options.vendor.toLowerCase()) {
+                case 'azure security center':
+                    vendorName = 'ASC';
+                    break;
+                case 'microsoft cloud app security':
+                    vendorName = 'MCAS';
+                    break;
+                case 'azure active directory identity protection':
+                    vendorName = 'IPC';
+            }
+            queryFilter = `?$filter=vendorInformation/provider eq '${encodeURIComponent(vendorName)}'`;
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/security/alerts${queryFilter}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const alertList = response.value;
+            if (!alertList) {
+                return Promise.reject(`Error fetching security alerts`);
+            }
+            return Promise.resolve(alertList);
+        });
+    }
+    options() {
+        const options = [
+            { option: '--vendor [vendor]' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+}
+module.exports = new TenantSecurityAlertsListCommand();
+//# sourceMappingURL=security-alerts-list.js.map

package/dist/m365/tenant/commands.js

@@ -9,6 +9,7 @@ exports.default = {
     REPORT_OFFICE365ACTIVATIONSUSERDETAIL: `${prefix} report office365activationsuserdetail`,
     REPORT_OFFICE365ACTIVATIONSUSERCOUNTS: `${prefix} report office365activationsusercounts`,
     REPORT_SERVICESUSERCOUNTS: `${prefix} report servicesusercounts`,
+    SECURITY_ALERTS_LIST: `${prefix} security alerts list`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_GET: `${prefix} serviceannouncement healthissue get`,
     SERVICEANNOUNCEMENT_HEALTH_GET: `${prefix} serviceannouncement health get`,
     SERVICEANNOUNCEMENT_HEALTH_LIST: `${prefix} serviceannouncement health list`,

package/dist/utils/accessToken.js

@@ -2,6 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.accessToken = void 0;
 exports.accessToken = {
+    isAppOnlyAccessToken(accessToken) {
+        let isAppOnlyAccessToken = false;
+        if (!accessToken || accessToken.length === 0) {
+            return isAppOnlyAccessToken;
+        }
+        const chunks = accessToken.split('.');
+        if (chunks.length !== 3) {
+            return isAppOnlyAccessToken;
+        }
+        const tokenString = Buffer.from(chunks[1], 'base64').toString();
+        try {
+            const token = JSON.parse(tokenString);
+            isAppOnlyAccessToken = token.idtyp === 'app';
+        }
+        catch (_a) {
+        }
+        return isAppOnlyAccessToken;
+    },
     getTenantIdFromAccessToken(accessToken) {
         let tenantId = '';
         if (!accessToken || accessToken.length === 0) {

package/docs/docs/cmd/app/app-open.md

@@ -0,0 +1,45 @@
+# aad app open
+
+Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page.
+
+## Usage
+
+```sh
+m365 app open [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Optional Application (client) ID of the Azure AD application registration to open. Uses the app from the `.m365rc.json` file corresponding to the `appId`. If multiple apps are available, this will evade the prompt to choose an app. If the `appId` is not available in the list of apps, an error is thrown.
+
+`--preview`
+: Use to open the url of the Azure AD preview portal.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+If config setting `autoOpenLinksInBrowser` is configured to true, the command will automatically open the link to the Azure Portal in the browser.
+
+Gets the app from the `.m365rc.json` file in the current directory. If the `--appId` option is not used and multiple apps are available, it will prompt the user to choose one.
+
+## Examples
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal. 
+
+```sh
+m365 app open
+```
+
+Prints the url of the Azure AD application registration management page on the preview Azure Portal.
+
+```sh
+m365 app open --preview
+```
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal, evading a possible choice prompt in the case of multiple saved apps in the `.m365rc.json` file. 
+
+```sh
+m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8 
+```

package/docs/docs/cmd/planner/bucket/bucket-get.md

@@ -0,0 +1,57 @@
+# planner bucket get
+
+Gets the Microsoft Planner bucket in a plan
+
+## Usage
+
+```sh
+m365 planner bucket get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the bucket to retrieve details. Specify either `id` or `name` but not both.
+
+`-name, --name [name]`
+: Name of the bucket to retrieve details. Specify either `id` or `name` but not both. 
+
+`--planId [planId]`
+: Plan ID to which the bucket belongs. Specify either `planId` or `planName` when using `name`.
+
+`--planName [planName]`
+: Plan Name to which the bucket belongs. Specify either `planId` or `planName` when using `name`.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets the specified Microsoft Planner bucket 
+
+```sh
+m365 planner bucket get --id "5h1uuYFk4kKQ0hfoTUkRLpgALtYi"
+```
+
+Gets the Microsoft Planner bucket in the PlanId xqQg5FS2LkCp935s-FIFm2QAFkHM
+
+```sh
+m365 planner bucket get --name "Planner Bucket A" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
+```
+
+Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by group _My Group_
+
+```sh
+m365 planner bucket get --name "Planner Bucket A" --planName "My Plan" --ownerGroupName "My Group"
+```
+
+Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by groupId ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e
+
+```sh
+m365 planner bucket get --name "Planner Bucket A" --planName "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
+```

package/docs/docs/cmd/planner/bucket/bucket-remove.md

@@ -0,0 +1,60 @@
+# planner bucket remove
+
+Removes the Microsoft Planner bucket from a plan
+
+## Usage
+
+```sh
+m365 planner bucket remove [options]
+```
+
+## Options
+
+`--id [id]`
+: ID of the bucket to remove. Specify either `id` or `name` but not both.
+
+`--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` or `planName` when using `name`.
+
+`--planName [planName]`
+: Name of the plan to which the bucket to remove belongs. Specify either `planId` or `planName` when using `name`.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the Microsoft Planner bucket by ID
+
+```sh
+m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz"
+```
+
+Removes the Microsoft Planner bucket by ID without confirmation
+
+```sh
+m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz" --confirm
+```
+
+Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan with ID _oUHpnKBFekqfGE_PS6GGUZcAFY7b_
+
+```sh
+m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"
+```
+
+Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+
+```sh
+m365 planner bucket remove --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group"
+```

package/docs/docs/cmd/planner/bucket/bucket-set.md

@@ -0,0 +1,57 @@
+# planner bucket set
+
+Updates a Microsoft Planner bucket
+
+## Usage
+
+```sh
+m365 planner bucket set [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the bucket. Specify either `id` or `name` but not both.
+
+`--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. Use when referring to bucket using `name`. Specify either `planId` or `planName` but not both.
+
+`--planName [planName]`
+: Name of the plan to update the bucket of. Use when referring to bucket using `name`. Specify either `planId` or `planName` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the group to which the plan belongs. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the group to which the plan belongs. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
+
+`--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](https://docs.microsoft.com/en-us/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Updates the Microsoft Planner bucket with ID _vncYUXCRBke28qMLB-d4xJcACtNz_
+
+```sh
+m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucket name"
+```
+
+Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+
+```sh
+m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group" --newName "New bucket name"
+```
+
+Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group with ID _00000000-0000-0000-0000-000000000000_
+
+```sh
+m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
+```