Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New command: entra rolepermission list. Closes #6562 #6564

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/docs/cmd/entra/roledefinition/roledefinition-add.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ m365 entra roledefinition add [options]

<Global />

## Remarks

Use the `m365 entra rolepermission list --resourceNamespace microsoft.directory` command to get a list of available resource actions.

## Examples

Create a custom Microsoft Entra ID role
Expand Down
4 changes: 4 additions & 0 deletions docs/docs/cmd/entra/roledefinition/roledefinition-set.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,10 @@ m365 entra roledefinition set [options]

<Global />

## Remarks

Use the `m365 entra rolepermission list --resourceNamespace microsoft.directory` command to get a list of available resource actions.

## Examples

Update a custom Microsoft Entra ID role specified by the id
Expand Down
158 changes: 158 additions & 0 deletions docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
import Global from '/docs/cmd/_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# entra rolepermission list

Lists all Microsoft Entra ID role permissions.

## Usage

```sh
m365 entra rolepermission list [options]
```

## Options
```md definition-list
`-n, resourceNamespace [resourceNamespace]`
: The namespace of the resource for which to retrieve role permissions.

`-p, --privileged`
: Retrieve only sensitive role permissions.

`--properties [properties]`
: Comma-separated list of properties to retrieve.
```

<Global />

## Examples

### Examples

Get a list of role permissions

```sh
m365 entra rolepermission list --resourceNamespace 'microsoft.directory'
```

Get a list of sensitive role permissions

```sh
m365 entra rolepermission list --resourceNamespace 'microsoft.directory' --privileged
```

## Response

<Tabs>
<TabItem value="JSON">

```json
[
{
"actionVerb": null,
"description": "Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",
"id": "microsoft.directory-accessReviews-allProperties-allTasks",
"isPrivileged": false,
"name": "microsoft.directory/accessReviews/allProperties/allTasks",
"resourceScopeId": null
},
{
"actionVerb": "GET",
"description": "Read all properties of access reviews",
"id": "microsoft.directory-accessReviews-allProperties-read-get",
"isPrivileged": false,
"name": "microsoft.directory/accessReviews/allProperties/read",
"resourceScopeId": null
},
{
"actionVerb": null,
"description": "Manage access reviews of application role assignments in Microsoft Entra ID",
"id": "microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks",
"isPrivileged": false,
"name": "microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks",
"resourceScopeId": null
},
{
"actionVerb": "GET",
"description": "Read all properties of access reviews of application role assignments in Microsoft Entra ID",
"id": "microsoft.directory-accessReviews-definitions.applications-allProperties-read-get",
"isPrivileged": false,
"name": "microsoft.directory/accessReviews/definitions.applications/allProperties/read",
"resourceScopeId": null
}
]
```

</TabItem>
<TabItem value="Text">

```text
id name actionVerb isPrivileged
-------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ---------- ------------
microsoft.directory-accessReviews-allProperties-allTasks microsoft.directory/accessReviews/allProperties/allTasks null false
microsoft.directory-accessReviews-allProperties-read-get microsoft.directory/accessReviews/allProperties/read GET false
microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks null false
microsoft.directory-accessReviews-definitions.applications-allProperties-read-get microsoft.directory/accessReviews/definitions.applications/allProperties/read GET false
```

</TabItem>
<TabItem value="CSV">

```csv
actionVerb,description,id,isPrivileged,name,resourceScopeId
,"Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",microsoft.directory-accessReviews-allProperties-allTasks,0,microsoft.directory/accessReviews/allProperties/allTasks,
GET,Read all properties of access reviews,microsoft.directory-accessReviews-allProperties-read-get,0,microsoft.directory/accessReviews/allProperties/read,
,Manage access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks,0,microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks,
GET,Read all properties of access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-read-get,0,microsoft.directory/accessReviews/definitions.applications/allProperties/read,
```

</TabItem>
<TabItem value="Markdown">

```md
# entra rolepermission list --resourceNamespace "microsoft.directory"

Date: 1/16/2025

## microsoft.directory/accessReviews/allProperties/allTasks (microsoft.directory-accessReviews-allProperties-allTasks)

Property | Value
---------|-------
description | Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID
id | microsoft.directory-accessReviews-allProperties-allTasks
isPrivileged | false
name | microsoft.directory/accessReviews/allProperties/allTasks

## microsoft.directory/accessReviews/allProperties/read (microsoft.directory-accessReviews-allProperties-read-get)

Property | Value
---------|-------
actionVerb | GET
description | Read all properties of access reviews
id | microsoft.directory-accessReviews-allProperties-read-get
isPrivileged | false
name | microsoft.directory/accessReviews/allProperties/read

## microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks (microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks)

Property | Value
---------|-------
description | Manage access reviews of application role assignments in Microsoft Entra ID
id | microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks
isPrivileged | false
name | microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks

## microsoft.directory/accessReviews/definitions.applications/allProperties/read (microsoft.directory-accessReviews-definitions.applications-allProperties-read-get)

Property | Value
---------|-------
actionVerb | GET
description | Read all properties of access reviews of application role assignments in Microsoft Entra ID
id | microsoft.directory-accessReviews-definitions.applications-allProperties-read-get
isPrivileged | false
name | microsoft.directory/accessReviews/definitions.applications/allProperties/read
```

</TabItem>
</Tabs>
9 changes: 9 additions & 0 deletions docs/src/config/sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -661,6 +661,15 @@ const sidebars: SidebarsConfig = {
}
]
},
{
rolepermission: [
{
type: 'doc',
label: 'rolepermission list',
id: 'cmd/entra/rolepermission/rolepermission-list'
}
]
},
{
siteclassification: [
{
Expand Down
1 change: 1 addition & 0 deletions src/m365/entra/commands.ts
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,7 @@ export default {
ROLEDEFINITION_GET: `${prefix} roledefinition get`,
ROLEDEFINITION_REMOVE: `${prefix} roledefinition remove`,
ROLEDEFINITION_SET: `${prefix} roledefinition set`,
ROLEPERMISSION_LIST: `${prefix} rolepermission list`,
SITECLASSIFICATION_DISABLE: `${prefix} siteclassification disable`,
SITECLASSIFICATION_ENABLE: `${prefix} siteclassification enable`,
SITECLASSIFICATION_GET: `${prefix} siteclassification get`,
Expand Down
Loading
Loading