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

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/m365/spp/commands/autofillcolumn/autofillcolumn-set.js

@@ -0,0 +1,166 @@
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import z from 'zod';
+var AllowedFieldTypeKind;
+(function (AllowedFieldTypeKind) {
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Integer"] = 1] = "Integer";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Text"] = 2] = "Text";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Note"] = 3] = "Note";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["DateTime"] = 4] = "DateTime";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Counter"] = 5] = "Counter";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Choice"] = 6] = "Choice";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Boolean"] = 8] = "Boolean";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Number"] = 9] = "Number";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Currency"] = 10] = "Currency";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["URL"] = 11] = "URL";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["Computed"] = 12] = "Computed";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["MultiChoice"] = 15] = "MultiChoice";
+    AllowedFieldTypeKind[AllowedFieldTypeKind["GridChoice"] = 16] = "GridChoice";
+})(AllowedFieldTypeKind || (AllowedFieldTypeKind = {}));
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    siteUrl: z.string().refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    }).alias('u'),
+    listTitle: z.string().optional(),
+    listId: z.string().uuid()
+        .refine(value => validation.isValidGuid(value), {
+        error: e => `'${e.input}' in parameter listId is not a valid GUID.`
+    }).optional(),
+    listUrl: z.string().optional(),
+    columnId: z.string().uuid()
+        .refine(value => validation.isValidGuid(value), {
+        error: e => `'${e.input}' in parameter columnId is not a valid GUID.`
+    }).optional().alias('i'),
+    columnTitle: z.string().optional().alias('t'),
+    columnInternalName: z.string().optional(),
+    prompt: z.string().optional(),
+    isEnabled: z.boolean().optional()
+}).strict();
+class SppAutofillColumnSetCommand extends SpoCommand {
+    get name() {
+        return commands.AUTOFILLCOLUMN_SET;
+    }
+    get description() {
+        return 'Applies the autofill option to the selected column';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.columnId, options.columnTitle, options.columnInternalName].filter(Boolean).length === 1, {
+            message: `Specify exactly one of the following options: 'columnId', 'columnTitle' or 'columnInternalName'.`
+        })
+            .refine(options => [options.listTitle, options.listId, options.listUrl].filter(Boolean).length === 1, {
+            message: `Specify exactly one of the following options: 'listTitle', 'listId' or 'listUrl'.`
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.log(`Applying an autofill column to a column...`);
+            }
+            const siteUrl = urlUtil.removeTrailingSlashes(args.options.siteUrl);
+            const listInstance = await this.getDocumentLibraryInfo(siteUrl, args.options);
+            if (listInstance.BaseType !== 1) {
+                throw Error(`The specified list is not a document library.`);
+            }
+            const column = await this.getColumn(siteUrl, args.options, listInstance.Id);
+            if (!Object.values(AllowedFieldTypeKind).includes(column.FieldTypeKind)) {
+                throw Error(`The specified column has incorrect type.`);
+            }
+            if (column.AutofillInfo) {
+                await this.updateAutoFillColumnSettings(siteUrl, args.options, column.Id, listInstance.Id, column.AutofillInfo);
+                return;
+            }
+            if (!args.options.prompt) {
+                throw Error(`The prompt parameter is required when setting the autofill column for the first time.`);
+            }
+            await this.applyAutoFillColumnSettings(siteUrl, args.options, column.Id, column.Title, listInstance.Id);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    getDocumentLibraryInfo(siteUrl, options) {
+        let requestUrl = `${siteUrl}/_api/web`;
+        if (options.listId) {
+            requestUrl += `/lists(guid'${formatting.encodeQueryParameter(options.listId)}')`;
+        }
+        else if (options.listTitle) {
+            requestUrl += `/lists/getByTitle('${formatting.encodeQueryParameter(options.listTitle)}')`;
+        }
+        else if (options.listUrl) {
+            const listServerRelativeUrl = urlUtil.getServerRelativePath(siteUrl, options.listUrl);
+            requestUrl += `/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')`;
+        }
+        const requestOptions = {
+            url: `${requestUrl}?$select=Id,BaseType`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        return request.get(requestOptions);
+    }
+    getColumn(siteUrl, options, listId) {
+        let fieldRestUrl = '';
+        if (options.columnId) {
+            fieldRestUrl = `/getbyid('${formatting.encodeQueryParameter(options.columnId)}')`;
+        }
+        else {
+            fieldRestUrl = `/getbyinternalnameortitle('${formatting.encodeQueryParameter((options.columnTitle || options.columnInternalName))}')`;
+        }
+        const requestOptions = {
+            url: `${siteUrl}/_api/web/lists(guid'${formatting.encodeQueryParameter(listId)}')/fields${fieldRestUrl}?&$select=Id,Title,FieldTypeKind,AutofillInfo`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        return request.get(requestOptions);
+    }
+    updateAutoFillColumnSettings(siteUrl, options, columnId, listInstanceId, autofillInfo) {
+        const autofillInfoObj = JSON.parse(autofillInfo);
+        const requestOptions = {
+            url: `${siteUrl}/_api/machinelearning/SetColumnLLMInfo`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json',
+            data: {
+                autofillPrompt: options.prompt ?? autofillInfoObj.LLM.Prompt,
+                columnId: columnId,
+                docLibId: `{${listInstanceId}}`,
+                isEnabled: options.isEnabled !== undefined ? options.isEnabled : autofillInfoObj.LLM.IsEnabled
+            }
+        };
+        return request.post(requestOptions);
+    }
+    applyAutoFillColumnSettings(siteUrl, options, columnId, columnTitle, listInstanceId) {
+        const requestOptions = {
+            url: `${siteUrl}/_api/machinelearning/SetSyntexPoweredColumnPrompts`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            data: {
+                docLibId: `{${listInstanceId}}`,
+                syntexPoweredColumnPrompts: JSON.stringify([{
+                        columnId: columnId,
+                        columnName: columnTitle,
+                        prompt: options.prompt,
+                        isEnabled: options.isEnabled !== undefined ? options.isEnabled : true
+                    }])
+            }
+        };
+        return request.post(requestOptions);
+    }
+}
+export default new SppAutofillColumnSetCommand();
+//# sourceMappingURL=autofillcolumn-set.js.map

package/dist/m365/spp/commands.js

@@ -1,5 +1,6 @@
 const prefix = 'spp';
 export default {
+    AUTOFILLCOLUMN_SET: `${prefix} autofillcolumn set`,
     CONTENTCENTER_LIST: `${prefix} contentcenter list`,
     MODEL_APPLY: `${prefix} model apply`,
     MODEL_GET: `${prefix} model get`,

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/spe/container/container-recyclebinitem-remove.mdx

@@ -0,0 +1,79 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container recyclebinitem remove
+
+Permanently removes a container from the recycle bin
+
+## Usage
+
+```sh
+m365 spe container recyclebinitem remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The container id. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The display name of the Container. Specify either `id` or `name` but not both.
+
+`--containerTypeId [containerTypeId]`
+: The container type ID of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+
+`--containerTypeName [containerTypeName]`
+: The container type name of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                        |
+  |-----------------|--------------------------------------------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when using the `containerTypeId` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove a deleted container by ID.
+
+```sh
+m365 spe container recyclebinitem remove --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+```
+
+Remove a deleted container by using its name and container type ID.
+
+```sh
+m365 spe container recyclebinitem remove --containerTypeId "91710488-5756-407f-9046-fbe5f0b4de73" --name "Invoices"
+```
+
+Remove a deleted container by using its name and container type name.
+
+```sh
+m365 spe container recyclebinitem remove --containerTypeName "My container type name" --name "Invoices"
+```
+
+## Response
+
+The command won't return a response on success.

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