Skip to main content

entra roledefinition get

Gets a specific Microsoft Entra ID role definition.

Usage​

m365 entra roledefinition get [options]

Options​

-i, --id [id]

The id of the role definition. Specify either id or displayName, but not both.

-n, --displayName [displayName]

The display name of the role definition. Specify either id or displayName, but not both.

-p, --properties [properties]

Comma-separated list of properties to retrieve.

-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.

Examples​

Get info about a role specified by the id

m365 entra roledefinition get --id 62e90394-69f5-4237-9190-012177145e10

Get limited info about a role specified by the display name

m365 entra roledefinition get --displayName 'Custom SharePoint Role' --properties 'description,isEnabled'

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"
    }
  ]
}
CTRL + M