@pnp/cli-microsoft365 6.4.0 → 6.5.0-beta.699c15b

package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md

@@ -22,12 +22,17 @@ m365 spo file retentionlabel ensure [options]
 `--name <name>`
 : Name of the retention label to apply to the file.
 
+`-a, --assetId [assetId]`
+: A Compliance Asset Id to set on the item when it's labeled. See below for more information.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
 You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
 
+The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
 ## Examples
 
 Applies a retention label to a file based on the label name and the fileUrl
@@ -39,7 +44,13 @@ m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/site
 Applies a retention label to a file based on the label name and the fileId
 
 ```sh
-m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8'  --name 'Some label'
+m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8' --name 'Some label'
+```
+
+Applies a event-based retention label to a file and updates the Asset Id field
+
+```sh
+m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8' --name 'Some label' --assetId 'XYZ'
 ```
 
 ## Response

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

@@ -56,7 +56,7 @@ m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-
 Remove view with title _MyView_ from a list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle MyView
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --title MyView
 ```
 
 Remove view with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_ without being asked for confirmation

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

@@ -58,13 +58,13 @@ Update view formatting of the specified list view
 === "PowerShell"
 
     ```sh
-    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter '{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] <= @now, ''sp-field-severity--severeWarning'', '''')\"}'
+    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All items' --CustomFormatter '{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] <= @now, ''sp-field-severity--severeWarning'', '''')\"}'
     ```
 
 === "Bash"
 
     ```sh
-    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter "{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] <= @now, 'sp-field-severity--severeWarning', '')\"}"
+    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All items' --CustomFormatter "{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] <= @now, 'sp-field-severity--severeWarning', '')\"}"
     ```
 
 ## Response

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

@@ -13,17 +13,20 @@ m365 spo listitem get [options]
 `-u, --webUrl <webUrl>`
 : URL of the site where the item is located.
 
-`-i, --id <id>`
-: ID of the item to retrieve.
+`-i, --id [id]`
+: ID of the item to retrieve. Specify either `id` or `uniqueId` but not both.
+
+`--uniqueId [uniqueId]`
+: The Unique ID (GUID) of the item to retrieve. Specify either `id` or `uniqueId` but not both.
 
 `-l, --listId [listId]`
-: ID of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `--listUrl [listUrl]`
-: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
@@ -45,6 +48,12 @@ Get an item with the ID parameter from a given list in a given site.
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
+Get an item with the Unique ID parameter from a given list in a given site.
+
+```sh
+m365 spo listitem get --listTitle "Demo List" --uniqueId "64dc28c4-3c43-45f6-ba66-307d9eb7e6aa" --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
 Get an item columns with the ID parameter from a given list in a given site.
 
 ```sh

package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.md

@@ -31,11 +31,18 @@ m365 spo listitem retentionlabel ensure [options]
 `-i, --id [id]`
 : The id of the retention label. Specify either `name` or `id`.
 
+`-a, --assetId [assetId]`
+: A Compliance Asset Id to set on the item when it's labeled. See below for more information.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
 ## Examples
 
-Applies the retention label _Some label_ to a list item in a given site based on the list id and label name
+Applies a retention label to a list item in a given site based on the list id and label name
 
 ```sh
 m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --listItemId 1 --name 'Some label'
@@ -47,12 +54,18 @@ Applies a retention label to a list item in a given site based on the list title
 m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1 --id '7a621a91-063b-461b-aff6-d713d5fb23eb'
 ```
 
-Applies the retention label _Some label_ to a list item in a given site based on the server relative list url
+Applies a retention label to a list item in a given site based on the server relative list url
 
 ```sh
 m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1 --name 'Some label'
 ```
 
+Applies a retention label to a list item in a given site based on the server relative list url and updates the Asset Id field
+
+```sh
+m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1 --name 'Some label' --assetId 'XYZ'
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/teams/team/team-list.md

@@ -37,20 +37,60 @@ m365 teams team list --joined
 
 === "JSON"
 
-    ``` json
+    ```json
     [
       {
         "id": "5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3",
+        "createdDateTime": "2022-12-08T09:17:55.039Z",
         "displayName": "Architecture",
+        "description": "Architecture Discussion",
+        "internalId": "19:pLknmKPPkvgeaG0FtegLfjoDINeY3gvmitMkNG9H3X41@thread.tacv2",
+        "classification": null,
+        "specialization": "none",
+        "visibility": "public",
+        "webUrl": "https://teams.microsoft.com/l/team/19:a5c6eccad3fb401997756a1501d561aa%40thread.skype/conversations?groupId=8090c93e-ba7c-433e-9f39-08c7ba07c0b3&tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35",
         "isArchived": false,
-        "description": "Architecture Discussion"
+        "isMembershipLimitedToOwners": false,
+        "discoverySettings": {
+          "showInTeamsSearchAndSuggestions": true
+        },
+        "memberSettings": {
+          "allowCreateUpdateChannels": true,
+          "allowCreatePrivateChannels": true,
+          "allowDeleteChannels": true,
+          "allowAddRemoveApps": true,
+          "allowCreateUpdateRemoveTabs": true,
+          "allowCreateUpdateRemoveConnectors": true
+        },
+        "guestSettings": {
+          "allowCreateUpdateChannels": false,
+          "allowDeleteChannels": false
+        },
+        "messagingSettings": {
+          "allowUserEditMessages": false,
+          "allowUserDeleteMessages": false,
+          "allowOwnerDeleteMessages": false,
+          "allowTeamMentions": true,
+          "allowChannelMentions": true
+        },
+        "funSettings": {
+          "allowGiphy": true,
+          "giphyContentRating": "moderate",
+          "allowStickersAndMemes": true,
+          "allowCustomMemes": false
+        },
+        "summary": {
+          "ownersCount": 1,
+          "membersCount": 1,
+          "guestsCount": 0
+        }
       }
     ]
     ```
 
 === "Text"
 
-    ``` text
+    ```text
     id                                    displayName       isArchived  description
     ------------------------------------  ----------------  ----------  ---------------------------------------
     5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3  Architecture      false       Architecture Discussion
@@ -58,7 +98,7 @@ m365 teams team list --joined
 
 === "CSV"
 
-    ``` text
+    ```csv
     id,displayName,isArchived,description
     5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3,Architecture,,Architecture Discussion
     ```

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

@@ -40,8 +40,21 @@ m365 todo task set [options]
 `--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.
 
+`--categories [categories]`
+: Comma-separated list of categories associated with the task.
+
+`--completedDateTime [completedDateTime]`
+: The date and time when the task was finished. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
+
+`--startDateTime [startDateTime]`
+: The date and time when the task is scheduled to start. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When you specify the values for `categories`, each category can correspond to the displayName property of an [outlookCategory](https://learn.microsoft.com/en-us/graph/api/resources/outlookcategory?view=graph-rest-1.0). It is permissible to use distinct names.
+
 ## Examples
 
 Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with a specific name
@@ -68,6 +81,18 @@ Update a task with due date in Microsoft To Do tasks list with list id
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
 ```
 
+Update a task to Microsoft To Do with several categories
+
+```sh
+m365 todo task set --title "New task" --listName "My task list" --categories "Red category,Important"
+```
+
+Update a task to Microsoft To Do with a start date and set a reminder for the task
+
+```sh
+m365 todo task set --title "New task" --listName "My task list" --startDateTime "2023-12-16T18:28:48.6964197Z" --isReminderOn true
+```
+
 ## Response
 
 === "JSON"
@@ -121,3 +146,28 @@ m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMAB
     importance,isReminderOn,status,title,createdDateTime,lastModifiedDateTime,hasAttachments,categories,id,body,dueDateTime,reminderDateTime
     high,1,notStarted,Update doco,2022-10-29T11:03:20.9175176Z,2022-10-30T14:09:14.7687057Z,,[],AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=,"{""content"":""I should not forget this"",""contentType"":""text""}","{""dateTime"":""2023-01-01T00:00:00.0000000"",""timeZone"":""UTC""}","{""dateTime"":""2023-01-01T12:00:00.0000000"",""timeZone"":""UTC""}"
     ```
+
+=== "Markdown"
+
+    ```md
+    # todo task set --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=" --title "Update doco" --listName "My task list" --status "notStarted"
+
+    Date: 4/3/2023
+
+    ## Update doco (AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=)
+
+    Property | Value
+    ---------|-------
+    importance | high
+    isReminderOn | true
+    status | notStarted
+    title | Update doco
+    createdDateTime | 2022-10-29T11:03:20.9175176Z
+    lastModifiedDateTime | 2022-10-30T14:07:03.0718199Z
+    hasAttachments | false
+    categories | []
+    id | AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=
+    body | {"content":"I should not forget this","contentType":"text"}
+    dueDateTime | {"dateTime": "2023-01-01T00:00:00.0000000","timeZone": "UTC"}
+    reminderDateTime |  {"dateTime": "2023-01-01T12:00:00.0000000","timeZone": "UTC"}
+    ```