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

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

@@ -17,10 +17,10 @@ m365 planner task set [options]
 : New title of the task.
 
 `--bucketId [bucketId]`
-: ID of the bucket to move the task to. Specify either `bucketId` or `bucketName` but not both.
+: ID of the bucket to move the task to. Specify either `bucketId` or `bucketName` when using `title`.
 
 `--bucketName [bucketName]`
-: Name of the bucket to move the task to. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
+: Name of the bucket to move the task to. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` when using `title`.
 
 `--planId [planId]`
 : ID of the plan to which the bucket belongs to. Specify either `planId` or `planName` when using `bucketName`.

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/spfx/project/project-upgrade.md

@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.15.0-beta.6.
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.15.0-rc.0.
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

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

@@ -26,7 +26,10 @@ m365 spo list view add [options]
 : Title of the view to be created for the list.
 
 `--fields <fields>`
-: Comma-separated list of **case-sensitive** internal names of the fields to add to the view. 
+: Comma-separated list of **case-sensitive** internal names of the fields to add to the view.
+
+`--viewQuery [viewQuery]`
+: XML representation of the list query for the underlying view.
 
 `--personal`
 : View will be created as personal view, if specified.
@@ -51,17 +54,23 @@ We recommend using the `paged` option. When specified, the view supports display
 Add a view called _All events_ to a list with specific title.
 
 ```sh
-spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged
 ```
 
 Add a view as default view with title _All events_ to a list with a specific URL.
 
 ```sh
-spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default
 ```
 
 Add a personal view called _All events_ to a list with a specific ID.
 
 ```sh
-spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal
+```
+
+Add a view called _All events_ with defined filter and sorting.
+
+```sh
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>" --paged
 ```

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/listitem/listitem-roleinheritance-break.md

@@ -20,7 +20,7 @@ m365 spo listitem roleinheritance break [options]
 : ID of the list. Specify listId or listTitle but not both
 
 `-t, --listTitle [listTitle]`
-Title of the list. Specify listId or listTitle but not both
+: Title of the list. Specify listId or listTitle but not both
 
 `-c, --clearExistingPermissions`
 : Set to clear existing roles from the list item
@@ -55,4 +55,4 @@ Break inheritance of list item _1_ in list with ID _202b8199-b9de-43fd-9737-7f21
 
 ```sh
 m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --id 1 --clearExistingPermissions
-```
+```

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
+```