@pnp/cli-microsoft365 5.4.0-beta.8724dc1 → 5.4.0-beta.96022f3

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

@@ -5,6 +5,7 @@ const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 class TeamsChannelMemberRemoveCommand extends GraphCommand_1.default {
     constructor() {
         super(...arguments);
@@ -94,27 +95,13 @@ class TeamsChannelMemberRemoveCommand 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/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.teamName)
+            .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/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/spo/file/file-checkout.md

@@ -32,5 +32,5 @@ m365 spo file checkout --webUrl https://contoso.sharepoint.com/sites/project-x -
 Checks out file with server-relative url _/sites/project-x/documents/Test1.docx_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo file checkout --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/documents/Test1.docx'
+m365 spo file checkout --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/sites/project-x/documents/Test1.docx'
 ```

package/docs/docs/cmd/spo/listitem/listitem-list.md

@@ -13,11 +13,17 @@ m365 spo listitem list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site from which the item should be retrieved
 
-`-i, --id [id]`
-: ID of the list to retrieve items from. Specify `id` or `title` but not both
+`-i, --listId [listId]`
+: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both
 
-`-t, --title [title]`
-: Title of the list from which to retrieve the item. Specify `id` or `title` but not both
+`--id [id]`
+: (deprecated. Use `listId` instead) ID of the list to retrieve items from. Specify `id` or `title` but not both
+
+`-t, --listTitle [listTitle]`
+: Title of the list to retrieve items from. Specify `listId` or `listTitle` but not both
+
+`--title [title]`
+: (deprecated. Use `listTitle` instead) Title of the list to retrieve items from. Specify `id` or `title` but not both
 
 `-q, --camlQuery [camlQuery]`
 : CAML query to use to query the list of items with
@@ -45,35 +51,35 @@ m365 spo listitem list [options]
 Get all items from a list named Demo List
 
 ```sh
-m365 spo listitem list --title "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
 From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
 
 ```sh
-m365 spo listitem list --title "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query></View>"
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query></View>"
 ```
 
 Get all items from a list with ID _935c13a0-cc53-4103-8b48-c1d0828eaa7f_
 
 ```sh
-m365 spo listitem list --id 935c13a0-cc53-4103-8b48-c1d0828eaa7f --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo listitem list --listId 935c13a0-cc53-4103-8b48-c1d0828eaa7f --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
 Get all items from list named _Demo List_. For each item, retrieve the value of the _ID_, _Title_ and _Modified_ fields
 
 ```sh
-m365 spo listitem list --title "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --fields "ID,Title,Modified"
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --fields "ID,Title,Modified"
 ```
 
 From a list named _Demo List_ get all items with title _Demo list item_ using an OData filter
 
 ```sh
-m365 spo listitem list --title "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --filter "Title eq 'Demo list item'"
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --filter "Title eq 'Demo list item'"
 ```
 
 From a list named _Demo List_ get the second batch of 10 items
 
 ```sh
-m365 spo listitem list --title "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
 ```

package/docs/docs/cmd/spo/roledefinition/roledefinition-remove.md

@@ -0,0 +1,36 @@
+# spo roledefinition remove
+
+Removes the role definition from the specified site
+
+## Usage
+
+```sh
+m365 spo roledefinition remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site from which role should be removed
+
+`-i, --id <id>`
+: ID of the role definition to remove
+
+`--confirm`
+: Don't prompt for confirming removing the role definition
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+
+```sh
+m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
+```
+
+Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_ and don't prompt for confirmation
+
+```sh
+m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1 --confirm
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.4.0-beta.8724dc1",
+  "version": "5.4.0-beta.96022f3",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",