@pnp/cli-microsoft365 6.1.0 → 6.2.0-beta.02615ee

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

@@ -0,0 +1,106 @@
+# 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.
+
+`--scope [scope]`
+: Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
+
+--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"
+```
+
+List anonymous 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" --scope anonymous
+```
+
+## 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": "organization",
+          "type": "view",
+          "webUrl": "https://contoso.sharepoint.com/:w:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A",
+          "preventsDownload": false
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    scope         roles  link                                                            
+    ------------------------------------  ------------  -----  ----------------------------------------------------------------------------------------
+    2a021f54-90a2-4016-b3b3-5f34d2e7d932  organization  read   https://contoso.sharepoint.com/:w:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,scope,roles,link
+    2a021f54-90a2-4016-b3b3-5f34d2e7d932,organization,read,https://contoso.sharepoint.com/:w:/s/demo/EY50lub3559MtRKfj2hrZqoBWnHOpGIcgi4gzw9XiWYJ-A
+    ```

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

@@ -0,0 +1,52 @@
+# spo file sharinglink remove
+
+Removes a specific sharing link of a file
+
+## Usage
+
+```sh
+m365 spo file sharinglink remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`--fileUrl [fileUrl]`
+: The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`--fileId [fileId]`
+: The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`-i, --id <id>`
+: The ID of the sharing link.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a specific sharing link from a file by id without prompting for confirmation.
+
+```sh
+m365 spo file sharinglink remove --webUrl https://contoso.sharepoint.com/sites/demo --fileId daebb04b-a773-4baa-b1d1-3625418e3234 --id c391b57d-5783-4c53-9236-cefb5c6ef323 --confirm
+```
+
+Removes a specific sharing link from a file by a specified site-relative URL.
+
+```sh
+m365 spo file sharinglink remove --webUrl https://contoso.sharepoint.com/sites/demo --fileUrl 'Shared Documents/document.docx' --id c391b57d-5783-4c53-9236-cefb5c6ef323
+```
+
+Removes a specific sharing link from a file by a specified server-relative URL.
+
+```sh
+m365 spo file sharinglink remove --webUrl https://contoso.sharepoint.com/sites/demo --fileUrl '/sites/demo/Shared Documents/document.docx' --id c391b57d-5783-4c53-9236-cefb5c6ef323
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -20,19 +20,25 @@ m365 spo group member add [options]
 : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
 
 `--userName [userName]`
-: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--email [email]`
-: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
+: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--userId [userId]`
-: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Id's have to be comma separated. Specify either `userName`, `email` or `userId`
+: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+
+`--aadGroupId [aadGroupId]`
+: The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+
+`--aadGroupName [aadGroupName]`
+: The name of the Azure AD group to add as a member. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-For the `--userName` or `--email` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list invalid values.
+For the `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
 
 ## Examples
 
@@ -72,6 +78,18 @@ Add multiple users with the userId parameter to a SharePoint group with the grou
 m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
 ```
 
+Add multiple users with the aadUserId parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --aadUserId "56ca9023-3449-4e98-a96a-69e81a6f4983,a96c1755-8aec-4f4d-955f-08504510dc56"
+```
+
+Add multiple users with the aadUserName parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --aadUserName "Azure group one, Azure group two"
+```
+
 ## Response
 
 === "JSON"

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

@@ -13,14 +13,14 @@ m365 spo listitem list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site from which the item should be retrieved.
 
-`-i, --listId [listId]`
-: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both.
-
 `-l, --listId [listId]`
-: ID of the list where the item should be added. 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 where the item should be added. 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.
 
 `-q, --camlQuery [camlQuery]`
 : CAML query to use to query the list of items with.

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/spo/term/term-list.md

@@ -22,6 +22,9 @@ m365 spo term list [options]
 `--termSetName [termSetName]`
 : Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both
 
+`--includeChildTerms`
+: If specified, child terms are loaded as well.
+
 --8<-- "docs/cmd/_global.md"
 
 !!! important
@@ -40,3 +43,138 @@ List taxonomy terms from the term group and term set with the given ID
 ```sh
 m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec
 ```
+
+List taxonomy terms from the term group and term set with the given ID including child terms if any are found
+
+```sh
+m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --includeChildTerms
+```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "_ObjectType_": "SP.Taxonomy.Term",
+        "_ObjectIdentity_": "430486a0-200a-6000-02cc-2eb89d8dd424|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNsaKRf7N4K0qppo4zwLIRZg==",
+        "CreatedDate": "2021-10-12T09:42:44.880Z",
+        "Id": "7f91a2b1-78b3-4a2b-a9a6-8e33c0b21166",
+        "LastModifiedDate": "2021-10-12T09:42:45.237Z",
+        "Name": "Departments",
+        "CustomProperties": {},
+        "CustomSortOrder": null,
+        "IsAvailableForTagging": true,
+        "Owner": "i:0#.f|membership|admin@contoso.onmicrosoft.com",
+        "Description": "",
+        "IsDeprecated": false,
+        "IsKeyword": false,
+        "IsPinned": false,
+        "IsPinnedRoot": false,
+        "IsReused": false,
+        "IsRoot": true,
+        "IsSourceTerm": true,
+        "LocalCustomProperties": {
+          "Id": "termDepartments"
+        },
+        "MergedTermIds": [],
+        "PathOfTerm": "Departments",
+        "TermsCount": 1
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Name      
+    ------------------------------------  ---------
+    c387e91c-b553-4b92-886b-9af717cd73b0  Financing
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Name
+    c387e91c-b553-4b92-886b-9af717cd73b0,Financing
+    ```
+
+### `includeChildTerms` response
+
+When we make use of the option `includeChildTerms` the response will differ. 
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "_ObjectType_": "SP.Taxonomy.Term",
+        "_ObjectIdentity_": "430486a0-200a-6000-02cc-2eb89d8dd424|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNsaKRf7N4K0qppo4zwLIRZg==",
+        "CreatedDate": "2021-10-12T09:42:44.880Z",
+        "Id": "7f91a2b1-78b3-4a2b-a9a6-8e33c0b21166",
+        "LastModifiedDate": "2021-10-12T09:42:45.237Z",
+        "Name": "Departments",
+        "CustomProperties": {},
+        "CustomSortOrder": null,
+        "IsAvailableForTagging": true,
+        "Owner": "i:0#.f|membership|admin@contoso.onmicrosoft.com",
+        "Description": "",
+        "IsDeprecated": false,
+        "IsKeyword": false,
+        "IsPinned": false,
+        "IsPinnedRoot": false,
+        "IsReused": false,
+        "IsRoot": true,
+        "IsSourceTerm": true,
+        "LocalCustomProperties": {
+          "Id": "termDepartments"
+        },
+        "MergedTermIds": [],
+        "PathOfTerm": "Departments",
+        "TermsCount": 1,
+        "Children": [{
+          "_ObjectType_": "SP.Taxonomy.Term",
+          "_ObjectIdentity_": "d10486a0-4067-5000-de97-bf1ab5bff53c|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNf5ybB0mfG0Kx6YO5CODZ1A==",
+          "CreatedDate": "2022-12-25T23:59:15.200Z",
+          "Id": "079b9c7f-9f49-421b-b1e9-83b908e0d9d4",
+          "LastModifiedDate": "2022-12-25T23:59:15.200Z",
+          "Name": "Financing",
+          "CustomProperties": {},
+          "CustomSortOrder": null,
+          "IsAvailableForTagging": true,
+          "Owner": "i:0#.f|membership|admin@mathijsdev2.onmicrosoft.com",
+          "Description": "",
+          "IsDeprecated": false,
+          "IsKeyword": false,
+          "IsPinned": false,
+          "IsPinnedRoot": false,
+          "IsReused": false,
+          "IsRoot": false,
+          "IsSourceTerm": true,
+          "LocalCustomProperties": {},
+          "MergedTermIds": [],
+          "PathOfTerm": "Departments;Financing",
+          "TermsCount": 0
+        }]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Name       ParentTermId
+    ------------------------------------  ---------  ------------------------------------
+    c387e91c-b553-4b92-886b-9af717cd73b0  Financing  079b9c7f-9f49-421b-b1e9-83b908e0d9d4
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Name,ParentTermId
+    c387e91c-b553-4b92-886b-9af717cd73b0,Financing,079b9c7f-9f49-421b-b1e9-83b908e0d9d4
+    ```
+

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