Skip to content

Commit c729a39

Browse files
AlejandroGispertAlejandroGispert
committed
docs(entra): add Permissions sections for entra app role add/list/remove
1 parent b6cfa5d commit c729a39

3 files changed

Lines changed: 103 additions & 44 deletions

File tree

‎docs/docs/cmd/entra/app/app-role-add.mdx‎

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
import Global from '/docs/cmd/_global.mdx';
1+
import Global from "/docs/cmd/_global.mdx";
2+
import Tabs from "@theme/Tabs";
3+
import TabItem from "@theme/TabItem";
24

35
# entra app role add
46

@@ -49,6 +51,25 @@ For best performance use the `appObjectId` option to reference the Entra applica
4951

5052
If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
5153

54+
## Permissions
55+
56+
<Tabs>
57+
<TabItem value="Delegated">
58+
59+
| Resource | Permissions |
60+
| --------------- | ------------------------- |
61+
| Microsoft Graph | Application.ReadWrite.All |
62+
63+
</TabItem>
64+
<TabItem value="Application">
65+
66+
| Resource | Permissions |
67+
| --------------- | ------------------------- |
68+
| Microsoft Graph | Application.ReadWrite.All |
69+
70+
</TabItem>
71+
</Tabs>
72+
5273
## Examples
5374

5475
Add role to the Entra application registration specified by its object ID

‎docs/docs/cmd/entra/app/app-role-list.mdx‎

Lines changed: 58 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
import Global from '/docs/cmd/_global.mdx';
2-
import Tabs from '@theme/Tabs';
3-
import TabItem from '@theme/TabItem';
1+
import Global from "/docs/cmd/_global.mdx";
2+
import Tabs from "@theme/Tabs";
3+
import TabItem from "@theme/TabItem";
44

55
# entra app role list
66

@@ -39,6 +39,25 @@ For best performance use the `appObjectId` option to reference the Entra applica
3939

4040
If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
4141

42+
## Permissions
43+
44+
<Tabs>
45+
<TabItem value="Delegated">
46+
47+
| Resource | Permissions |
48+
| --------------- | -------------------- |
49+
| Microsoft Graph | Application.Read.All |
50+
51+
</TabItem>
52+
<TabItem value="Application">
53+
54+
| Resource | Permissions |
55+
| --------------- | -------------------- |
56+
| Microsoft Graph | Application.Read.All |
57+
58+
</TabItem>
59+
</Tabs>
60+
4261
## Examples
4362

4463
Get roles for the Entra application registration specified by its object ID
@@ -64,58 +83,56 @@ m365 entra app role list --appName "My app"
6483
<Tabs>
6584
<TabItem value="JSON">
6685

67-
```json
68-
[
69-
{
70-
"allowedMemberTypes": [
71-
"User"
72-
],
73-
"description": "Managers",
74-
"displayName": "Managers",
75-
"id": "0a545986-9142-4c88-909c-34f3c11abbc4",
76-
"isEnabled": true,
77-
"origin": "Application",
78-
"value": "managers"
79-
}
80-
]
81-
```
86+
```json
87+
[
88+
{
89+
"allowedMemberTypes": ["User"],
90+
"description": "Managers",
91+
"displayName": "Managers",
92+
"id": "0a545986-9142-4c88-909c-34f3c11abbc4",
93+
"isEnabled": true,
94+
"origin": "Application",
95+
"value": "managers"
96+
}
97+
]
98+
```
8299

83100
</TabItem>
84101
<TabItem value="Text">
85102

86-
```text
87-
displayName description id
88-
----------- ----------- ------------------------------------
89-
Managers Managers 0a545986-9142-4c88-909c-34f3c11abbc4
90-
```
103+
```text
104+
displayName description id
105+
----------- ----------- ------------------------------------
106+
Managers Managers 0a545986-9142-4c88-909c-34f3c11abbc4
107+
```
91108

92109
</TabItem>
93110
<TabItem value="CSV">
94111

95-
```csv
96-
description,displayName,id,isEnabled,origin,value
97-
Managers,Managers,0a545986-9142-4c88-909c-34f3c11abbc4,1,Application,managers
98-
```
112+
```csv
113+
description,displayName,id,isEnabled,origin,value
114+
Managers,Managers,0a545986-9142-4c88-909c-34f3c11abbc4,1,Application,managers
115+
```
99116

100117
</TabItem>
101118
<TabItem value="Markdown">
102119

103-
```md
104-
# entra app role list --appObjectId "29d99e17-96b7-46aa-816d-b52bfeeafeb9"
120+
```md
121+
# entra app role list --appObjectId "29d99e17-96b7-46aa-816d-b52bfeeafeb9"
105122

106-
Date: 2023-06-01
123+
Date: 2023-06-01
107124

108-
## Managers (0a545986-9142-4c88-909c-34f3c11abbc4)
125+
## Managers (0a545986-9142-4c88-909c-34f3c11abbc4)
109126

110-
Property | Value
111-
---------|-------
112-
description | Managers
113-
displayName | Managers
114-
id | 0a545986-9142-4c88-909c-34f3c11abbc4
115-
isEnabled | true
116-
origin | Application
117-
value | managers
118-
```
127+
| Property | Value |
128+
| ----------- | ------------------------------------ |
129+
| description | Managers |
130+
| displayName | Managers |
131+
| id | 0a545986-9142-4c88-909c-34f3c11abbc4 |
132+
| isEnabled | true |
133+
| origin | Application |
134+
| value | managers |
135+
```
119136

120137
</TabItem>
121-
</Tabs>
138+
</Tabs>

‎docs/docs/cmd/entra/app/app-role-remove.mdx‎

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
import Global from '/docs/cmd/_global.mdx';
1+
import Global from "/docs/cmd/_global.mdx";
2+
import Tabs from "@theme/Tabs";
3+
import TabItem from "@theme/TabItem";
24

35
# entra app role remove
46

@@ -53,6 +55,25 @@ If the command finds multiple roles with the specified role name, it will prompt
5355

5456
If the role to be removed is 'Enabled', this command will disable the role first and then remove.
5557

58+
## Permissions
59+
60+
<Tabs>
61+
<TabItem value="Delegated">
62+
63+
| Resource | Permissions |
64+
| --------------- | ------------------------- |
65+
| Microsoft Graph | Application.ReadWrite.All |
66+
67+
</TabItem>
68+
<TabItem value="Application">
69+
70+
| Resource | Permissions |
71+
| --------------- | ------------------------- |
72+
| Microsoft Graph | Application.ReadWrite.All |
73+
74+
</TabItem>
75+
</Tabs>
76+
5677
## Examples
5778

5879
Remove role from a Entra application registration using object ID and role name options. Will prompt for confirmation before deleting the role.
@@ -81,4 +102,4 @@ m365 entra app role remove --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --
81102

82103
## Response
83104

84-
The command won't return a response on success.
105+
The command won't return a response on success.

0 commit comments

Comments
 (0)