Skip to main content

spo page control list

Lists controls on the specific modern page

Usage​

m365 spo page control list [options]

Options​

-n, --pageName <pageName>

Name of the page to list controls of.

-u, --webUrl <webUrl>

URL of the site where the page to retrieve is located.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

If the specified pageName doesn't refer to an existing modern page, you will get a File doesn't exists error.

Examples​

List controls on the modern page

m365 spo page control list --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx

Response​

[
  {
    "id": "7558d804-0334-49ca-b14a-53870cf6caae",
    "type": "Client-side web part",
    "title": "Bing Maps",
    "controlType": 3,
    "order": 1,
    "controlData": {
      "controlType": 3,
      "displayMode": 2,
      "id": "7558d804-0334-49ca-b14a-53870cf6caae",
      "position": {
        "controlIndex": 1,
        "sectionIndex": 1,
        "zoneIndex": 1,
        "sectionFactor": 12,
        "layoutIndex": 1
      },
      "webPartId": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
      "emphasis": {},
      "webPartData": {
        "dataVersion": "1.0",
        "description": "Display a location on a map using Bing Maps.",
        "id": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
        "instanceId": "7558d804-0334-49ca-b14a-53870cf6caae",
        "properties": {
          "pushPins": [],
          "maxNumberOfPushPins": 1,
          "shouldShowPushPinTitle": true,
          "zoomLevel": 12,
          "mapType": "road"
        },
        "title": "Bing Maps",
        "serverProcessedContent": {
          "htmlStrings": {},
          "searchablePlainTexts": {},
          "imageSources": {},
          "links": {}
        }
      }
    }
  }
]
CTRL + M