@pnp/cli-microsoft365 11.4.0-beta.312ca0b → 11.4.0-beta.37c2235

package/docs/docs/cmd/spo/file/file-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file add
 
@@ -28,6 +30,12 @@ m365 spo file add [options]
 `--checkOut [checkOut]`
 : If versioning is enabled, this will check out the file first if it exists, upload the file, then check it in again.
 
+`--overwrite [overwrite]`
+: Overwrite the file if it already exists in the target folder. Possible values: `true`, `false`. Default is `true`.
+
+`--fileName [fileName]`
+: The name of the file in SharePoint after upload. If not specified, the name of the uploaded file will be used.
+
 `--checkInComment [checkInComment]`
 : Comment to set when checking the file in.
 
@@ -50,6 +58,25 @@ m365 spo file add [options]
 
 This command allows using unknown properties. Each property corresponds to the list item field that should be set when uploading the file.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds the specified file to the specified site in the specified folder.
@@ -70,6 +97,12 @@ Adds the specified file to the specified site in the specified folder specifying
 m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder '/sites/project-x/Shared Documents' --path 'C:\MS365.jpg'
 ```
 
+Uploads a file to SharePoint with a different name.
+
+```sh
+m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --fileName 'MS365-New.jpg'
+```
+
 Adds the specified file to the specified site in the specified folder with specified content type.
 
 ```sh
@@ -156,7 +189,113 @@ m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --fold
 
 ## Response
 
-The command won't return a response on success.
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "CheckInComment": "",
+    "CheckOutType": 2,
+    "ContentTag": "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5",
+    "CustomizedPageStatus": 0,
+    "ETag": "\"{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2\"",
+    "Exists": true,
+    "ExistsAllowThrowForPolicyFailures": true,
+    "ExistsWithException": true,
+    "IrmEnabled": false,
+    "Length": "19555",
+    "Level": 1,
+    "LinkingUri": "https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799",
+    "LinkingUrl": "https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799",
+    "MajorVersion": 1,
+    "MinorVersion": 0,
+    "Name": "Yearly report.xlsx",
+    "ServerRelativeUrl": "/sites/Finance/YearlyReports/Yearly report.xlsx",
+    "TimeCreated": "2026-01-07T10:50:38Z",
+    "TimeLastModified": "2026-01-07T10:50:38Z",
+    "Title": "",
+    "UIVersion": 512,
+    "UIVersionLabel": "1.0",
+    "UniqueId": "56b8e3c8-8e8a-4600-b9e1-a63d27391799"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  CheckInComment                   :
+  CheckOutType                     : 2
+  ContentTag                       : {56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5
+  CustomizedPageStatus             : 0
+  ETag                             : "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2"
+  Exists                           : true
+  ExistsAllowThrowForPolicyFailures: true
+  ExistsWithException              : true
+  IrmEnabled                       : false
+  Length                           : 19555
+  Level                            : 1
+  LinkingUri                       : https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  LinkingUrl                       : https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  MajorVersion                     : 2
+  MinorVersion                     : 0
+  Name                             : Yearly report.xlsx
+  ServerRelativeUrl                : /sites/Finance/YearlyReports/Yearly report.xlsx
+  TimeCreated                      : 2026-01-07T10:50:38Z
+  TimeLastModified                 : 2026-01-07T10:50:38Z
+  Title                            :
+  UIVersion                        : 512
+  UIVersionLabel                   : 1.0
+  UniqueId                         : 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,ExistsAllowThrowForPolicyFailures,ExistsWithException,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
+  ,2,"{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5",0,"""{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2""",1,1,1,0,19555,1,https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799,https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799,3,0,Yearly report.xlsx,/sites/Finance/YearlyReports/Yearly report.xlsx,2026-01-07T10:50:38Z,2026-01-07T10:50:38Z,,512,1.0,56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo file add --webUrl "https://contoso.sharepoint.com/sites/Finance" --folder "/YearlyReports" --path "C:\Yearly report.xlsx"
+
+  Date: 07/01/2026
+
+  ## 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+
+  Property | Value
+  ---------|-------
+  CheckInComment |
+  CheckOutType | 2
+  ContentTag | {56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5
+  CustomizedPageStatus | 0
+  ETag | "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2"
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  ExistsWithException | true
+  IrmEnabled | false
+  Length | 19555
+  Level | 1
+  LinkingUri | https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  LinkingUrl | https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  MajorVersion | 4
+  MinorVersion | 0
+  Name | Yearly report.xlsx
+  ServerRelativeUrl | /sites/Finance/YearlyReports/Yearly report.xlsx
+  TimeCreated | 2026-01-07T10:50:38Z
+  TimeLastModified | 2026-01-07T10:50:38Z
+  Title |
+  UIVersion | 512
+  UIVersionLabel | 1.0
+  UniqueId | 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+</Tabs>
 
 ## More information
 

package/docs/docs/cmd/spo/page/page-header-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo page header set
 
@@ -40,11 +42,14 @@ m365 spo page header set [options]
 `--textAlignment [textAlignment]`
 : How to align text in the header. Allowed values `Center`, `Left`. Default `Left`.
 
-`--showTopicHeader`
-: Set, to show the topic header.
+`--showTopicHeader [showTopicHeader]`
+: Show the topic header. Valid values: `true`, `false`. Defaults to `false`.
 
-`--showPublishDate`
-: Set, to show the publishing date.
+`--showPublishDate [showPublishDate]`
+: Show the publishing date. Valid values: `true`, `false`. Defaults to `false`.
+
+`--showTimeToRead [showTimeToRead]`
+: Show the estimated time to read the page. Valid values: `true`, `false`. Defaults to `false`.
 
 `--topicHeader [topicHeader]`
 : Text to show in the topic header, when `showTopicHeader` is set.
@@ -55,9 +60,24 @@ m365 spo page header set [options]
 
 <Global />
 
-## Remarks
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
 
-If the specified `name` doesn't refer to an existing modern page, you will get a `File doesn't exists` error.
+  </TabItem>
+</Tabs>
 
 ## Examples
 
@@ -79,10 +99,10 @@ Use the specified image focused on the given coordinates in the page header
 m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --type Custom --imageUrl /sites/team-a/SiteAssets/hero.jpg --altText 'Sunset over the ocean' --translateX 42.3837520042758 --translateY 56.4285714285714
 ```
 
-Center the page title in the header and show the publishing date
+Center the page title in the header and show the publishing date and time to read
 
 ```sh
-m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --textAlignment Center --showPublishDate
+m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --textAlignment Center --showPublishDate true --showTimeToRead true
 ```
 
 ## Response

package/docs/docs/cmd/spo/page/page-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo page set
 
@@ -20,16 +22,19 @@ m365 spo page set [options]
 : URL of the site where the page to update is located.
 
 `-l, --layoutType [layoutType]`
-: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`.
+: Layout of the page. Allowed values: `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`.
 
 `-p, --promoteAs [promoteAs]`
-: Update the page purpose. Allowed values `HomePage`, `NewsPage`, `Template`.
+: Update the page purpose. Allowed values: `HomePage`, `NewsPage`, `Template`.
 
 `--demoteFrom [demoteFrom]`
-: Update the page purpose back to a regular article. Allowed values `NewsPage`.
+: Update the page purpose back to a regular article. Allowed values: `NewsPage`.
 
 `--commentsEnabled [commentsEnabled]`
-: Set to `true`, to enable comments on the page. Allowed values `true`, `false`.
+: Set to `true`, to enable comments on the page. Allowed values: `true`, `false`.
+
+`--isRetired [isRetired]`
+: Marks the page as retired, showing a message that the page may be out of date. Allowed values: `true`, `false`.
 
 `--publish`
 : Set to publish the page.
@@ -69,6 +74,25 @@ When using the `--content` option it's possible to enter a JSON string. In Power
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Change the layout of the existing page to _Article_
@@ -89,7 +113,7 @@ Promote the existing article page as a template
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --promoteAs Template
 ```
 
-Demote the existing newspage
+Demote the existing news page
 
 ```sh
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --demoteFrom NewsPage
@@ -119,6 +143,12 @@ Set page description
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"
 ```
 
+Marks a page as retired
+
+```sh
+m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --isRetired true
+```
+
 Set page content
 
 ```sh

package/docs/docs/cmd/teams/chat/chat-message-list.mdx

@@ -16,11 +16,33 @@ m365 teams chat message list [options]
 
 ```md definition-list
 `-i, --chatId <chatId>`
-: The ID of the chat conversation
+: The ID of the chat conversation.
+
+`--endDateTime [endDateTime]`
+: Time indicating the exclusive end of a time range when the message was created.
 ```
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions      |
+  |-----------------|------------------|
+  | Microsoft Graph | ChatMessage.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | ChatMessage.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List the messages from a Microsoft Teams chat conversation
@@ -29,6 +51,12 @@ List the messages from a Microsoft Teams chat conversation
 m365 teams chat message list --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
 ```
 
+List messages from a Microsoft Teams chat conversation created before November 1, 2022
+
+```sh
+m365 teams chat message list --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2 --endDateTime 2022-11-01T00:00:00Z
+```
+
 ## Response
 
 <Tabs>
@@ -79,17 +107,17 @@ m365 teams chat message list --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread
   <TabItem value="Text">
 
   ```text
-  id             shortBody
-  -------------  -------------------------
-  1667653590582  <p>Hello world</p>
+  id             createdDateTime           shortBody
+  -------------  ------------------------  ------------------
+  1667653590582  2022-11-05T13:06:30.582Z  <p>Hello world</p>
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  id,shortBody
-  1667653590582,<p>Hello world</p>
+  id,createdDateTime,shortBody
+  1667653590582,2022-11-05T13:06:30.582Z,<p>Hello world</p>
   ```
 
   </TabItem>
@@ -118,4 +146,3 @@ m365 teams chat message list --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/teams/chat/chat-message-send.mdx

@@ -1,3 +1,5 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 import Global from '/docs/cmd/_global.mdx';
 
 # teams chat message send
@@ -24,6 +26,9 @@ m365 teams chat message send [options]
 
 `-m, --message <message>`
 : The message to send
+
+`--contentType [contentType]`
+: The content type of the message. Allowed values are `text` and `html`. Default is `text`.
 ```
 
 <Global />
@@ -32,12 +37,29 @@ m365 teams chat message send [options]
 
 A new chat conversation will be created if no existing conversation with the participants specified with emails is found.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | Chat.Read, ChatMessage.Send |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Send a message to a Microsoft Teams chat conversation by id
 
 ```sh
-m365 teams chat message send --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2 --message "Welcome to Teams"
+m365 teams chat message send --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2 --message "<b>Welcome</b> to Teams" --contentType html
 ```
 
 Send a message to a single person