@pnp/cli-microsoft365 10.4.0-beta.791a39c → 10.4.0-beta.b552c1b

package/dist/m365/spo/commands/page/clientsidepages.js

@@ -271,6 +271,12 @@ export class ClientSidePage {
         for (let i = 0; i < this.sections.length; i++) {
             html.push(this.sections[i].toHtml());
         }
+        if (this.pageSettings) {
+            html.push(this.pageSettings.toHtml());
+        }
+        if (this.backgroundSettings) {
+            html.push(this.backgroundSettings.toHtml());
+        }
         html.push("</div>");
         return html.join("");
     }
@@ -286,17 +292,23 @@ export class ClientSidePage {
         // gather our controls from the supplied html
         getBoundedDivMarkup(html, /<div\b[^>]*data-sp-canvascontrol[^>]*?>/i, markup => {
             // get the control type
-            const ct = /controlType&quot;&#58;(\d*?),/i.exec(markup);
+            const ct = /controlType&quot;&#58;(\d*?)(,|&)/i.exec(markup);
             // if no control type is present this is a column which we give type 0 to let us process it
-            const controlType = ct == null || ct.length < 2 ? 0 : parseInt(ct[1], 10);
+            const controlType = ct == null || ct.length < 0 ? -1 : parseInt(ct[1], 10);
             let control = null;
             switch (controlType) {
-                case 0:
+                case -1:
                     // empty canvas column
                     control = new CanvasColumn(null, 0);
                     control.fromHtml(markup);
                     page.mergeColumnToTree(control);
                     break;
+                case 0:
+                    // page settings
+                    control = new PageSettings();
+                    control.fromHtml(markup);
+                    page.pageSettings = control;
+                    break;
                 case 3:
                     // client side webpart
                     control = new ClientSideWebpart("");
@@ -309,6 +321,12 @@ export class ClientSidePage {
                     control.fromHtml(markup);
                     page.mergePartToTree(control);
                     break;
+                case 14:
+                    // backgroundSection
+                    control = new BackgroundSettings();
+                    control.fromHtml(markup);
+                    page.backgroundSettings = control;
+                    break;
             }
         });
         // refresh all the orders within the tree
@@ -364,7 +382,7 @@ export class ClientSidePage {
         }
         const sections = this.sections.filter(s => s.order === zoneIndex);
         if (sections.length < 1) {
-            section = new CanvasSection(this, zoneIndex);
+            section = new CanvasSection(this, zoneIndex, [], control?.controlData?.position.zoneId, control.controlData?.zoneGroupMetadata);
             this.sections.push(section);
         }
         else {
@@ -392,7 +410,7 @@ export class ClientSidePage {
         let section = null;
         const sections = this.sections.filter(s => s.order === order);
         if (sections.length < 1) {
-            section = new CanvasSection(this, order);
+            section = new CanvasSection(this, order, [], column.controlData?.position?.zoneId, column.controlData?.zoneGroupMetadata);
             this.sections.push(section);
         }
         else {
@@ -403,10 +421,12 @@ export class ClientSidePage {
     }
 }
 export class CanvasSection {
-    constructor(page, order, columns = []) {
+    constructor(page, order, columns = [], zoneId, zoneGroupMetadata) {
         this.page = page;
         this.order = order;
         this.columns = columns;
+        this.zoneId = zoneId;
+        this.zoneGroupMetadata = zoneGroupMetadata;
     }
     /**
      * Default column (this.columns[0]) for this section
@@ -457,6 +477,20 @@ class CanvasControl {
         this.id = this.controlData.id;
     }
 }
+export class PageSettings extends CanvasControl {
+    constructor() {
+        super(0, "1.0");
+    }
+    getControlData() {
+        return this.controlData;
+    }
+    toHtml() {
+        return `<div data-sp-canvascontrol="" data-sp-canvasdataversion="${this.dataVersion}" data-sp-controldata="${this.jsonData}"></div>`;
+    }
+    fromHtml(html) {
+        super.fromHtml(html);
+    }
+}
 export class CanvasColumn extends CanvasControl {
     constructor(section, order, factor = 12, controls = [], dataVersion = "1.0") {
         super(0, dataVersion);
@@ -513,8 +547,10 @@ export class CanvasColumn extends CanvasControl {
             position: {
                 sectionFactor: this.factor,
                 sectionIndex: this.order,
-                zoneIndex: this.section ? this.section.order : 0
+                zoneIndex: this.section ? this.section.order : 0,
+                zoneId: this.section?.zoneId
             },
+            zoneGroupMetadata: this.section?.zoneGroupMetadata,
         };
     }
     /**
@@ -543,6 +579,58 @@ export class ClientSidePart extends CanvasControl {
         }
     }
 }
+export class BackgroundSettings extends ClientSidePart {
+    constructor() {
+        super(0, "1.0");
+        this.propertieJson = {};
+        this.serverProcessedContent = null;
+    }
+    getControlData() {
+        return {
+            controlType: this.controlType
+        };
+    }
+    toHtml() {
+        // will form the value of the data-sp-webpartdata attribute
+        const data = {
+            dataVersion: this.dataVersion,
+            instanceId: this.id,
+            properties: this.propertieJson,
+            serverProcessedContent: this.serverProcessedContent,
+        };
+        const html = [];
+        html.push(`<div data-sp-canvascontrol="" data-sp-canvasdataversion="${this.dataVersion}" data-sp-controldata="${this.jsonData}">`);
+        html.push(`<div data-sp-webpart="" data-sp-webpartdataversion="${this.dataVersion}" data-sp-webpartdata="${ClientSidePage.jsonToEscapedString(data)}">`);
+        html.push(`<div data-sp-componentid="">`);
+        html.push("</div>");
+        html.push(`<div data-sp-htmlproperties="">`);
+        for (let imageSource in this.serverProcessedContent?.imageSources) {
+            html.push(`<img data-sp-prop-name="${imageSource}" src="${this.serverProcessedContent?.imageSources[imageSource]}" />`);
+        }
+        html.push("</div>");
+        html.push("</div>");
+        html.push("</div>");
+        return html.join("");
+    }
+    setProperties(properties) {
+        this.propertieJson = extend(this.propertieJson, properties);
+        return this;
+    }
+    fromHtml(html) {
+        super.fromHtml(html);
+        const webPartData = ClientSidePage.escapedStringToJson(getAttrValueFromString(html, "data-sp-webpartdata"));
+        this.setProperties(webPartData.properties);
+        if (typeof webPartData.serverProcessedContent !== "undefined") {
+            this.serverProcessedContent = webPartData.serverProcessedContent;
+        }
+        if (typeof webPartData.dynamicDataPaths !== "undefined") {
+            this.dynamicDataPaths = webPartData.dynamicDataPaths;
+        }
+        if (typeof webPartData.dynamicDataValues !== "undefined") {
+            this.dynamicDataValues = webPartData.dynamicDataValues;
+        }
+    }
+}
 export class ClientSideText extends ClientSidePart {
     constructor(text = "") {
         super(4, "1.0");
@@ -570,8 +658,10 @@ export class ClientSideText extends ClientSidePart {
                 controlIndex: this.order,
                 sectionFactor: this.column ? this.column.factor : 0,
                 sectionIndex: this.column ? this.column.order : 0,
-                zoneIndex: this.column && this.column.section ? this.column.section.order : 0
+                zoneIndex: this.column && this.column.section ? this.column.section.order : 0,
+                zoneId: this.column?.section?.zoneId
             },
+            zoneGroupMetadata: this.column?.section?.zoneGroupMetadata,
         };
     }
     toHtml(index) {
@@ -684,9 +774,11 @@ export class ClientSideWebpart extends ClientSidePart {
                 controlIndex: this.order,
                 sectionFactor: this.column ? this.column.factor : 0,
                 sectionIndex: this.column ? this.column.order : 0,
-                zoneIndex: this.column && this.column.section ? this.column.section.order : 0
+                zoneIndex: this.column && this.column.section ? this.column.section.order : 0,
+                zoneId: this.column?.section?.zoneId
             },
             webPartId: this.webPartId,
+            zoneGroupMetadata: this.column?.section?.zoneGroupMetadata,
         };
     }
     renderHtmlProperties() {

package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js

@@ -132,7 +132,8 @@ class SpoPageClientSideWebPartAddCommand extends SpoCommand {
                 id: webPart.id,
                 position: Object.assign({}, control.position),
                 webPartId: webPart.webPartId,
-                emphasis: {}
+                emphasis: {},
+                zoneGroupMetadata: control.zoneGroupMetadata
             }, webPart);
             if (!control.controlType) {
                 // it's an empty column so we need to replace it with the web part

package/dist/m365/spo/commands/page/page-text-add.js

@@ -10,7 +10,7 @@ import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import { ClientSideText } from './clientsidepages.js';
+import { CanvasSection, ClientSideText } from './clientsidepages.js';
 import { Page } from './Page.js';
 class SpoPageTextAddCommand extends SpoCommand {
     get name() {
@@ -46,6 +46,12 @@ class SpoPageTextAddCommand extends SpoCommand {
             const page = await Page.getPage(pageName, args.options.webUrl, logger, this.debug, this.verbose);
             const section = (args.options.section || 1) - 1;
             const column = (args.options.column || 1) - 1;
+            // Add a new section when page does not contain any sections
+            if (page.sections.length < 1) {
+                const newSection = new CanvasSection(page, 1);
+                newSection.defaultColumn;
+                page.sections.push(newSection);
+            }
             // Make sure the section is in range
             if (section >= page.sections.length) {
                 throw new Error(`Invalid section '${section + 1}'`);

package/docs/docs/cmd/entra/group/group-member-add.mdx

@@ -14,10 +14,13 @@ m365 entra group member add [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
+: The ID of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
+: (deprecated. Use option `groupName` instead) The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `--ids [ids]`
 : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
@@ -39,6 +42,12 @@ Add a single member specified by ID as a member to a group specified by display
 m365 entra group member add --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
 ```
 
+Add a single member specified by ID as a member to a group specified by group name.
+
+```sh
+m365 entra group member add --groupName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
 Add multiple members specified by ID as members to a group specified by ID.
 
 ```sh
@@ -51,6 +60,12 @@ Add a single member specified by UPN as an owner to a group specified by display
 m365 entra group member add --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
 ```
 
+Add a single member specified by UPN as an owner to a group specified by group name.
+
+```sh
+m365 entra group member add --groupName Developers --userNames john.doe@contoso.com --role Owner
+```
+
 Adds multiple members specified by UPN as owners to a group specified by ID.
 
 ```sh

package/docs/docs/cmd/entra/group/group-member-set.mdx

@@ -14,10 +14,13 @@ m365 entra group member set [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+: The ID of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+: (deprecated. Use option `groupName` instead) The display name of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `--ids [ids]`
 : Comma-separated list of user IDs. Specify either `ids` or `userNames` but not both.
@@ -39,6 +42,12 @@ Update a single member specified by ID to a member of a group specified by displ
 m365 entra group member set --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
 ```
 
+Update a single member specified by ID to a member of a group specified by group name
+
+```sh
+m365 entra group member set --groupName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
 Update multiple members specified by ID to members of a group specified by ID
 
 ```sh
@@ -51,6 +60,12 @@ Update a single member specified by UPN to an owner of a group specified by disp
 m365 entra group member set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
 ```
 
+Update a single member specified by UPN to an owner of a group specified by group name
+
+```sh
+m365 entra group member set --groupName Developers --userNames john.doe@contoso.com --role Owner
+```
+
 Update multiple members specified by UPN to owners of a group specified by ID
 
 ```sh

package/docs/docs/cmd/entra/user/user-session-revoke.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra user session revoke
+
+Revokes all sign-in sessions for a given user
+
+## Usage
+
+```sh
+m365 entra user session revoke [options]
+```
+
+## Options
+```md definition-list
+`-i, --userId [userId]`
+: The id of the user. Specify either `userId` or `userName`, but not both.
+
+`-n, --userName [userName]`
+: The user principal name of the user. Specify either `userId` or `userName`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **User Administrator** or **Global Administrator**.
+
+:::
+
+:::note
+
+There might be a small delay of a few minutes before tokens are revoked.
+
+This API doesn't revoke sign-in sessions for external users, because external users sign in through their home tenant.
+
+:::
+
+## Examples
+
+Revoke sign-in sessions of a user specified by id
+
+```sh
+m365 entra user session revoke --userId 4fb72b9b-d0b0-4a35-8bc1-83f9a6488c48
+```
+
+Revoke sign-in sessions of a user specified by its UPN
+
+```sh
+m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com
+```
+
+Revoke sign-in sessions of a user specified by its UPN without prompting for confirmation
+
+```sh
+m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com --force
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/outlook/mailbox/mailbox-settings-get.mdx

@@ -0,0 +1,131 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook mailbox settings get
+
+Get the user's mailbox settings
+
+## Usage
+
+```sh
+m365 outlook mailbox settings get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --userId [userId]`
+: The ID of the Microsoft Entra user for which you want to get mailbox settings. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+
+`-n, --userName [userName]`
+: The UPN of the Microsoft Entra user for which you want to get mailbox settings. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+```
+
+<Global />
+
+## Examples
+
+Get mailbox settings of the signed-in user
+
+```sh
+m365 outlook mailbox settings get
+```
+
+Get mailbox settings of a user specified by id
+
+```sh
+m365 outlook mailbox settings get --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "archiveFolder": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA",
+    "timeZone": "Central Europe Standard Time",
+    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly",
+    "dateFormat": "dd.MM.yyyy",
+    "timeFormat": "H:mm",
+    "userPurpose": "user",
+    "automaticRepliesSetting": {
+      "status": "disabled",
+      "externalAudience": "all",
+      "internalReplyMessage": "On vacation. Will be back.",
+      "externalReplyMessage": "Vacation",
+      "scheduledStartDateTime": {
+        "dateTime": "2025-01-20T08:00:00.0000000",
+        "timeZone": "UTC"
+      },
+      "scheduledEndDateTime": {
+        "dateTime": "2025-01-25T18:00:00.0000000",
+        "timeZone": "UTC"
+      }
+    },
+    "language": {
+      "locale": "en-US",
+      "displayName": "English (United States)"
+    },
+    "workingHours": {
+      "daysOfWeek": [
+        "monday",
+        "tuesday",
+        "wednesday",
+        "thursday",
+        "friday"
+      ],
+      "startTime": "08:00:00.0000000",
+      "endTime": "16:30:00.0000000",
+      "timeZone": {
+        "name": "Central Europe Standard Time"
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  archiveFolder                        : AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA
+  automaticRepliesSetting              : {"status":"disabled","externalAudience":"all","internalReplyMessage":"","externalReplyMessage":"","scheduledStartDateTime":{"dateTime":"2025-01-20T08:00:00.0000000","timeZone":"UTC"},"scheduledEndDateTime":{"dateTime":"2025-01-25T18:00:00.0000000","timeZone":"UTC"}}
+  dateFormat                           : dd.MM.yyyy
+  delegateMeetingMessageDeliveryOptions: sendToDelegateOnly
+  language                             : {"locale":"en-US","displayName":"English (United States)"}
+  timeFormat                           : H:mm
+  timeZone                             : Central Europe Standard Time
+  userPurpose                          : user
+  workingHours                         : {"daysOfWeek":["monday","tuesday","wednesday","thursday","friday"],"startTime":"08:00:00.0000000","endTime":"16:30:00.0000000","timeZone":{"name":"Central Europe Standard Time"}}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  archiveFolder,timeZone,delegateMeetingMessageDeliveryOptions,dateFormat,timeFormat,userPurpose
+  AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA,Central Europe Standard Time,sendToDelegateOnly,dd.MM.yyyy,H:mm,user
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook mailbox settings get
+
+  Date: 1/17/2025
+
+  Property | Value
+  ---------|-------
+  archiveFolder | AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA
+  timeZone | Central Europe Standard Time
+  delegateMeetingMessageDeliveryOptions | sendToDelegateOnly
+  dateFormat | dd.MM.yyyy
+  timeFormat | H:mm
+  userPurpose | user
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/field/field-get.mdx

@@ -28,10 +28,14 @@ m365 spo field get [options]
 : Server- or web-relative URL of the list where the field is located. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id [id]`
-: The ID of the field to retrieve. Specify `id` or `title` but not both.
+: The ID of the field to retrieve. Specify either `id`, `title` or `internalName`.
 
 `-t, --title [title]`
-: The display name (case-sensitive) of the field to retrieve. Specify `id` or `title` but not both.
+: The display name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.
+```
+
+`--internalName [internalName]`
+: The internal name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.
 ```
 
 <Global />
@@ -56,6 +60,12 @@ Retrieves list column by display name located in the specified site. Retrieves t
 m365 spo field get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --title "Title"
 ```
 
+Retrieves list column by internal name located in the specified site. Retrieves the list by its url.
+
+```sh
+m365 spo field get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --internalName "Title"
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spo/field/field-remove.mdx

@@ -26,13 +26,16 @@ m365 spo field remove [options]
 : Server- or web-relative URL of the list where the field is located. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id [id]`
-: The ID of the field to remove. Specify either `id`, `title`, or `group`.
+: The ID of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
 
 `-t, --title [title]`
-: The display name (case-sensitive) of the field to remove. Specify either `id`, `title`, or `group`.
+: The display name (case-sensitive) of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
+
+`--internalName [internalName]`
+: The internal name (case-sensitive) of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
 
 `-g, --group [group]`
-: Delete all fields from this group (case-sensitive). Specify either `id`, `title`, or `group`.
+: Delete all fields from this group (case-sensitive). Specify either `id`, `title`, `internalName`, or `group`.
 
 `-f, --force`
 : Don't prompt for confirming removing the field.
@@ -60,6 +63,12 @@ Remove the list column with the specified display name, located in the specified
 m365 spo field remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --title "Title"
 ```
 
+Remove the list column with the specified display name, located in the specified site. Retrieves the list by its url.
+
+```sh
+m365 spo field remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --internalName "Title"
+```
+
 Remove all site columns from the specified group.
 
 ```sh

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

@@ -26,10 +26,13 @@ m365 spo field set [options]
 : Server- or site-relative URL of the list where the field is located (if list column). Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id [id]`
-: ID of the field to update. Specify either `id` or `title` but not both.
+: ID of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
 
 `-t, --title [title]`
-: Title or internal name of the field to update. Specify either `id` or `title` but not both.
+: Title of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
+
+`--internalName [internalName]`
+: Internal name of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
 
 `--updateExistingLists`
 : Set, to push the update to existing lists. Otherwise, the changes will apply to new lists only.
@@ -51,6 +54,12 @@ When updating column formatting for a field with the `--CustomFormatter` option,
 
 Update the title of the site column specified by its internal name and push changes to existing lists.
 
+```sh
+m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --internalName 'MyColumn' --updateExistingLists --Title 'My column'
+```
+
+Update the title of the site column specified by its title and push changes to existing lists.
+
 ```sh
 m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --title 'MyColumn' --updateExistingLists --Title 'My column'
 ```
@@ -67,11 +76,16 @@ Update the description of a column specified by the ID on a list retrieved by th
 m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/My List' --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce --Description 'My column Description'
 ```
 
-Update column formatting of the specified list column.
+Update column formatting of the specified list column based on title.
 
 ```sh
 m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'MyColumn' --CustomFormatter '{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}'
 ```
+Update column formatting of the specified list column based on internalName.
+
+```sh
+m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --internalName 'MyColumn' --CustomFormatter '{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}'
+```
 
 ## Response