@pnp/cli-microsoft365 11.4.0-beta.40f818c → 11.4.0-beta.f54089d

package/dist/m365/spo/commands/page/page-set.js

@@ -48,24 +48,20 @@ class SpoPageSetCommand extends SpoCommand {
         const serverRelativeFileUrl = `${listServerRelativeUrl}/${pageName}`;
         const listUrl = urlUtil.getServerRelativePath(args.options.webUrl, listServerRelativeUrl);
         const requestUrl = `${args.options.webUrl}/_api/web/GetList('${formatting.encodeQueryParameter(listUrl)}')`;
-        const needsToSavePage = !!args.options.title || !!args.options.description;
+        const needsToSavePage = !!args.options.title || !!args.options.description || !!args.options.content;
         try {
             const requestDigestResult = await spo.getRequestDigest(args.options.webUrl);
             const requestDigest = requestDigestResult.FormDigestValue;
             const page = await Page.checkout(args.options.name, args.options.webUrl, logger, this.verbose);
-            if (page) {
-                pageTitle = pageTitle || page.Title;
-                pageId = page.Id;
-                bannerImageUrl = page.BannerImageUrl;
-                canvasContent1 = args.options.content || page.CanvasContent1;
-                layoutWebpartsContent = page.LayoutWebpartsContent;
-                pageDescription = pageDescription || page.Description;
-                topicHeader = page.TopicHeader;
-                authorByline = page.AuthorByline;
-            }
+            pageTitle = pageTitle || page.Title;
+            pageId = page.Id;
+            bannerImageUrl = page.BannerImageUrl;
+            canvasContent1 = args.options.content || page.CanvasContent1;
+            layoutWebpartsContent = page.LayoutWebpartsContent;
+            pageDescription = pageDescription || page.Description;
+            topicHeader = page.TopicHeader;
+            authorByline = page.AuthorByline;
             if (args.options.layoutType) {
-                const file = await spo.getFileAsListItemByUrl(args.options.webUrl, serverRelativeFileUrl, logger, this.verbose);
-                const itemId = file.Id;
                 const listItemSetOptions = {
                     PageLayoutType: args.options.layoutType
                 };
@@ -73,7 +69,7 @@ class SpoPageSetCommand extends SpoCommand {
                     listItemSetOptions.PromotedState = 0;
                     listItemSetOptions.BannerImageUrl = `${resource}/_layouts/15/images/sitepagethumbnail.png, /_layouts/15/images/sitepagethumbnail.png`;
                 }
-                await spo.systemUpdateListItem(requestUrl, itemId, logger, this.verbose, listItemSetOptions);
+                await spo.systemUpdateListItem(requestUrl, pageId, logger, this.verbose, listItemSetOptions);
             }
             if (args.options.promoteAs) {
                 const requestOptions = {
@@ -95,18 +91,14 @@ class SpoPageSetCommand extends SpoCommand {
                         await request.post(requestOptions);
                         break;
                     case 'NewsPage': {
-                        const newsPageItem = await spo.getFileAsListItemByUrl(args.options.webUrl, serverRelativeFileUrl, logger, this.verbose);
-                        const newsPageItemId = newsPageItem.Id;
                         const listItemSetOptions = {
                             PromotedState: 2,
                             FirstPublishedDate: new Date().toISOString()
                         };
-                        await spo.systemUpdateListItem(requestUrl, newsPageItemId, logger, this.verbose, listItemSetOptions);
+                        await spo.systemUpdateListItem(requestUrl, pageId, logger, this.verbose, listItemSetOptions);
                         break;
                     }
                     case 'Template': {
-                        const templateItem = await spo.getFileAsListItemByUrl(args.options.webUrl, serverRelativeFileUrl, logger, this.verbose);
-                        const templateItemId = templateItem.Id;
                         requestOptions.headers = {
                             'X-RequestDigest': requestDigest,
                             'content-type': 'application/json;odata=nometadata',
@@ -114,7 +106,7 @@ class SpoPageSetCommand extends SpoCommand {
                             'IF-MATCH': '*',
                             accept: 'application/json;odata=nometadata'
                         };
-                        requestOptions.url = `${args.options.webUrl}/_api/SitePages/Pages(${templateItemId})/SavePageAsTemplate`;
+                        requestOptions.url = `${args.options.webUrl}/_api/SitePages/Pages(${pageId})/SavePageAsTemplate`;
                         const res = await request.post(requestOptions);
                         if (fileNameWithoutExtension) {
                             pageData.Title = fileNameWithoutExtension;
@@ -202,12 +194,15 @@ class SpoPageSetCommand extends SpoCommand {
                 await request.post(requestOptions);
             }
             if (args.options.demoteFrom === 'NewsPage') {
-                const file = await spo.getFileAsListItemByUrl(args.options.webUrl, serverRelativeFileUrl, logger, this.verbose);
-                const fileId = file.Id;
                 const listItemSetOptions = {
                     PromotedState: 0
                 };
-                await spo.systemUpdateListItem(requestUrl, fileId, logger, this.verbose, listItemSetOptions);
+                await spo.systemUpdateListItem(requestUrl, pageId, logger, this.verbose, listItemSetOptions);
+            }
+            if (args.options.isRetired !== undefined) {
+                await spo.systemUpdateListItem(requestUrl, pageId, logger, this.verbose, {
+                    _SPIsRetired: args.options.isRetired
+                });
             }
             let requestOptions;
             if (!args.options.publish) {
@@ -253,7 +248,8 @@ _SpoPageSetCommand_instances = new WeakSet(), _SpoPageSetCommand_initTelemetry =
             publishMessage: typeof args.options.publishMessage !== 'undefined',
             description: typeof args.options.description !== 'undefined',
             title: typeof args.options.title !== 'undefined',
-            content: typeof args.options.content !== 'undefined'
+            content: typeof args.options.content !== 'undefined',
+            isRetired: typeof args.options.isRetired !== 'undefined'
         });
     });
 }, _SpoPageSetCommand_initOptions = function _SpoPageSetCommand_initOptions() {
@@ -283,16 +279,20 @@ _SpoPageSetCommand_instances = new WeakSet(), _SpoPageSetCommand_initTelemetry =
         option: '--title [title]'
     }, {
         option: '--content [content]'
+    }, {
+        option: '--isRetired [isRetired]',
+        autocomplete: ['true', 'false']
     });
 }, _SpoPageSetCommand_initTypes = function _SpoPageSetCommand_initTypes() {
-    this.types.boolean.push('commentsEnabled');
+    this.types.boolean.push('commentsEnabled', 'isRetired');
 }, _SpoPageSetCommand_initValidators = function _SpoPageSetCommand_initValidators() {
     this.validators.push(async (args) => {
         const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
         if (isValidSharePointUrl !== true) {
             return isValidSharePointUrl;
         }
-        if (!args.options.layoutType && !args.options.promoteAs && !args.options.demoteFrom && args.options.commentsEnabled === undefined && !args.options.publish && !args.options.description && !args.options.title && !args.options.content) {
+        if (!args.options.layoutType && !args.options.promoteAs && !args.options.demoteFrom && args.options.commentsEnabled === undefined &&
+            !args.options.publish && !args.options.description && !args.options.title && !args.options.content && args.options.isRetired === undefined) {
             return 'Specify at least one option to update.';
         }
         if (args.options.layoutType &&

package/dist/utils/spo.js

@@ -1307,9 +1307,8 @@ export const spo = {
         if (response.indexOf("ErrorMessage") > -1) {
             throw `Error occurred in systemUpdate operation - ${response}`;
         }
-        const id = Number(itemId);
         const requestOptionsItems = {
-            url: `${absoluteListUrl}/items(${id})`,
+            url: `${absoluteListUrl}/items(${itemId})`,
             headers: {
                 'accept': 'application/json;odata=nometadata'
             },

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "11.4.0-beta.40f818c",
+  "version": "11.4.0-beta.f54089d",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -147,6 +147,7 @@
     "De Cleyre, Nico <nico.de.cleyre@gmail.com>",
     "Deshpande, Vardhaman <vardhaman.rd@gmail.com>",
     "Dojcsák, János <dojcsak.janos@gmail.com>",
+    "Druzhkina, Antanina <totora246@gmail.com>",
     "Dyjas, Robert <15113729+robdy@users.noreply.github.com>",
     "Faleel, Mohamed Ashiq <ashiqf@gmail.com>",
     "Flores, Gaston <gaston.flrs@gmail.com>",