@pnp/cli-microsoft365 5.3.0 → 5.4.0-beta.0f3627d

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

@@ -4,6 +4,7 @@ const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 const request_1 = require("../../../../request");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 class TeamsChannelMemberSetCommand extends GraphCommand_1.default {
     constructor() {
         super(...arguments);
@@ -62,27 +63,13 @@ class TeamsChannelMemberSetCommand extends GraphCommand_1.default {
         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 aadGroup_1.aadGroup
+            .getGroupByDisplayName(args.options.teamName)
+            .then(group => {
+            if (group.resourceProvisioningOptions.indexOf('Team') === -1) {
                 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);
+            return group.id;
         });
     }
     getChannelId(args) {

package/dist/m365/teams/commands/tab/tab-get.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 class TeamsTabGetCommand extends GraphCommand_1.default {
@@ -30,27 +31,13 @@ class TeamsTabGetCommand extends GraphCommand_1.default {
         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 aadGroup_1.aadGroup
+            .getGroupByDisplayName(args.options.teamName)
+            .then(group => {
+            if (group.resourceProvisioningOptions.indexOf('Team') === -1) {
                 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);
+            return group.id;
         });
     }
     getChannelId(args) {

package/dist/m365/teams/commands/team/team-add.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 var TeamsAsyncOperationStatus;
@@ -94,13 +95,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
             if (teamsAsyncOperation.status !== TeamsAsyncOperationStatus.Succeeded) {
                 return Promise.resolve(teamsAsyncOperation);
             }
-            return request_1.default.get({
-                url: `${this.resource}/v1.0/groups/${teamsAsyncOperation.targetResourceId}`,
-                headers: {
-                    accept: 'application/json;odata.metadata=minimal'
-                },
-                responseType: 'json'
-            });
+            return aadGroup_1.aadGroup.getGroupById(teamsAsyncOperation.targetResourceId);
         })
             .then((output) => {
             logger.log(output);

package/dist/m365/teams/commands/team/team-get.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 class TeamsTeamGetCommand extends GraphCommand_1.default {
@@ -21,27 +22,13 @@ class TeamsTeamGetCommand extends GraphCommand_1.default {
         if (args.options.id) {
             return Promise.resolve(args.options.id);
         }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.name)}'&$select=id,resourceProvisioningOptions`,
-            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 aadGroup_1.aadGroup
+            .getGroupByDisplayName(args.options.name)
+            .then(group => {
+            if (group.resourceProvisioningOptions.indexOf('Team') === -1) {
                 return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
             }
-            if (response.value.length >= 2) {
-                return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.name} found: ${response.value.map(x => x.id)}`);
-            }
-            return Promise.resolve(groupItem.id);
+            return group.id;
         });
     }
     commandAction(logger, args, cb) {

package/dist/utils/aadGroup.js

@@ -0,0 +1,57 @@
+"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 });
+exports.aadGroup = void 0;
+const request_1 = require("../request");
+const odata_1 = require("./odata");
+const graphResource = 'https://graph.microsoft.com';
+exports.aadGroup = {
+    /**
+     * Retrieve a single group.
+     * @param id Group ID.
+     */
+    getGroupById(id) {
+        const requestOptions = {
+            url: `${graphResource}/v1.0/groups/${id}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default.get(requestOptions);
+    },
+    /**
+     * Get a list of groups by display name.
+     * @param displayName Group display name.
+     */
+    getGroupsByDisplayName(displayName) {
+        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(displayName)}'`);
+    },
+    /**
+     * Get a single group by its display name.
+     * @param displayName Group display name.
+     * @throws Error when group was not found.
+     * @throws Error when multiple groups with the same name were found.
+     */
+    getGroupByDisplayName(displayName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const groups = yield this.getGroupsByDisplayName(displayName);
+            if (!groups.length) {
+                throw Error(`The specified group '${displayName}' does not exist.`);
+            }
+            if (groups.length > 1) {
+                throw Error(`Multiple groups with name '${displayName}' found: ${groups.map(x => x.id).join(',')}.`);
+            }
+            return groups[0];
+        });
+    }
+};
+//# sourceMappingURL=aadGroup.js.map

package/dist/utils/index.js

@@ -14,12 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./aadGroup"), exports);
 __exportStar(require("./accessToken"), exports);
 __exportStar(require("./formatting"), exports);
 __exportStar(require("./fsUtil"), exports);
 __exportStar(require("./md"), exports);
 __exportStar(require("./odata"), exports);
 __exportStar(require("./packageManager"), exports);
+__exportStar(require("./planner"), exports);
 __exportStar(require("./sinonUtil"), exports);
 __exportStar(require("./spfx"), exports);
 __exportStar(require("./spo"), exports);

package/dist/utils/validation.js

@@ -37,22 +37,32 @@ exports.validation = {
         return dateTimeRegEx.test(date) ? true : dateOnlyRegEx.test(date);
     },
     isValidISODateTime(dateTime) {
-        const withMilliSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])\.[0-9]{3}Z$/);
-        if (withMilliSecsPattern.test(dateTime)) {
+        // Format: 2000-01-01T00:00:00.0000000Z
+        const withMilliSecsLongPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])\.[0-9]{7}Z$/);
+        if (withMilliSecsLongPattern.test(dateTime)) {
             return true;
         }
+        // Format: 2000-01-01T00:00:00.000Z
+        const withMilliSecsShortPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])\.[0-9]{3}Z$/);
+        if (withMilliSecsShortPattern.test(dateTime)) {
+            return true;
+        }
+        // Format: 2000-01-01T00:00:00Z
         const withSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])Z$/);
         if (withSecsPattern.test(dateTime)) {
             return true;
         }
+        // Format: 2000-01-01T00:00Z
         const withMinutesPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9])Z$/);
         if (withMinutesPattern.test(dateTime)) {
             return true;
         }
+        // Format: 2000-01-01T00Z
         const withHoursPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3])Z$/);
         if (withHoursPattern.test(dateTime)) {
             return true;
         }
+        // Format: 2000-01-01
         const withoutTimePattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))$/);
         if (withoutTimePattern.test(dateTime)) {
             return true;

package/docs/docs/cmd/aad/app/app-set.md

@@ -20,7 +20,7 @@ m365 aad app set [options]
 : Name of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`
 
 `-u, --uri [uri]`
-: Application ID URI to update
+: Comma-separated list of Application ID URIs to update
 
 `-r, --redirectUris [redirectUris]`
 : Comma-separated list of redirect URIs to add to the app registration. Requires `platform` to be specified

package/docs/docs/cmd/file/file-list.md

@@ -27,20 +27,20 @@ This command is an improved version of the `spo file list` command. The main dif
 
 ## Examples
 
-Return all files from folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from the folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents'
+m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl 'Shared Documents'
 ```
 
 Return all files from the folder _Shared Documents_ and all the sub-folders of _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --recursive
+m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl 'Shared Documents' --recursive
 ```
 
 Return all files from the _Important_ folder in the _Shared Documents_ document library located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents/Important'
+m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl 'Shared Documents/Important'
 ```

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

@@ -13,7 +13,7 @@ m365 planner bucket get [options]
 `-i, --id [id]`
 : ID of the bucket to retrieve details. Specify either `id` or `name` but not both.
 
-`-name, --name [name]`
+`-n, --name [name]`
 : Name of the bucket to retrieve details. Specify either `id` or `name` but not both. 
 
 `--planId [planId]`

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

@@ -10,10 +10,10 @@ m365 planner bucket remove [options]
 
 ## Options
 
-`--id [id]`
+`-i, --id [id]`
 : ID of the bucket to remove. Specify either `id` or `name` but not both.
 
-`--name [name]`
+`-n, --name [name]`
 : Name of the bucket to remove. Specify either `id` or `name` but not both.
 
 `--planId [planId]`

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

@@ -13,20 +13,20 @@ m365 planner bucket set [options]
 `-i, --id [id]`
 : ID of the bucket. Specify either `id` or `name` but not both.
 
-`--name [name]`
+`-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. Use when referring to bucket using `name`. Specify either `planId` or `planName` but not both.
+: ID of the plan to update the bucket of. Specify either `planId` or `planName` when using `name`.
 
 `--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.
+: 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`. 
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
+: 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. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
 
 `--newName [newName]`
 : New name of the bucket.

package/docs/docs/cmd/planner/plan/plan-details-get.md

@@ -17,10 +17,10 @@ m365 planner plan details get [options]
 : Title of the plan. Specify either `planId` or `planTitle` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -10,17 +10,17 @@ m365 planner plan get [options]
 
 ## Options
 
-`-i,--id [id]`
+`-i, --id [id]`
 : ID of the plan. Specify either `id` or `title` but not both.
 
-`-t,--title [title]`
+`-t, --title [title]`
 : Title of the plan. Specify either `id` or `title` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: 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` but not both.
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -0,0 +1,36 @@
+# planner task checklistitem add
+
+Adds a new checklist item to a Planner task
+
+## Usage
+
+```sh
+m365 planner task checklistitem add [options]
+```
+
+## Options
+
+`-i, --taskId <taskId>`
+: ID of the task.
+
+`-t, --title <title>`
+: Title of the checklist item.
+
+`--isChecked`
+: Mark the checklist item as checked.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Adds an unchecked checklist item with title _My checklist item_ to a Microsoft Planner task with ID _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --title "My checklist item"
+```
+
+Adds a checked checklist item with title _My checklist item_ to a Microsoft Planner task with ID _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --title "My checklist item" --isChecked
+```

package/docs/docs/cmd/planner/task/task-checklistitem-list.md

@@ -0,0 +1,24 @@
+# planner task checklistitem list
+
+Lists the checklist items of a Planner task.
+
+## Usage
+
+```sh
+m365 planner task checklistitem list [options]
+```
+
+## Options
+
+`-i, --taskId <taskId>`
+: ID of the task
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Lists the checklist items of a Planner task.
+
+```sh
+m365 planner task checklistitem list --taskId 'vzCcZoOv-U27PwydxHB8opcADJo-'
+```

package/docs/docs/cmd/planner/task/task-checklistitem-remove.md

@@ -0,0 +1,36 @@
+# planner task checklistitem remove
+
+Removes the checklist item from the Planner task.
+
+## Usage
+
+```sh
+m365 planner task checklistitem remove [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: ID of the checklist item.
+
+`--taskId <taskId>`
+: ID of the task.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" 
+```
+
+Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_ without prompt
+
+```sh
+m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --confirm
+```

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

@@ -1,6 +1,6 @@
 # planner task get
 
-Retrieve the the specified planner task
+Retrieve the specified planner task
 
 ## Usage
 
@@ -16,6 +16,9 @@ m365 planner task get [options]
 `-t, --title [title]`
 : Title of the task. Specify either `id` or `title` but not both.
 
+`--taskId [taskId]`
+: (deprecated. Use `id` instead) ID of the task.
+
 `--bucketId [bucketId]`
 : Bucket ID to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
@@ -36,20 +39,15 @@ m365 planner task get [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Remarks
-
-!!! attention
-    This command uses an API that is currently in preview to enrich the results with the `priority` field. Keep in mind that this preview API is subject to change once the API reached general availability.
-
 ## Examples
 
-Retrieve the the specified planner task by id.
+Retrieve the specified planner task by id
 
 ```sh
-m365 planner task get --id 'vzCcZoOv-U27PwydxHB8opcADJo-'
+m365 planner task get --id "vzCcZoOv-U27PwydxHB8opcADJo-"
 ```
 
-Retrieve the 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 name _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"

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

@@ -17,10 +17,10 @@ m365 planner task list [options]
 : Name of the bucket to list the tasks of. To retrieve tasks from a bucket, specify `bucketId` or `bucketName`, but not both.
 
 `--planId [planId]`
-: ID of the plan to list the tasks of. Specify `planId` or `planName` when using `bucketName`.
+: ID of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planName` but not both. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
 
 `--planName [planName]`
-: Name of the plan to list the tasks of. Specify `planId` or `planName` when using `bucketName`.
+: Name of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planName` but not both. Always use in combination with either `ownerGroupId` or `ownerGroupName`. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.

package/docs/docs/cmd/planner/task/task-reference-remove.md

@@ -0,0 +1,39 @@
+# planner task reference remove
+
+Removes the reference from the Planner task.
+
+## Usage
+
+```sh
+m365 planner task reference remove [options]
+```
+
+## Options
+
+`-u, --url [url]`
+: URL location of the reference. Specify either `alias` or `url` but not both.
+
+`--alias [alias]`
+: The alias of the reference. Specify either `alias` or `url` but not both.
+
+`-i, --taskId <taskId>`
+: ID of the task.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a reference with the url _https://www.microsoft.com_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task reference remove --url "https://www.microsoft.com" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" 
+```
+
+Removes a reference with the alias _Parker_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task reference remove --alias "Parker" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"
+```

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

@@ -0,0 +1,78 @@
+# planner task remove
+
+Removes the Microsoft Planner task from a plan
+
+## Usage
+
+```sh
+m365 planner task remove [options]
+```
+
+## Options
+
+`--id [id]`
+: ID of the task to remove. Specify either `id` or `title` but not both.
+
+`--title [title]`
+: Title of the task to remove. Specify either `id` or `title` but not both.
+
+`--bucketId [bucketId]`
+: ID of the bucket to which the task to remove belongs. Specify either `bucketId` or `bucketName` but not both.
+
+`--bucketName [bucketName]`
+: Name of the bucket to which the task to remove belongs. Specify either `bucketId` or `bucketName` but not both.
+
+`--planId [planId]`
+: ID of the plan to which the task to remove belongs. Specify either `planId` or `planTitle` when using `title`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the task to remove belongs. Specify either `planId` or `planTitle` when using `title`.
+
+`--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`.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the Microsoft Planner task by ID
+
+```sh
+m365 planner task remove --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"
+```
+
+Removes the Microsoft Planner task by ID without confirmation
+
+```sh
+m365 planner task remove --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --confirm
+```
+
+Removes the Microsoft Planner task with title _My Task_ in the bucket with ID _vncYUXCRBke28qMLB-d4xJcACtNz_
+
+```sh
+m365 planner task remove --title "My Task" --bucketId "vncYUXCRBke28qMLB-d4xJcACtNz" 
+```
+
+Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan with ID _oUHpnKBFekqfGE_PS6GGUZcAFY7b_
+
+```sh
+m365 planner task remove --title "My Task" --bucketName "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"
+```
+
+Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+
+```sh
+m365 planner task remove --title "My Task" --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
+```
+
+Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan _My Plan_ owned by group with ID _00000000-0000-0000-0000-000000000000_
+
+```sh
+m365 planner task remove --title "My Task" --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupId "00000000-0000-0000-0000-000000000000"
+```