@pnp/cli-microsoft365 6.0.0-beta.566a6b8 → 6.0.0-beta.636d726

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

@@ -0,0 +1,75 @@
+# todo task get
+
+Gets a specific task from a Microsoft To Do task list
+
+## Usage
+
+```sh
+m365 todo task get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The ID of the task in de list.
+
+`--listName [listName]`
+: The name of the task list to return tasks from. Specify either `listName` or `listId`, not both
+
+`--listId [listId]`
+: The id of the task list to return tasks from. Specify either `listName` or `listId`, not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id
+
+```sh
+m365 todo task get --listName "My task list" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+Gets a specific task from a Microsoft To Do tasks list based on the id of the list and the task id
+
+```sh
+m365 todo task get --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA==" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+## Response
+
+=== "JSON"
+
+    ``` json
+    {
+      "importance": "normal",
+      "isReminderOn": false,
+      "status": "notStarted",
+      "title": "Stay healthy",
+      "createdDateTime": "2022-10-23T14:05:09.2673009Z",
+      "lastModifiedDateTime": "2022-10-23T14:15:11.3180312Z",
+      "hasAttachments": false,
+      "categories": [],
+      "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=",
+      "body": {
+        "content": "",
+        "contentType": "text"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ``` text
+    createdDateTime     : 2022-10-23T14:05:09.2673009Z
+    id                  : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
+    lastModifiedDateTime: 2022-10-23T14:15:11.3180312Z
+    status              : notStarted
+    title               : Stay healthy
+    ```
+
+=== "CSV"
+
+    ``` text
+    id,title,status,createdDateTime,lastModifiedDateTime
+    AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=,Stay healthy,notStarted,2022-10-23T14:05:09.2673009Z,2022-10-23T14:15:11.3180312Z
+    ```

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