Skip to main content

pp website webrole list

Lists all webroles for the specified Power Pages website.

Usage​

m365 pp website webrole list [options]

Options​

--websiteId [websiteId]

ID of the Power Pages website. Specify either websiteId or websiteName but not both.

--websiteName [websiteName]

The unique name (not the display name) of the Power Pages website. Specify either websiteId or websiteName but not both.

-e, --environmentName <environmentName>

The name of the environment where the Power Pages websites are located.

--asAdmin

Run the command as admin and retrieve Power Pages websites for environments you do not have explicitly assigned permissions to.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, 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.

Permissions​

ResourcePermissions
Power Platform APIPowerPages.Websites.Read
Dynamics CRMuser_impersonation

Examples​

List all webroles for the site by name.

m365 pp website webrole list --websiteName "Contoso" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"

List all webroles for the site by name as admin.

m365 pp website webrole list --websiteName "Contoso" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin

List all webroles for the site by id.

m365 pp website webrole list --websiteId "2ca3eaa5-140f-4175-8261-3272edf9f339" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"

List all webroles for the site by id as admin.

m365 pp website webrole list --websiteId "2ca3eaa5-140f-4175-8261-3272edf9f339" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin

Response​

[
  {
    "mspp_webroleid": "a242a363-6077-4cb7-b2d1-1714502d129a",
    "mspp_name": "Anonymous Users",
    "mspp_description": "Role for anonymous users",
    "mspp_key": null,
    "mspp_authenticatedusersrole": false,
    "mspp_anonymoususersrole": true,
    "mspp_createdon": "2026-01-21T22:10:56Z",
    "mspp_modifiedon": "2026-01-21T22:10:56Z",
    "statecode": 0,
    "statuscode": 1,
    "_mspp_websiteid_value": "5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce",
    "_mspp_createdby_value": "b7aa2026-a8c1-f011-bbd2-000d3a66196e",
    "_mspp_modifiedby_value": "b7aa2026-a8c1-f011-bbd2-000d3a66196e"
  }
]