@pnp/cli-microsoft365 5.5.0-beta.5a6c547 → 5.5.0-beta.6fb46e0

package/dist/m365/teams/commands/cache/cache-remove.js

@@ -0,0 +1,155 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const util = require("util");
+const cli_1 = require("../../../../cli");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsCacheRemoveCommand extends GraphCommand_1.default {
+    constructor() {
+        super(...arguments);
+        this.exec = util.promisify(require('child_process').exec);
+    }
+    get name() {
+        return commands_1.default.CACHE_REMOVE;
+    }
+    get description() {
+        return 'Removes the Microsoft Teams client cache';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.confirm = (!(!args.options.confirm)).toString();
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        if (args.options.confirm) {
+            this.clearTeamsCache(logger, cb);
+        }
+        else {
+            logger.logToStderr('This command will execute the following steps.');
+            logger.logToStderr('- Stop the Microsoft Teams client.');
+            logger.logToStderr('- Clear the Microsoft Teams cached files.');
+            cli_1.Cli.prompt({
+                type: 'confirm',
+                name: 'continue',
+                default: false,
+                message: `Are you sure you want to clear your Microsoft Teams cache?`
+            }, (result) => {
+                if (!result.continue) {
+                    cb();
+                }
+                else {
+                    this.clearTeamsCache(logger, cb);
+                }
+            });
+        }
+    }
+    clearTeamsCache(logger, cb) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.killRunningProcess(logger);
+                yield this.removeCacheFiles(logger);
+            }
+            catch (e) {
+                cb(e.message);
+                return;
+            }
+            logger.logToStderr('Teams cache cleared!');
+            cb();
+        });
+    }
+    killRunningProcess(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Stop Teams client');
+            }
+            const platform = process.platform;
+            let cmd = '';
+            switch (platform) {
+                case 'win32':
+                    cmd = 'taskkill /IM "Teams.exe" /F';
+                    break;
+                case 'darwin':
+                    cmd = `ps ax | grep MacOS/Teams -m 1 | grep -v grep | awk '{ print $1 }'`;
+                    break;
+            }
+            if (this.debug) {
+                logger.logToStderr(cmd);
+            }
+            try {
+                const cmdOutput = yield this.exec(cmd);
+                if (cmdOutput.stdout !== '' && platform === 'darwin') {
+                    process.kill(cmdOutput.stdout);
+                }
+                if (this.verbose) {
+                    logger.logToStderr('Teams client closed');
+                }
+            }
+            catch (e) {
+                const errorMessage = e.message;
+                if (errorMessage.includes('ERROR: The process "Teams.exe" not found.')) {
+                    if (this.verbose) {
+                        logger.logToStderr('Teams client isn\'t running');
+                    }
+                }
+                else {
+                    throw new Error(errorMessage);
+                }
+            }
+        });
+    }
+    removeCacheFiles(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Clear Teams cached files');
+            }
+            const platform = process.platform;
+            let cmd = '';
+            switch (platform) {
+                case 'win32':
+                    cmd = 'cd %userprofile% && rmdir /s /q AppData\\Roaming\\Microsoft\\Teams';
+                    break;
+                case 'darwin':
+                    cmd = 'rm -r ~/Library/Application\\ Support/Microsoft/Teams';
+                    break;
+            }
+            if (this.debug) {
+                logger.logToStderr(cmd);
+            }
+            try {
+                yield this.exec(cmd);
+            }
+            catch (e) {
+                throw new Error(e.message);
+            }
+        });
+    }
+    options() {
+        const options = [
+            {
+                option: '--confirm'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate() {
+        if (process.env.CLIMICROSOFT365_ENV === 'docker') {
+            return 'Because you\'re running CLI for Microsoft 365 in a Docker container, we can\'t clear the cache on your host. Instead run this command on your host using "npx ..."';
+        }
+        if (process.platform !== 'win32' && process.platform !== 'darwin') {
+            return `${process.platform} platform is unsupported for this command`;
+        }
+        return true;
+    }
+}
+module.exports = new TeamsCacheRemoveCommand();
+//# sourceMappingURL=cache-remove.js.map

package/dist/m365/teams/commands.js

@@ -8,6 +8,7 @@ exports.default = {
     APP_REMOVE: `${prefix} app remove`,
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPDATE: `${prefix} app update`,
+    CACHE_REMOVE: `${prefix} cache remove`,
     CHANNEL_ADD: `${prefix} channel add`,
     CHANNEL_GET: `${prefix} channel get`,
     CHANNEL_LIST: `${prefix} channel list`,

package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-get.js

@@ -34,15 +34,7 @@ class TenantServiceAnnouncementHealthGetCommand extends GraphCommand_1.default {
             },
             responseType: 'json'
         };
-        return request_1.default
-            .get(requestOptions)
-            .then(response => {
-            const serviceHealth = response;
-            if (!serviceHealth) {
-                return Promise.reject(`Error fetching service health`);
-            }
-            return Promise.resolve(serviceHealth);
-        });
+        return request_1.default.get(requestOptions);
     }
     options() {
         const options = [

package/dist/utils/accessToken.js

@@ -57,6 +57,24 @@ exports.accessToken = {
         catch (_a) {
         }
         return userName;
+    },
+    getUserIdFromAccessToken(accessToken) {
+        let userId = '';
+        if (!accessToken || accessToken.length === 0) {
+            return userId;
+        }
+        const chunks = accessToken.split('.');
+        if (chunks.length !== 3) {
+            return userId;
+        }
+        const tokenString = Buffer.from(chunks[1], 'base64').toString();
+        try {
+            const token = JSON.parse(tokenString);
+            userId = token.oid;
+        }
+        catch (_a) {
+        }
+        return userId;
     }
 };
 //# sourceMappingURL=accessToken.js.map

package/dist/utils/planner.js

@@ -24,10 +24,11 @@ exports.planner = {
     /**
      * Get Planner plan by ID.
      * @param id Planner ID.
+     * @param metadata OData metadata level. Default is none
      */
-    getPlanById(id) {
+    getPlanById(id, metadata = 'none') {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = getRequestOptions(`${graphResource}/v1.0/planner/plans/${id}`, 'none');
+            const requestOptions = getRequestOptions(`${graphResource}/v1.0/planner/plans/${id}`, metadata);
             try {
                 return yield request_1.default.get(requestOptions);
             }
@@ -44,19 +45,19 @@ exports.planner = {
         return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, 'none');
     },
     /**
-     * Get Planner plan by name in a specific group.
-     * @param name Name of the Planner plan. Case insensitive.
+     * Get Planner plan by title in a specific group.
+     * @param title Title of the Planner plan. Case insensitive.
      * @param groupId Owner group ID .
      */
-    getPlanByName(name, groupId) {
+    getPlanByTitle(title, groupId) {
         return __awaiter(this, void 0, void 0, function* () {
             const plans = yield this.getPlansByGroupId(groupId);
-            const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === name.toLowerCase());
+            const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
             if (!filteredPlans.length) {
-                throw Error(`The specified plan '${name}' does not exist.`);
+                throw Error(`The specified plan '${title}' does not exist.`);
             }
             if (filteredPlans.length > 1) {
-                throw Error(`Multiple plans with name '${name}' found: ${filteredPlans.map(x => x.id)}.`);
+                throw Error(`Multiple plans with title '${title}' found: ${filteredPlans.map(x => x.id)}.`);
             }
             return filteredPlans[0];
         });

package/dist/utils/validation.js

@@ -6,8 +6,12 @@ exports.validation = {
         return guids.every(guid => this.isValidGuid(guid));
     },
     isValidGuid(guid) {
+        if (!guid) {
+            return false;
+        }
         const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        return guidRegEx.test(guid);
+        // verify if the guid is a valid guid. @meid will be replaced in a later stage with the actual user id of the logged in user
+        return guidRegEx.test(guid) || guid.toLocaleLowerCase().trim() === "@meid";
     },
     isValidTeamsChannelId(guid) {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);

package/docs/docs/cmd/aad/user/user-get.md

@@ -56,6 +56,18 @@ For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user na
 m365 aad user get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --properties "userPrincipalName,mail,displayName"
 ```
 
+Get information about the currently logged user using the Id token
+
+```sh
+m365 aad user get --id "@meId"
+```
+
+Get information about the currently logged in user using the UserName token
+
+```sh
+m365 aad user get --userName "@meUserName"
+```
+
 ## More information
 
 - Microsoft Graph User properties: [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties)

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

@@ -14,16 +14,19 @@ m365 planner bucket add [options]
 : Name of the bucket to add.
 
 `--planId [planId]`
-: Plan ID to which the bucket belongs. Specify either `planId` or `planName` but not both.
+: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
 
 `--planName [planName]`
-: Plan Name to which the bucket belongs. Specify either `planId` or `planName` but not both.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--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).
@@ -38,8 +41,8 @@ Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with
 m365 planner bucket add --name "My Planner Bucket" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM" --orderHint " !"
 ```
 
-Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with the name _My Planner Plan_ owned by group _My Planner Group_
+Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with the title _My Planner Plan_ owned by group _My Planner Group_
 
 ```sh
-m365 planner bucket add --name "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```

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

@@ -17,16 +17,19 @@ m365 planner bucket get [options]
 : 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`.
+: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
 
 `--planName [planName]`
-: Plan Name to which the bucket belongs. Specify either `planId` or `planName` when using `name`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -47,11 +50,11 @@ m365 planner bucket get --name "Planner Bucket A" --planId "xqQg5FS2LkCp935s-FIF
 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"
+m365 planner bucket get --name "Planner Bucket A" --planTitle "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"
-```
+m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
+```

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

@@ -11,16 +11,19 @@ m365 planner bucket list [options]
 ## Options
 
 `--planId [planId]`
-: ID of the plan to list the buckets of. Specify either `planId` or `planName` but not both.
+: ID of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
+
+`--planTitle [planTitle]`
+: Title of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
 
 `--planName [planName]`
-: Name of the plan to list the buckets of. Specify either `planId` or `planName` but not both.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -35,5 +38,5 @@ m365 planner bucket list --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
 Lists the Microsoft Planner buckets in the Plan _My Plan_ owned by group _My Group_
 
 ```sh
-m365 planner bucket list --planName "My Plan" --ownerGroupName "My Group"
+m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
 ```

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

@@ -17,16 +17,19 @@ m365 planner bucket remove [options]
 : 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`.
+: ID of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
 
 `--planName [planName]`
-: Name of the plan to which the bucket to remove belongs. Specify either `planId` or `planName` when using `name`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--confirm`
 : Don't prompt for confirmation
@@ -56,5 +59,5 @@ m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcA
 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"
+m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```

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

@@ -17,16 +17,19 @@ m365 planner bucket set [options]
 : 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` or `planName` when using `name`.
+: ID of the plan to update the bucket of. Specify either `planId` or `planTitle` when using `name`.
+
+`--planTitle [planTitle]`
+: Title of the plan to update the bucket of. Specify either `planId` or `planTitle` when using `name`. Always use in combination with either `ownerGroupId` or `ownerGroupName`. 
 
 `--planName [planName]`
-: Name of the plan to update the bucket of. Specify either `planId` or `planName` when using `name`. Always use in combination with either `ownerGroupId` or `ownerGroupName`. 
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--newName [newName]`
 : New name of the bucket.
@@ -47,11 +50,11 @@ m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucke
 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"
+m365 planner bucket set --name "My Bucket" --planTitle "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"
+m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
 ```

package/docs/docs/cmd/planner/plan/plan-add.md

@@ -19,18 +19,34 @@ m365 planner plan add [options]
 `--ownerGroupName [ownerGroupName]`
 : Name of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId` or `ownerGroupName` but not both.
 
+`--shareWithUserIds [shareWithUserIds]`
+: The comma-separated IDs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
+`--shareWithUserNames [shareWithUserNames]`
+: The comma-separated UPNs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad o365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/o365group/o365group-user-add/) plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.
+
 ## Examples
 
 Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
 
 ```sh
-m365 planner plan add --title "My Planner Plan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
+m365 planner plan add --title 'My Planner Plan' --ownerGroupId '233e43d0-dc6a-482e-9b4e-0de7a7bce9b4'
 ```
 
 Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_
 
 ```sh
-m365 planner plan add --title "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group'
+```
+
+Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_ and share it with the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_
+
+```sh
+m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group' --shareWithUserNames 'Allan.Carroll@contoso.com,Ida.Stevens@contoso.com'
 ```

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

@@ -0,0 +1,48 @@
+# planner plan remove
+
+Removes the Microsoft Planner plan
+
+## Usage
+
+```sh
+m365 planner plan remove [options]
+```
+
+## Options
+
+`i, --id [id]`
+: ID of the plan to remove. Specify either `id` or `title` but not both.
+
+`-t, --title [title]`
+: Title of the plan to remove. Specify either `id` or `title` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the Microsoft Planner plan by ID
+
+```sh
+m365 planner plan remove --id gndWOTSK60GfPQfiDDj43JgACDCb
+```
+
+Removes the Microsoft Planner plan with title _My Plan_ in group with specific ID
+
+```sh
+m365 planner plan remove --title "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000
+```
+
+Removes the Microsoft Planner plan with title _My Plan_ in group with name _My Planner Group_ without confirmation prompt
+
+```sh
+m365 planner plan remove --title "My Plan" --ownerGroupName "My Planner Group" --confirm
+```

package/docs/docs/cmd/planner/task/task-add.md

@@ -14,22 +14,25 @@ m365 planner task add [options]
 : Title of the task to add.
 
 `--planId [planId]`
-: Plan ID to which the task belongs. Specify either `planId` or `planName` but not both.
+: ID of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
 
 `--planName [planName]`
-: Plan Name to which the task belongs. Specify either `planId` or `planName` but not both.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--bucketId [bucketId]`
-: Bucket ID to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
+: ID of the bucket to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
 
 `--bucketName [bucketName]`
-: Bucket Name to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
+: Name of the bucket to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
 
 `--startDateTime [startDateTime]`
 : The date and time when the task started. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
@@ -89,10 +92,10 @@ Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the
 m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna"
 ```
 
-Adds a Completed Microsoft Planner task with the name _My Planner Task_ for plan with the name _My Planner Plan_ owned by group _My Planner Group_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
+Adds a Completed Microsoft Planner task with the name _My Planner Task_ for plan with the title _My Planner Plan_ owned by group _My Planner Group_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
 
 ```sh
-m365 planner task add --title "My Planner task" --planName "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100
+m365 planner task add --title "My Planner task" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100
 ```
 
 Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_. The new task will be assigned to the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_ and receive a due date for _2021-12-16_

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

@@ -20,22 +20,25 @@ m365 planner task get [options]
 : (deprecated. Use `id` instead) ID of the task.
 
 `--bucketId [bucketId]`
-: Bucket ID to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
+: ID of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
 `--bucketName [bucketName]`
-: Bucket Name to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
+: Name of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
 `--planId [planId]`
-: Plan ID to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
+: ID of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
 
 `--planName [planName]`
-: Plan Name to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: 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 `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -47,8 +50,8 @@ Retrieve the specified planner task by id
 m365 planner task get --id "vzCcZoOv-U27PwydxHB8opcADJo-"
 ```
 
-Retrieve the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_ based on the plan with the name _My Planner Plan_ owned by the group _My Planner Group_
+Retrieve the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_. Based on the plan with the title _My Planner Plan_ owned by the group _My Planner Group_.
 
 ```sh
-m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```