@pnp/cli-microsoft365 6.2.0-beta.e162995 → 6.2.0-beta.ed6bb7b

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

@@ -178,9 +178,6 @@ m365 spo list set [options]
 `--restrictUserUpdates [restrictUserUpdates]`
 : A boolean value that indicates whether the this list is a restricted one or not The value can't be changed if there are existing items in the list
 
-`--schemaXml [schemaXml]`
-: The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
-
 `--sendToLocationName [sendToLocationName]`
 : Gets or sets a file name to use when copying an item in the list to another document library.
 
@@ -205,6 +202,9 @@ m365 spo list set [options]
 `--writeSecurity [writeSecurity]`
 : Gets or sets the Write security setting for the list. Valid values are 1 (All users can modify all items)|2 (Users can modify only items that they create)|4 (Users cannot modify any list item)
 
+`--schemaXml [schemaXml]`
+: (deprecated) The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples

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

@@ -11,25 +11,25 @@ m365 spo listitem get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which the item should be retrieved
+: URL of the site where the item is located.
 
 `-i, --id <id>`
 : ID of the item to retrieve.
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: 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`
+: 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`
+: 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
+: Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
 
 `--withPermissions`
-: Set if you want to return associated roles and permissions
+: Set if you want to return associated roles and permissions.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -39,37 +39,36 @@ If you want to specify a lookup type in the `properties` option, define which co
 
 ## Examples
 
-Get an item with the ID parameter from a given list in a given site
+Get an item with the ID parameter from a given list in a given site.
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Get an item columns with the ID parameter from a given list in a given site
+Get an item columns with the ID parameter from a given list in a given site.
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
 ```
 
-Get an item columns and lookup column with the ID parameter from a given list in a given site
+Get an item columns and lookup column with the ID parameter from a given list in a given site.
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
 
-Get an item with specific properties from a given list based on the server-relative URL in a specific site
+Get an item with specific properties from a given list based on the server-relative URL in a specific site.
 
 ```sh
 m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
 
-Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions
+Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions.
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
 ```
 
-
 ## Response
 
 === "JSON"

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

package/docs/docs/cmd/teams/message/message-send.md

@@ -0,0 +1,119 @@
+# teams message send
+
+Sends a message to a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message send [options]
+```
+
+## Options
+
+`-t, --teamId <teamId>`
+: The ID of the team where the channel is located.
+
+`-c, --channelId <channelId>`
+: The ID of the channel.
+
+`-m, --message <message>`
+: The message to send.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+You can only send a message to a channel in a Microsoft Teams team if you are a member of that team or channel.
+
+## Examples
+
+Send a message to a specified channel in a Microsoft Teams team.
+
+```sh
+m365 teams message send --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --message "Hello World!"
+```
+
+Send an HTML formatted message to a specified channel in a Microsoft Teams team.
+
+```sh
+m365 teams message send --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --message "Hello <b>World</b>!"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "1674320428077",
+      "replyToId": null,
+      "etag": "1674320428077",
+      "messageType": "message",
+      "createdDateTime": "2023-01-21T17:00:28.077Z",
+      "lastModifiedDateTime": "2023-01-21T17:00:28.077Z",
+      "lastEditedDateTime": null,
+      "deletedDateTime": null,
+      "subject": null,
+      "summary": null,
+      "chatId": null,
+      "importance": "normal",
+      "locale": "en-us",
+      "webUrl": "https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077",
+      "policyViolation": null,
+      "eventDetail": null,
+      "from": {
+        "application": null,
+        "device": null,
+        "user": {
+          "id": "b2091e18-7882-4efe-b7d1-90703f5a5c65",
+          "displayName": "John Doe",
+          "userIdentityType": "aadUser"
+        }
+      },
+      "body": {
+        "contentType": "html",
+        "content": "<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>"
+      },
+      "channelIdentity": {
+        "teamId": "6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2",
+        "channelId": "19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype"
+      },
+      "attachments": [],
+      "mentions": [],
+      "reactions": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    attachments         : []
+    body                : {"contentType":"html","content":"<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>"}
+    channelIdentity     : {"teamId":"6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2","channelId":"19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype"}
+    chatId              : null
+    createdDateTime     : 2023-01-21T17:04:52.284Z
+    deletedDateTime     : null
+    etag                : 1674320692284
+    eventDetail         : null
+    from                : {"application":null,"device":null,"user":{"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65","displayName":"John Doe","userIdentityType":"aadUser"}}
+    id                  : 1674320692284
+    importance          : normal
+    lastEditedDateTime  : null
+    lastModifiedDateTime: 2023-01-21T17:04:52.284Z
+    locale              : en-us
+    mentions            : []
+    messageType         : message
+    policyViolation     : null
+    reactions           : []
+    replyToId           : null
+    subject             : null
+    summary             : null
+    webUrl              : https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,replyToId,etag,messageType,createdDateTime,lastModifiedDateTime,lastEditedDateTime,deletedDateTime,subject,summary,chatId,importance,locale,webUrl,policyViolation,eventDetail,from,body,channelIdentity,attachments,mentions,reactions
+    1674320748808,,1674320748808,message,2023-01-21T17:05:48.808Z,2023-01-21T17:05:48.808Z,,,,,,normal,en-us,https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077,,,"{""application"":null,""device"":null,""user"":{""id"":""b2091e18-7882-4efe-b7d1-90703f5a5c65"",""displayName"":""John Doe"",""userIdentityType"":""aadUser""}}","{""contentType"":""html"",""content"":""<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>""}","{""teamId"":""6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2"",""channelId"":""19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype""}",[],[],[]
+    ```