@pnp/cli-microsoft365 6.2.0-beta.edaa477 → 6.3.0-beta.c3dc921

package/docs/docs/cmd/spo/cdn/cdn-origin-add.md

@@ -35,4 +35,4 @@ m365 spo cdn origin add --type Public --origin */CDN
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-origin-list.md

@@ -38,4 +38,4 @@ m365 spo cdn origin list --type Private
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-origin-remove.md

@@ -38,4 +38,4 @@ m365 spo cdn origin remove --type Public --origin */CDN
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-policy-list.md

@@ -38,4 +38,4 @@ m365 spo cdn policy list --cdnType Private
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-policy-set.md

@@ -38,4 +38,4 @@ m365 spo cdn policy set --cdnType Public --policy IncludeFileExtensions --value
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

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

@@ -66,4 +66,4 @@ m365 spo cdn set --type Both --enabled true --noDefaultOrigins
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

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

@@ -0,0 +1,47 @@
+# spo file retentionlabel ensure
+
+Apply a retention label to a file
+
+## Usage
+
+```sh
+m365 spo file retentionlabel ensure [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the retentionlabel from a file to apply is located
+
+`--fileUrl [fileUrl]`
+: The site- or server relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
+
+`i, --fileId [fileId]`
+: The UniqueId (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
+
+`--name <name>`
+: Name of the retention label to apply to the file.
+
+--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.
+
+## Examples
+
+Applies a retention label to a file based on the label name and the fileUrl
+
+```sh
+m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/Shared Documents/Document.docx' --name 'Some label'
+```
+
+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'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,43 @@
+# spo file retentionlabel remove
+
+Clears the retention label from a file
+
+## Usage
+
+```sh
+m365 spo file retentionlabel remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the retentionlabel from a file to remove is located
+
+`--fileUrl [fileUrl]`
+: The site- or server relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
+
+`-i, --fileId [fileId]`
+: The UniqueId (GUID) of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
+
+`--confirm`
+: Don't prompt for confirming removing the retention label from a file
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the retention label from a file in a given site based on the file id
+
+```sh
+m365 spo file retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --fileId 0cd891ef-afce-4e55-b836-fce03286cccf
+```
+
+Removes the retention label from a file in a given site based on the file url
+
+```sh
+m365 spo file retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl /sites/project-x/Shared Documents/Document.docx --id 1
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,89 @@
+# spo file sharinglink add
+
+Creates a new sharing link for a file
+
+## Usage
+
+```sh
+m365 spo file sharinglink add [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.
+
+`--type <type>`
+: The type of sharing link to create. Either `view` or `edit`.
+
+`--expirationDateTime [expirationDateTime]`
+: The date and time to set the expiration. This should be defined as a valid ISO 8601 string.
+
+`--scope [scope]`
+: The scope of link to create. Either `anonymous` or `organization`. If not specified, the default of the organization will be used.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Creates a sharing link of a specific type for a file by id
+
+```sh
+m365 spo file sharinglink add --webUrl https://contoso.sharepoint.com --fileId daebb04b-a773-4baa-b1d1-3625418e3234 --type view
+```
+
+Creates a sharing link of a specific type for a file by url
+
+```sh
+m365 spo file sharinglink add --webUrl https://contoso.sharepoint.com --fileUrl "/sites/demo/Shared Documents/Test1.docx" --type edit
+```
+
+Creates a sharing link of a file by url with type, scope and expirationDateTime parameter
+
+```sh
+m365 spo file sharinglink add --webUrl https://contoso.sharepoint.com --fileUrl "/sites/demo/Shared Documents/Test1.docx" --type edit --scope anonymous --expirationDateTime "2023-01-09T16:20:00Z"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "1e581e93-609e-4077-8152-c43865db684c",
+      "roles": [
+        "read"
+      ],
+      "expirationDateTime": "2023-10-01T07:00:00Z",
+      "hasPassword": false,
+      "link": {
+        "scope": "anonymous",
+        "type": "view",
+        "webUrl": "https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBSyMcgRPtyAxqqNAeiEp1kg",
+        "preventsDownload": false
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    hasPassword       : false
+    expirationDateTime: 2023-10-01T07:00:00Z
+    id                : 1e581e93-609e-4077-8152-c43865db684c
+    link              : {"scope":"anonymous","type":"view","webUrl":"https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBSyMcgRPtyAxqqNAeiEp1kg","preventsDownload":false}
+    roles             : ["read"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,expirationDateTime,roles,hasPassword,link
+    1e581e93-609e-4077-8152-c43865db684c,2023-10-01T07:00:00Z,"[""read""]",,"{""scope"":""anonymous"",""type"":""view"",""webUrl"":""https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBSyMcgRPtyAxqqNAeiEp1kg"",""preventsDownload"":false}"
+    ```

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

@@ -13,10 +13,10 @@ m365 spo file sharinglink list [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file is located.
 
-`-f, --fileUrl [fileUrl]`
+`--fileUrl [fileUrl]`
 : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
 
-`-i, --fileId [fileId]`
+`--fileId [fileId]`
 : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
 
 `--scope [scope]`

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

@@ -0,0 +1,47 @@
+# spo folder retentionlabel ensure
+
+Apply a retention label to a folder
+
+## Usage
+
+```sh
+m365 spo folder retentionlabel ensure [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the retentionlabel from a file to apply is located
+
+`--folderUrl [folderUrl]`
+: The site- or server relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
+
+`i, --folderId [folderId]`
+: The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
+
+`--name <name>`
+: Name of the retention label to apply to the folder.
+
+--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.
+
+## Examples
+
+Applies a retention label to a folder based on the label name and the folderUrl
+
+```sh
+m365 spo folder retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl '/Shared Documents' --name 'Some label'
+```
+
+Applies a retention label to a folder based on the label name and the folderId
+
+```sh
+m365 spo folder retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --folderId '26541f96-017c-4189-a604-599e083533b8'  --name 'Some label'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.md

@@ -0,0 +1,43 @@
+# spo folder retentionlabel remove
+
+Clears the retention label from a folder
+
+## Usage
+
+```sh
+m365 spo folder retentionlabel remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The url of the web.
+
+`--folderUrl [folderUrl]`
+: The site- or server relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
+
+`-i, --folderId [folderId]`
+: The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
+
+`--confirm`
+: Don't prompt for confirming to remove the label.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the retention label from a folder in a given site based on the folder id
+
+```sh
+m365 spo folder retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderId 0cd891ef-afce-4e55-b836-fce03286cccf
+```
+
+Removes the retention label from a folder in a given site based on the folder url
+
+```sh
+m365 spo folder retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl /sites/project-x/Shared Documents/Folder --id 1
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -25,9 +25,6 @@ m365 spo list add [options]
 `--templateFeatureId [templateFeatureId]`
 : The globally unique identifier (GUID) of a template feature that is associated with the list
 
-`--schemaXml [schemaXml]`
-: The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
-
 `--allowDeletion [allowDeletion]`
 : Boolean value specifying whether the list can be deleted. Valid values are `true,false`
 
@@ -199,6 +196,9 @@ m365 spo list add [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
@@ -209,12 +209,6 @@ Add a list with title _Announcements_ and baseTemplate _Announcements_ in site _
 m365 spo list add --title Announcements --baseTemplate Announcements --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Add a list with title _Announcements_, baseTemplate _Announcements_ in site _https://contoso.sharepoint.com/sites/project-x_ using a custom XML schema
-
-```sh
-m365 spo list add --title Announcements --baseTemplate Announcements --webUrl https://contoso.sharepoint.com/sites/project-x --schemaXml '<List xmlns:ows="Microsoft SharePoint" Title="List1" FolderCreation="FALSE" Direction="$Resources:Direction;" Url="Lists/List1" BaseType="0" xmlns="http://schemas.microsoft.com/sharepoint/"><MetaData><ContentTypes><ContentTypeRef ID="0x01"><Folder TargetName="Item" /></ContentTypeRef><ContentTypeRef ID="0x0120" /></ContentTypes><Fields><Field ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Type="Text" Name="Title" DisplayName="$Resources:core,Title;" Required="TRUE" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Title" MaxLength="255" /></Fields><Views><View BaseViewID="0" Type="HTML" MobileView="TRUE" TabularView="FALSE"><Toolbar Type="Standard" /><XslLink Default="TRUE">main.xsl</XslLink><RowLimit Paged="TRUE">30</RowLimit><ViewFields><FieldRef Name="LinkTitleNoMenu"></FieldRef></ViewFields><Query><OrderBy><FieldRef Name="Modified" Ascending="FALSE"></FieldRef></OrderBy></Query><ParameterBindings><ParameterBinding Name="AddNewAnnouncement" Location="Resource(wss,addnewitem)" /><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY_ONET_HOME)" /></ParameterBindings></View><View BaseViewID="1" Type="HTML" WebPartZoneID="Main" DisplayName="$Resources:core,objectiv_schema_mwsidcamlidC24;" DefaultView="TRUE" MobileView="TRUE" MobileDefaultView="TRUE" SetupPath="pages\viewpage.aspx" ImageUrl="/_layouts/15/images/generic.png?rev=23" Url="AllItems.aspx"><Toolbar Type="Standard" /><XslLink Default="TRUE">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><RowLimit Paged="TRUE">30</RowLimit><ViewFields><FieldRef Name="LinkTitle"></FieldRef></ViewFields><Query><OrderBy><FieldRef Name="ID"></FieldRef></OrderBy></Query><ParameterBindings><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY_DEFAULT)" /></ParameterBindings></View></Views><Forms><Form Type="DisplayForm" Url="DispForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /><Form Type="EditForm" Url="EditForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /><Form Type="NewForm" Url="NewForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /></Forms></MetaData></List>'
-```
-
 Add a list with title _Announcements_, baseTemplate _Announcements_ in site _https://contoso.sharepoint.com/sites/project-x_ with content types and versioning enabled and major version limit set to _50_
 
 ```sh

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

@@ -0,0 +1,52 @@
+# spo list retentionlabel remove
+
+Clears the retention label on the specified list or library.
+
+## Usage
+
+```sh
+m365 spo list retentionlabel remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the list is located.
+
+`-t, --listTitle [listTitle]`
+: The title of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`-i, --listId [listId]`
+: The ID of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`-l, --listUrl [listUrl]`
+: Server- or web-relative URL of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Clears the retention label on a given list by URL
+
+```sh
+m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents'
+```
+
+Clears the retention label on a given list by title
+
+```sh
+m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents'
+```
+
+Clears the retention label on a given list by ID without confirmation
+
+```sh
+m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 'Documents' --confirm
+```
+
+## Response
+
+The command won't return a response on success.

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/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""}",[],[],[]
+    ```