@pnp/cli-microsoft365 5.9.0-beta.740ba5f → 5.9.0-beta.77d7f6b

package/docs/docs/cmd/spo/list/list-webhook-remove.md

@@ -11,19 +11,22 @@ m365 spo list webhook remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to remove the webhook from is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list from which the webhook should be removed. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which the webhook should be removed. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-i, --id <id>`
-: ID of the webhook to remove
+: ID of the webhook.
 
 `--confirm`
-: Don't prompt for confirming removing the webhook
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,20 +36,19 @@ If the specified id doesn't refer to an existing webhook, you will get a `404 -
 
 ## Examples
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_
+Remove webhook with a specific ID from a list retrieved by ID in a specific site
 
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_
-
+Remove webhook with a specific ID from a list retrieved by Title in a specific site
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ without being asked for confirmation
+Remove webhook with a specific ID from a list retrieved by URL in a specific site without being asked for confirmation
 
 ```sh
-m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
+m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```

package/docs/docs/cmd/spo/list/list-webhook-set.md

@@ -11,22 +11,25 @@ m365 spo list webhook set [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list which contains the webhook is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-i, --id [id]`
-: ID of the webhook to update
+: ID of the webhook to update.
 
 `-n, --notificationUrl [notificationUrl]`
-: The new notification url
+: The new notification url.
 
 `-e, --expirationDateTime [expirationDateTime]`
-: The new expiration date
+: The new expiration date.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -36,21 +39,20 @@ If the specified `id` doesn't refer to an existing webhook, you will get a `404
 
 ## Examples
 
-Update the notification url of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _https://contoso-functions.azurewebsites.net/webhook_
+Update the notification url of a webhook with a specific ID attached to a list with a specific ID in a specific site to a specific URL
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook
 ```
 
-Update the expiration date of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _October 9th, 2018 at 6:15 PM_
+Update the expiration date of a webhook with a specific ID attached to a list with a specific title in a specific site to a specfic date
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --expirationDateTime 2018-10-09T18:15
 ```
 
-From the webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ update the notification url to _https://contoso-functions.azurewebsites.net/webhook_
-and the expiration date to _March 2nd, 2019_
+Update the notification url of a webhook with a specific ID attached to a list with a specific URL in a specific site to a specific URL and the expiration date to a specific date
 
 ```sh
-m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02
+m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02
 ```

package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.md

@@ -0,0 +1,81 @@
+# spo listitem roleassignment add
+
+Adds a role assignment to a listitem.
+
+## Usage
+
+```sh
+m365 spo listitem roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the listitem is located
+
+`--listId [listId]`
+: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--listTitle [listTitle]`
+: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--listUrl [listUrl]`
+: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--listItemId <listItemId>`
+: Id of the listitem to assign the role to.
+
+`--principalId [principalId]`
+: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either upn, groupName or principalId.
+
+`--upn [upn]`
+: upn/email of user to assign role to. Specify either upn, groupName or principalId.
+
+`--groupName [groupName]`
+: The group name of Azure AD or SharePoint group. Specify either upn, groupName or principalId.
+
+`--roleDefinitionId [roleDefinitionId]`
+: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+
+`--roleDefinitionName [roleDefinitionName]`
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"
+```

package/docs/docs/cmd/teams/channel/channel-add.md

@@ -23,10 +23,10 @@ m365 teams channel add [options]
 : The description of the channel to add
 
 `--type [type]`
-: Type of channel to create: `standard,private`. Default `standard`.
+: Type of channel to create: `standard`, `private`, `shared`. Default `standard`.
 
 `--owner [owner]`
-: User with this ID or UPN will be added as owner of the private channel. This option is required when type is `private`.
+: User with this ID or UPN will be added as owner of the channel. This option is required when type is `private` or `shared`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -54,8 +54,8 @@ Add private channel to the specified Microsoft Teams team with owner UPN
 m365 teams channel add --teamName "Team Name" --name climicrosoft365 --type private --owner john.doe@contoso.com
 ```
 
-Add private channel to the specified Microsoft Teams team with owner ID
+Add shared channel to the specified Microsoft Teams team with owner ID
 
 ```sh
-m365 teams channel add --teamId 6703ac8a-c49b-4fd4-8223-28f0ac3a6402 --name climicrosoft365 --type private --owner cc693a7d-4833-4911-a89a-f0fe6e49bf69
+m365 teams channel add --teamId 6703ac8a-c49b-4fd4-8223-28f0ac3a6402 --name climicrosoft365 --type shared --owner cc693a7d-4833-4911-a89a-f0fe6e49bf69
 ```

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

@@ -11,26 +11,53 @@ m365 todo task add [options]
 ## Options
 
 `-t, --title <title>`
-: The title of the task
+: The title of the task.
 
 `--listName [listName]`
-: The name of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The name of the list in which to create the task. Specify either `listName` or `listId` but not both.
 
 `--listId [listId]`
-: The id of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The id of the list in which to create the task. Specify either `listName` or `listId` but not both.
+
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--dueDateTime [dueDateTime]`
+: The date when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`. Default is `normal`.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the name _My task list_
+Add a task to Microsoft To Do tasks list with with a specific name
 
 ```sh
 m365 todo task add --title "New task" --listName "My task list"
 ```
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the id `AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==`
+Add a task to a Microsoft To Do tasks list with a specific id
 
 ```sh
 m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="
 ```
+
+Create a new task with bodyContent and reminder and flag it as important
+
+```sh
+m365 todo task add --title "New task" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Create a new task with a specific due date
+
+```sh
+m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```

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

@@ -25,18 +25,45 @@ m365 todo task set [options]
 `--listId [listId]`
 : The id of the task list in which the task exists. Specify either `listName` or `listId`, not both
 
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`.
+
+`--dueDateTime [dueDateTime]`
+: The date and time when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --title "Update doco" --listName "My task list"
 ```
 
-Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --status "inProgress" --listName "My task list"
 ```
+
+Update a task with bodyContent and reminder and flag it as important in Microsoft To Do tasks list with a specific name
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Update a task with due date in Microsoft To Do tasks list with list id
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.9.0-beta.740ba5f",
+  "version": "5.9.0-beta.77d7f6b",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -116,11 +116,14 @@
     "Calabro, David <davej.calabro@gmail.com>",
     "Choudhary, Karnail Singh <pradhankarnail@gmail.com>",
     "Connell, Andrew <me@andrewconnell.com>",
+    "Conor O'Callaghan <brioscaibriste@gmail.com>",
+    "De Cleyre, Nico <nico.de.cleyre@gmail.com>",
     "Deshpande, Vardhaman <vardhaman.rd@gmail.com>",
     "Dyjas, Robert <15113729+robdy@users.noreply.github.com>",
     "Faleel, Mohamed Ashiq <ashiqf@gmail.com>",
     "Ford, Lee <fordyman@gmail.com>",
     "Freese, Luise <49960482+LuiseFreese@users.noreply.github.com>",
+    "Gaston Flores <gaston.flrs@gmail.com>",
     "Georgiev, Velin <velin.georgiev@gmail.com>",
     "Ghuge, Pramod <pramod7@gmail.com>",
     "Gölles, Thomas <thomy@outlook.at>",
@@ -128,6 +131,7 @@
     "Harding, Phil <pil.harding@platinumdogs.co.uk>",
     "Hawrylak, Paweł <phawrylak@outlook.com>",
     "Holemans, Milan <Milan.Holemans@vanroey.be>",
+    "Hüseyin Saatçi <huseyins@comodo.net>",
     "Honen, Nicholas <nickhonen@gmail.com>",
     "Högberg, Joakim <joakim.hogberg@bravero.se>",
     "Hvam, Allan <ahp@delegate.dk>",
@@ -155,6 +159,7 @@
     "Mücklisch, Steve <steve.muecklisch@gmail.com>",
     "Nachan, Nanddeep <nanddeepnachan@gmail.com>",
     "Nachan, Smita <smita.nachan@gmail.com>",
+    "Nadir, Daniaal <daniaal1030@gmail.com>",
     "Nikolić, Aleksandar <alexandair@live.com>",
     "Otto <berot3@gmail.com>",
     "Pandey, Vividh <vividh.pandey.13@gmail.com>",
@@ -165,6 +170,7 @@
     "Priem, Mark <mark.priem@outlook.com>",
     "Raju, Arnie <arnie.raju@thesolutioncollective.com.au>",
     "Ramalho, David <dramalho@storm.ie>",
+    "Rathi, Tanmay <tanmay_rathi@intuit.com>",
     "Reekmans, Yannick <reekmans.yannick@gmail.com>",
     "Romano, Rodrigo <rodrigo@rodrigoromano.net>",
     "Romão, Douglas <douglas.romao@trentim.com>",