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

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/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-get.md

@@ -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`.
 

package/docs/docs/cmd/planner/tenant/tenant-settings-list.md

@@ -0,0 +1,28 @@
+# planner tenant settings list
+
+Lists the Microsoft Planner configuration of the tenant
+
+## Usage
+
+```sh
+m365 planner tenant settings list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a global administrator.
+
+After executing the command `planner tenant settings set`, it can take some time for all changes to propagate across the tenant. Because of this, executing this command right away can return some unexpected results.
+
+## Examples
+
+Lists the Microsoft Planner settings of the tenant
+
+```sh
+m365 planner tenant settings list
+```

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

@@ -0,0 +1,64 @@
+# spo eventreceiver list
+
+Retrieves event receivers for the specified web, site or list.
+
+## Usage
+
+```sh
+m365 spo eventreceiver list [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the web for which to retrieve the event receivers.
+
+`--listTitle [listTitle]`
+: The title of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: The id of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: The url of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`-s, --scope [scope]`
+: The scope of which to retrieve the Event Receivers.
+Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieves event receivers in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales
+```
+
+Retrieves event receivers in site _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site
+```
+
+Retrieves event receivers for list with title _Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events
+```
+
+Retrieves event receivers for list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991'
+```
+
+Retrieves event receivers for list with url _/sites/contoso-sales/lists/Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events'
+```

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/list/list-list.md

@@ -13,6 +13,9 @@ m365 spo list list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site where the lists to retrieve are located
 
+`--executeWithLimitedPermissions`
+: Use this option to execute this command with site member or visitor permissions. Not specifying this option will require site owner (or admin) permissions.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples

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.a467afc",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",

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

@@ -1,24 +0,0 @@
-# planner task details get
-
-Retrieve the details of the specified planner task
-
-## Usage
-
-```sh
-m365 planner task details get [options]
-```
-
-## Options
-
-`-i, --taskId <taskId>`
-: ID of the task to retrieve details from
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Retrieve the details of the specified planner task
-
-```sh
-m365 planner task details get --taskId 'vzCcZoOv-U27PwydxHB8opcADJo-'
-```