Skip to main content

entra roledefinition list

Lists all Microsoft Entra ID role definitions.

Usage​

m365 entra roledefinition list [options]

Options​

-p, --properties [properties]

Comma-separated list of properties to retrieve.

-f, --filter [filter]

OData filter to apply when retrieving the role definitions.

-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
Microsoft GraphRoleManagement.Read.Directory

Examples​

Retrieve all Microsoft Entra ID role definitions

m365 entra roledefinition list

Retrieve only the names of the role definitions

m365 entra roledefinition list --properties 'displayName'

Retrieve only custom role definitions

m365 entra roledefinition list --filter 'isBuiltIn eq false'

Response​

Standard response​

[
  {
    "id": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
    "description": "Can manage all aspects of the SharePoint service.",
    "displayName": "SharePoint Administrator",
    "isBuiltIn": true,
    "isEnabled": true,
    "resourceScopes": [
      "/"
    ],
    "templateId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
    "version": "1",
    "rolePermissions": [
      {
        "allowedResourceActions": [
          "microsoft.azure.serviceHealth/allEntities/allTasks",
          "microsoft.azure.supportTickets/allEntities/allTasks",
          "microsoft.backup/oneDriveForBusinessProtectionPolicies/allProperties/allTasks",
          "microsoft.backup/oneDriveForBusinessRestoreSessions/allProperties/allTasks",
          "microsoft.backup/restorePoints/sites/allProperties/allTasks",
          "microsoft.backup/restorePoints/userDrives/allProperties/allTasks",
          "microsoft.backup/sharePointProtectionPolicies/allProperties/allTasks",
          "microsoft.backup/sharePointRestoreSessions/allProperties/allTasks",
          "microsoft.backup/siteProtectionUnits/allProperties/allTasks",
          "microsoft.backup/siteRestoreArtifacts/allProperties/allTasks",
          "microsoft.backup/userDriveProtectionUnits/allProperties/allTasks",
          "microsoft.backup/userDriveRestoreArtifacts/allProperties/allTasks",
          "microsoft.directory/groups/hiddenMembers/read",
          "microsoft.directory/groups.unified/basic/update",
          "microsoft.directory/groups.unified/create",
          "microsoft.directory/groups.unified/delete",
          "microsoft.directory/groups.unified/members/update",
          "microsoft.directory/groups.unified/owners/update",
          "microsoft.directory/groups.unified/restore",
          "microsoft.office365.migrations/allEntities/allProperties/allTasks",
          "microsoft.office365.network/performance/allProperties/read",
          "microsoft.office365.serviceHealth/allEntities/allTasks",
          "microsoft.office365.sharePoint/allEntities/allTasks",
          "microsoft.office365.supportTickets/allEntities/allTasks",
          "microsoft.office365.usageReports/allEntities/allProperties/read",
          "microsoft.office365.webPortal/allEntities/standard/read"
        ],
        "condition": null
      }
    ],
    "inheritsPermissionsFrom": [
      {
        "id": "88d8e3e3-8f55-4a1e-953a-9b9898b8876b"
      }
    ]
  }
]