@pnp/cli-microsoft365 6.2.0-beta.d0cdaa3 → 6.2.0-beta.d5442a1

package/docs/docs/cmd/planner/plan/plan-get.md

@@ -118,3 +118,24 @@ m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
     id,title,createdDateTime,owner
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner plan get --id "xqQg5FS2LkCp935s-FIFm2QAFkHM"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    sharedWith | {"aa089c1a-0ca8-4b36-ae2e-c5d60f054a2c":true,"ebf3b108-5234-4e22-b93d-656d7dae5874":true}
+    categoryDescriptions | {"category1":null,"category2":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null}
+    ```

package/docs/docs/cmd/planner/plan/plan-list.md

@@ -76,3 +76,22 @@ m365 planner plan list --ownerGroupName "My Planner Group"
     id,title,createdDateTime,owner
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner plan list --ownerGroupId "ebf3b108-5234-4e22-b93d-656d7dae5874"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2021-12-12T14:00:50.4522129Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"09abbdfd-ed23-44ee-a2d9-a627aa1c90f3"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    ```

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

@@ -142,3 +142,23 @@ m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
 
+=== "Markdown"
+
+    ```md
+    # planner plan set --id "xqQg5FS2LkCp935s-FIFm2QAFkHM" --newTitle "My Planner Plan"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    sharedWith | {"ebf3b108-5234-4e22-b93d-656d7dae5874":true,"6463a5ce-2119-4198-9f2a-628761df4a62":true}
+    categoryDescriptions | {"category1":null,"category2":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null}
+    ```

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-list.md

@@ -0,0 +1,95 @@
+# pp aibuildermodel list
+
+List available AI builder models in the specified Power Platform environment
+
+## Usage
+
+```sh
+pp aibuildermodel list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all AI Builder models in a specific environment
+
+```sh
+m365 pp aibuildermodel list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+```
+
+List all AI Builder models in a specific environment as admin
+
+```sh
+m365 pp aibuildermodel list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "statecode": 0,
+        "_msdyn_templateid_value": "10707e4e-1d56-e911-8194-000d3a6cd5a5",
+        "msdyn_modelcreationcontext": "{}",
+        "createdon": "2022-11-29T11:58:45Z",
+        "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "modifiedon": "2022-11-29T11:58:45Z",
+        "msdyn_sharewithorganizationoncreate": false,
+        "msdyn_aimodelidunique": "b0328b67-47e2-4202-8189-e617ec9a88bd",
+        "solutionid": "fd140aae-4df4-11dd-bd17-0019b9312238",
+        "ismanaged": false,
+        "versionnumber": 1458121,
+        "msdyn_name": "Document Processing 11/29/2022, 12:58:43 PM",
+        "introducedversion": "1.0",
+        "statuscode": 0,
+        "_modifiedby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "overwritetime": "1900-01-01T00:00:00Z",
+        "componentstate": 0,
+        "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "msdyn_aimodelid": "08ffffbe-ec1c-4e64-b64b-dd1db926c613",
+        "_msdyn_activerunconfigurationid_value": null,
+        "overriddencreatedon": null,
+        "_msdyn_retrainworkflowid_value": null,
+        "importsequencenumber": null,
+        "_msdyn_scheduleinferenceworkflowid_value": null,
+        "_modifiedonbehalfby_value": null,
+        "utcconversiontimezonecode": null,
+        "_createdonbehalfby_value": null,
+        "_owningteam_value": null,
+        "timezoneruleversionnumber": null,
+        "iscustomizable": {
+          "Value": true,
+          "CanBeChanged": true,
+          "ManagedPropertyLogicalName": "iscustomizableanddeletable"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    createdon             modifiedon            msdyn_aimodelid                       msdyn_name
+    --------------------  --------------------  ------------------------------------  -------------------------------------------
+    2022-10-25T14:44:48Z  2022-10-25T14:44:48Z  08ffffbe-ec1c-4e64-b64b-dd1db926c613  Document Processing 11/29/2022, 12:58:43 PM
+    ```
+
+=== "CSV"
+
+    ```csv
+    msdyn_name,msdyn_aimodelid,createdon,modifiedon
+    "Document Processing 11/29/2022, 12:58:43 PM",08ffffbe-ec1c-4e64-b64b-dd1db926c613,2022-11-29T11:58:45Z,2022-11-29T11:58:45Z
+    ```

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-get.md

@@ -0,0 +1,95 @@
+# purview retentionlabel get
+
+Get a retention label
+
+## Usage
+
+```sh
+m365 purview retentionlabel get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention label.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a retention label
+
+```sh
+m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## Response
+
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "TEST LABEL",
+      "descriptionForAdmins": "",
+      "descriptionForUsers": "",
+      "isInUse": false,
+      "retentionTrigger": "dateCreated",
+      "behaviorDuringRetentionPeriod": "retain",
+      "actionAfterRetentionPeriod": "delete",
+      "createdDateTime": "2022-12-12T15:14:53Z",
+      "lastModifiedDateTime": "2022-12-12T15:43:06Z",
+      "labelToBeApplied": "",
+      "defaultRecordBehavior": "startLocked",
+      "id": "5c8af2e2-b489-4fa0-9c16-180180245ac8",
+      "retentionDuration": {
+        "days": 100
+      },
+      "createdBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "lastModifiedBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "dispositionReviewStages": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    actionAfterRetentionPeriod   : delete
+    behaviorDuringRetentionPeriod: retain
+    createdBy                    : {"user":{"id":null,"displayName":"John Doe"}}
+    createdDateTime              : 2022-12-12T15:14:53Z
+    defaultRecordBehavior        : startLocked
+    descriptionForAdmins         :
+    descriptionForUsers          :
+    displayName                  : TEST LABEL
+    dispositionReviewStages      : []
+    id                           : 5c8af2e2-b489-4fa0-9c16-180180245ac8
+    isInUse                      : false
+    labelToBeApplied             :
+    lastModifiedBy               : {"user":{"id":null,"displayName":"John Doe"}}
+    lastModifiedDateTime         : 2022-12-12T15:43:06Z
+    retentionDuration            : {"days":100}
+    retentionTrigger             : dateCreated
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,descriptionForAdmins,descriptionForUsers,isInUse,retentionTrigger,behaviorDuringRetentionPeriod,actionAfterRetentionPeriod,createdDateTime,lastModifiedDateTime,labelToBeApplied,defaultRecordBehavior,id,retentionDuration,createdBy,lastModifiedBy,dispositionReviewStages
+    TEST LABEL,,,,dateCreated,retain,delete,2022-12-12T15:14:53Z,2022-12-12T15:43:06Z,,startLocked,5c8af2e2-b489-4fa0-9c16-180180245ac8,"{""days"":100}","{""user"":{""id"":null,""displayName"":""John Doe""}}","{""user"":{""id"":null,""displayName"":""John Doe""}}",[]
+    ```

package/docs/docs/cmd/spo/file/file-sharinglink-list.md

@@ -0,0 +1,97 @@
+# spo file sharinglink list
+
+Lists all the sharing links of a specific file
+
+## Usage
+
+```sh
+m365 spo file sharinglink list [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`-f, --fileUrl [fileUrl]`
+: The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`-i, --fileId [fileId]`
+: The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List sharing links of a file by id
+
+```sh
+m365 spo file sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --fileId daebb04b-a773-4baa-b1d1-3625418e3234
+```
+
+List sharing links of a file by url
+
+```sh
+m365 spo file sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --fileUrl "/sites/demo/shared documents/document.docx"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "2a021f54-90a2-4016-b3b3-5f34d2e7d932",
+        "roles": [
+          "read"
+        ],
+        "hasPassword": false,
+        "grantedToIdentitiesV2": [
+          {
+            "user": {
+              "displayName": "John Doe",
+              "email": "john@contoso.onmicrosoft.com",
+              "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a"
+            },
+            "siteUser": {
+              "displayName": "John Doe",
+              "email": "john@contoso.onmicrosoft.com",
+              "id": "9",
+              "loginName": "i:0#.f|membership|john@contoso.onmicrosoft.com"
+            }
+          }
+        ],
+        "grantedToIdentities": [ 
+          {
+            "user": {
+              "displayName": "John Doe",
+              "email": "john@contoso.onmicrosoft.com",
+              "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a"
+            }
+          }
+        ],
+        "link": {
+          "scope": "anonymous",
+          "type": "view",
+          "webUrl": "https://contoso.sharepoint.com/:b:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A",
+          "preventsDownload": false
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    roles  link
+    ------------------------------------  -----  -----------------------------------------------------------------------------------------------------------
+    2a021f54-90a2-4016-b3b3-5f34d2e7d932  read   https://contoso.sharepoint.com/:b:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,roles,link
+    2a021f54-90a2-4016-b3b3-5f34d2e7d932,read,https://contoso.sharepoint.com/:b:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A
+    ```

package/docs/docs/cmd/spo/group/group-member-remove.md

@@ -20,36 +20,54 @@ m365 spo group member remove [options]
 : Name of the SharePoint group from which user has to be removed. Specify either `groupName` or `groupId`, but not both.
 
 `--userName [userName]`
-: The UPN (user principal name, eg. megan.bowen@contoso.com) of the user that needs to be removed. Specify either `userName`, `email`, or `userId`, but not multiple.
+: The UPN (user principal name, eg. megan.bowen@contoso.com) of the user that needs to be removed. Specify either `userName`, `email`, `userId`, `aadGroupId` or `aadGroupName`.
 
 `--email [email]`
-: The email of the user to remove as a member. Specify either `userName`, `email`, or `userId`, but not multiple.
+: The email of the user to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId` or `aadGroupName`.
 
 `--userId [userId]`
-: The user Id (Id of the site user, eg. 14) of the user to remove as a member. Specify either `userName`, `email`, or `userId`, but not multiple.
+: The user Id (Id of the site user, eg. 14) of the user to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId` or `aadGroupName`.
+
+`--aadGroupId [aadGroupId]`
+: The object Id of the Azure AD group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId` or `aadGroupName`.
+
+`--aadGroupName [aadGroupName]`
+: The name of the Azure AD group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId` or `aadGroupName`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Remove a user from a SharePoint group by userName.
+Remove a user from a SharePoint group based on the id on a given web
 
 ```sh
 m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
 ```
 
-Remove a user from a SharePoint group by email.
+Remove a user from a SharePoint group based on the username on a given web
 
 ```sh
 m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --email "Alex.Wilber@contoso.com"
 ```
 
-Remove a user from a SharePoint group by id.
+Remove a user from a SharePoint group by email.
 
 ```sh
 m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --userId 14
 ```
 
+Remove an Azure AD group from a SharePoint group based on the Azure AD group name on a given web
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --aadGroupName "Azure AD Security Group"
+```
+
+Remove an Azure AD group from a SharePoint group based on the Azure AD group ID on a given web
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --aadGroupId "5786b8e8-c495-4734-b345-756733960730"
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -19,8 +19,11 @@ m365 spo list label set [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the list is located.
 
+`--name <name>`
+: The label name to set on the list.
+
 `--label <label>`
-: The label to set on the list.
+: (deprecated. Use `name` instead) The label name to set on the list.
 
 `-t, --listTitle [listTitle]`
 : The title of the list on which to set the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
@@ -48,16 +51,16 @@ A list retention label is a default label that will be applied to all new items
 
 ## Examples
 
-Sets retention label on the list with specified site-relative URL located in the specified site.
+Sets a retention label by name on a given list
 
 ```sh
-m365 spo list retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents' --label 'Some label'
+m365 spo list retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents' --name 'Some label'
 ```
 
-Sets retention label and disables editing and deleting items on the list and all existing items for the list with specified title located in the specified site.
+Sets a retention label by name and disables editing and deleting items on the list and all existing items for a given list
 
 ```sh
-m365 spo list retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents' --label 'Some label' --blockEdit --blockDelete --syncToItems
+m365 spo list retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents' --name 'Some label' --blockEdit --blockDelete --syncToItems
 ```
 
 ## Response

package/docs/docs/cmd/spo/listitem/listitem-record-lock.md

@@ -0,0 +1,52 @@
+# spo listitem record lock
+
+Locks the list item record
+
+## Usage
+
+```sh
+m365 spo listitem record lock [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The url of the web
+
+`--listItemId <listItemId>`
+: ID of the list item that should be locked
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Locks the list item record in a given site based on the list id
+
+```sh
+m365 spo listitem record lock --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --listItemId 1
+```
+
+Locks the list item record in a given site based on the list title
+
+```sh
+m365 spo listitem record lock --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1
+```
+
+Locks the list item record in a given site based on the server relative list url
+
+```sh
+m365 spo listitem record lock --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/listitem/listitem-record-unlock.md

@@ -0,0 +1,52 @@
+# spo listitem record unlock
+
+Unlocks the list item record
+
+## Usage
+
+```sh
+m365 spo listitem record unlock [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The url of the web
+
+`--listItemId <listItemId>`
+: ID of the list item that should be unlocked
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Unlocks the list item record in a given site based on the list id
+
+```sh
+m365 spo listitem record unlock --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --listItemId 1
+```
+
+Unlocks the list item record in a given site based on the list title
+
+```sh
+m365 spo listitem record unlock --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1
+```
+
+Unlocks the list item record in a given site based on the server relative list url
+
+```sh
+m365 spo listitem record unlock --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,58 @@
+# spo listitem retentionlabel ensure
+
+Apply a retention label to a list item
+
+## Usage
+
+```sh
+m365 spo listitem retentionlabel ensure [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the retentionlabel from a listitem to apply is located
+
+`--listItemId <listItemId>`
+: The ID of the list item for which the retention label should be applied.
+
+`--listId [listId]`
+: ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listTitle [listTitle]`
+: Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`-n, --name [name]`
+: The name of the retention label. Specify either `name` or `id`.
+
+`-i, --id [id]`
+: The id of the retention label. Specify either `name` or `id`.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Applies the retention label _Some 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'
+```
+
+Applies a retention label to a list item in a given site based on the list title and label id
+
+```sh
+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
+
+```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'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -1,6 +1,6 @@
 # teams chat list
 
-Lists all Microsoft Teams chat conversations for the current user.
+Lists all Microsoft Teams chat conversations for the current or a specific user.
 
 ## Usage
 
@@ -10,9 +10,15 @@ m365 teams chat list [options]
 
 ## Options
 
-`-t, --type [chatType]`
+`-t, --type [type]`
 : The chat type to optionally filter chat conversations by type. The value can be `oneOnOne`, `group` or `meeting`.
 
+`--userId [userId]`
+: ID of the user. Has to be specified when using application permissions. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Has to be specified when using application permissions. Specify either `userId` or `userName`, but not both.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -23,10 +29,16 @@ List all the Microsoft Teams chat conversations of the current user.
 m365 teams chat list
 ```
 
-List only the one on one Microsoft Teams chat conversations.
+List only the one on one Microsoft Teams chat conversations of a specific user retrieved by id.
+
+```sh
+m365 teams chat list --userId e6296ed0-4b7d-4ace-aed4-f6b7371ce060 --type oneOnOne
+```
+
+List only the group Microsoft Teams chat conversations of a specific user retrieved by mail
 
 ```sh
-m365 teams chat list --type oneOnOne
+m365 teams chat list --userName 'john@contoso.com' --type group 
 ```
 
 ## Response