@pnp/cli-microsoft365 6.1.0-beta.3e0114a → 6.1.0-beta.4fefcde

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/dist/m365/pp/commands/dataverse/dataverse-table-row-remove.js +133 -0
  2. package/dist/m365/pp/commands.js +1 -0
  3. package/dist/m365/spo/commands/list/{list-label-get.js → list-retentionlabel-get.js} +19 -15
  4. package/dist/m365/spo/commands/list/{list-label-set.js → list-retentionlabel-set.js} +19 -15
  5. package/dist/m365/spo/commands/web/web-retentionlabel-list.js +63 -0
  6. package/dist/m365/spo/commands.js +3 -0
  7. package/docs/docs/cmd/pp/dataverse/dataverse-table-row-remove.md +61 -0
  8. package/docs/docs/cmd/spo/list/{list-label-get.md → list-retentionlabel-get.md} +17 -11
  9. package/docs/docs/cmd/spo/list/list-retentionlabel-set.md +65 -0
  10. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.md +9 -5
  11. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.md +42 -0
  12. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.md +25 -3
  13. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.md +22 -0
  14. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.md +6 -2
  15. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.md +5 -1
  16. package/docs/docs/cmd/spo/page/page-add.md +13 -9
  17. package/docs/docs/cmd/spo/page/page-clientsidewebpart-add.md +6 -2
  18. package/docs/docs/cmd/spo/page/page-column-get.md +68 -5
  19. package/docs/docs/cmd/spo/page/page-column-list.md +36 -4
  20. package/docs/docs/cmd/spo/page/page-control-get.md +70 -3
  21. package/docs/docs/cmd/spo/page/page-control-list.md +69 -3
  22. package/docs/docs/cmd/spo/page/page-control-set.md +11 -7
  23. package/docs/docs/cmd/spo/page/page-copy.md +65 -4
  24. package/docs/docs/cmd/spo/page/page-get.md +100 -4
  25. package/docs/docs/cmd/spo/page/page-header-set.md +17 -13
  26. package/docs/docs/cmd/spo/page/page-list.md +122 -1
  27. package/docs/docs/cmd/spo/page/page-remove.md +9 -5
  28. package/docs/docs/cmd/spo/page/page-section-add.md +10 -6
  29. package/docs/docs/cmd/spo/page/page-section-get.md +36 -4
  30. package/docs/docs/cmd/spo/page/page-section-list.md +38 -3
  31. package/docs/docs/cmd/spo/page/page-set.md +10 -10
  32. package/docs/docs/cmd/spo/page/page-template-list.md +58 -1
  33. package/docs/docs/cmd/spo/page/page-text-add.md +9 -5
  34. package/docs/docs/cmd/spo/propertybag/propertybag-get.md +28 -8
  35. package/docs/docs/cmd/spo/propertybag/propertybag-list.md +35 -7
  36. package/docs/docs/cmd/spo/propertybag/propertybag-remove.md +13 -9
  37. package/docs/docs/cmd/spo/propertybag/propertybag-set.md +13 -5
  38. package/docs/docs/cmd/spo/report/report-activityfilecounts.md +34 -2
  39. package/docs/docs/cmd/spo/report/report-activitypages.md +31 -2
  40. package/docs/docs/cmd/spo/report/report-activityusercounts.md +35 -2
  41. package/docs/docs/cmd/spo/report/report-activityuserdetail.md +40 -3
  42. package/docs/docs/cmd/spo/report/report-siteusagedetail.md +43 -3
  43. package/docs/docs/cmd/spo/report/report-siteusagefilecounts.md +33 -2
  44. package/docs/docs/cmd/spo/report/report-siteusagepages.md +32 -2
  45. package/docs/docs/cmd/spo/report/report-siteusagesitecounts.md +33 -2
  46. package/docs/docs/cmd/spo/report/report-siteusagestorage.md +32 -2
  47. package/docs/docs/cmd/spo/roledefinition/roledefinition-add.md +10 -6
  48. package/docs/docs/cmd/spo/roledefinition/roledefinition-get.md +80 -2
  49. package/docs/docs/cmd/spo/roledefinition/roledefinition-list.md +76 -2
  50. package/docs/docs/cmd/spo/roledefinition/roledefinition-remove.md +9 -5
  51. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-add.md +39 -2
  52. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-list.md +32 -0
  53. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-revoke.md +6 -2
  54. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-approve.md +14 -74
  55. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-deny.md +6 -2
  56. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-list.md +30 -0
  57. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-set.md +36 -2
  58. package/docs/docs/cmd/spo/web/web-retentionlabel-list.md +74 -0
  59. package/package.json +1 -1
  60. package/docs/docs/cmd/spo/list/list-label-set.md +0 -55
@@ -11,10 +11,10 @@ m365 spo report siteusagestorage [options]
11
11
  ## Options
12
12
 
13
13
  `-p, --period <period>`
14
- : The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
14
+ : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
15
15
 
16
16
  `-f, --outputFile [outputFile]`
17
- : Path to the file where the report should be stored in
17
+ : Path to the file where the report should be stored in.
18
18
 
19
19
  --8<-- "docs/cmd/_global.md"
20
20
 
@@ -37,3 +37,33 @@ Gets the trend of storage allocated and consumed during the last week and export
37
37
  ```sh
38
38
  m365 spo report siteusagestorage --period D7 --output json > "siteusagestorage.json"
39
39
  ```
40
+
41
+ ## Response
42
+
43
+ === "JSON"
44
+
45
+ ```json
46
+ [
47
+ {
48
+ "Report Refresh Date": "2022-11-26",
49
+ "Site Type": "All",
50
+ "Storage Used (Byte)": "2348104595",
51
+ "Report Date": "2022-11-26",
52
+ "Report Period": "7"
53
+ }
54
+ ]
55
+ ```
56
+
57
+ === "Text"
58
+
59
+ ```text
60
+ Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
61
+ 2022-11-26,All,2348104595,2022-11-26,7
62
+ ```
63
+
64
+ === "CSV"
65
+
66
+ ```csv
67
+ Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
68
+ 2022-11-26,All,2348104595,2022-11-26,7
69
+ ```
@@ -11,16 +11,16 @@ m365 spo roledefinition add [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site to which role should be added
14
+ : URL of the site to which role should be added.
15
15
 
16
16
  `-n, --name <name>`
17
- : role definition name
17
+ : role definition name.
18
18
 
19
19
  `-d, --description [description]`
20
- : role definition description
20
+ : role definition description.
21
21
 
22
22
  `--rights [rights]`
23
- : A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask,ViewListItems,AddListItems,EditListItems,DeleteListItems,ApproveItems,OpenItems,ViewVersions,DeleteVersions,CancelCheckout,ManagePersonalViews,ManageLists,ViewFormPages,AnonymousSearchAccessList,Open,ViewPages,AddAndCustomizePages,ApplyThemeAndBorder,ApplyStyleSheets,ViewUsageData,CreateSSCSite,ManageSubwebs,CreateGroups,ManagePermissions,BrowseDirectories,BrowseUserInfo,AddDelPrivateWebParts,UpdatePersonalWebParts,ManageWeb,AnonymousSearchAccessWebLists,UseClientIntegration,UseRemoteAPIs,ManageAlerts,CreateAlerts,EditMyUserInfo,EnumeratePermissions,FullMask`. Default `EmptyMask`
23
+ : A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask`, `ViewListItems`, `AddListItems`, `EditListItems`, `DeleteListItems`, `ApproveItems`, `OpenItems`, `ViewVersions`, `DeleteVersions`, `CancelCheckout`, `ManagePersonalViews`, `ManageLists`, `ViewFormPages`, `AnonymousSearchAccessList`, `Open`, `ViewPages`, `AddAndCustomizePages`, `ApplyThemeAndBorder`, `ApplyStyleSheets`, `ViewUsageData`, `CreateSSCSite`, `ManageSubwebs`, `CreateGroups`, `ManagePermissions`, `BrowseDirectories`, `BrowseUserInfo`, `AddDelPrivateWebParts`,`UpdatePersonalWebParts`, `ManageWeb`, `AnonymousSearchAccessWebLists`, `UseClientIntegration`, `UseRemoteAPIs`, `ManageAlerts`, `CreateAlerts`, `EditMyUserInfo`, `EnumeratePermissions`, `FullMask`. Default `EmptyMask`.
24
24
 
25
25
  --8<-- "docs/cmd/_global.md"
26
26
 
@@ -30,14 +30,18 @@ The `--rights` option accepts **case-sensitive** values.
30
30
 
31
31
  ## Examples
32
32
 
33
- Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_
33
+ Adds the role definition for the given site
34
34
 
35
35
  ```sh
36
36
  m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test
37
37
  ```
38
38
 
39
- Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_ and description _test description_ and rights _ViewListItems,AddListItems,EditListItems,DeleteListItems_
39
+ Adds the role definition for the given site with description and rights
40
40
 
41
41
  ```sh
42
42
  m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test --description "test description" --rights "ViewListItems,AddListItems,EditListItems,DeleteListItems"
43
43
  ```
44
+
45
+ ## Response
46
+
47
+ The command won't return a response on success.
@@ -11,7 +11,7 @@ m365 spo roledefinition get [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site for which to retrieve the role definition
14
+ : URL of the site for which to retrieve the role definition.
15
15
 
16
16
  `-i, --id <id>`
17
17
  : The Id of the role definition to retrieve.
@@ -20,8 +20,86 @@ m365 spo roledefinition get [options]
20
20
 
21
21
  ## Examples
22
22
 
23
- Retrieve the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with id _1_
23
+ Retrieve the role definition for the given site
24
24
 
25
25
  ```sh
26
26
  m365 spo roledefinition get --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
27
27
  ```
28
+
29
+ ## Response
30
+
31
+ === "JSON"
32
+
33
+ ```json
34
+ {
35
+ "BasePermissions": {
36
+ "High": "2147483647",
37
+ "Low": "4294967295"
38
+ },
39
+ "Description": "Has full control.",
40
+ "Hidden": false,
41
+ "Id": 1073741829,
42
+ "Name": "Full Control",
43
+ "Order": 1,
44
+ "RoleTypeKind": 5,
45
+ "BasePermissionsValue": [
46
+ "ViewListItems",
47
+ "AddListItems",
48
+ "EditListItems",
49
+ "DeleteListItems",
50
+ "ApproveItems",
51
+ "OpenItems",
52
+ "ViewVersions",
53
+ "DeleteVersions",
54
+ "CancelCheckout",
55
+ "ManagePersonalViews",
56
+ "ManageLists",
57
+ "ViewFormPages",
58
+ "AnonymousSearchAccessList",
59
+ "Open",
60
+ "ViewPages",
61
+ "AddAndCustomizePages",
62
+ "ApplyThemeAndBorder",
63
+ "ApplyStyleSheets",
64
+ "ViewUsageData",
65
+ "CreateSSCSite",
66
+ "ManageSubwebs",
67
+ "CreateGroups",
68
+ "ManagePermissions",
69
+ "BrowseDirectories",
70
+ "BrowseUserInfo",
71
+ "AddDelPrivateWebParts",
72
+ "UpdatePersonalWebParts",
73
+ "ManageWeb",
74
+ "AnonymousSearchAccessWebLists",
75
+ "UseClientIntegration",
76
+ "UseRemoteAPIs",
77
+ "ManageAlerts",
78
+ "CreateAlerts",
79
+ "EditMyUserInfo",
80
+ "EnumeratePermissions"
81
+ ],
82
+ "RoleTypeKindValue": "Administrator"
83
+ }
84
+ ```
85
+
86
+ === "Text"
87
+
88
+ ```text
89
+ BasePermissions : {"High":"2147483647","Low":"4294967295"}
90
+ BasePermissionsValue: ["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"]
91
+ Description : Has full control.
92
+ Hidden : false
93
+ Id : 1073741829
94
+ Name : Full Control
95
+ Order : 1
96
+ RoleTypeKind : 5
97
+ RoleTypeKindValue : Administrator
98
+ ```
99
+
100
+ === "CSV"
101
+
102
+ ```csv
103
+ BasePermissions,Description,Hidden,Id,Name,Order,RoleTypeKind,BasePermissionsValue,RoleTypeKindValue
104
+ "{""High"":""2147483647"",""Low"":""4294967295""}",Has full control.,,1073741829,Full Control,1,5,"[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""]",Administrator
105
+ ```
@@ -11,14 +11,88 @@ m365 spo roledefinition list [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site for which to retrieve role definitions
14
+ : URL of the site for which to retrieve role definitions.
15
15
 
16
16
  --8<-- "docs/cmd/_global.md"
17
17
 
18
18
  ## Examples
19
19
 
20
- Return list of role definitions for site _https://contoso.sharepoint.com/sites/project-x_
20
+ Return list of role definitions for the given site
21
21
 
22
22
  ```sh
23
23
  m365 spo roledefinition list --webUrl https://contoso.sharepoint.com/sites/project-x
24
24
  ```
25
+
26
+ ## Response
27
+
28
+ === "JSON"
29
+
30
+ ```json
31
+ [
32
+ {
33
+ "BasePermissions": {
34
+ "High": 2147483647,
35
+ "Low": 4294967295
36
+ },
37
+ "Description": "Has full control.",
38
+ "Hidden": false,
39
+ "Id": 1073741829,
40
+ "Name": "Full Control",
41
+ "Order": 1,
42
+ "RoleTypeKind": 5,
43
+ "BasePermissionsValue": [
44
+ "ViewListItems",
45
+ "AddListItems",
46
+ "EditListItems",
47
+ "DeleteListItems",
48
+ "ApproveItems",
49
+ "OpenItems",
50
+ "ViewVersions",
51
+ "DeleteVersions",
52
+ "CancelCheckout",
53
+ "ManagePersonalViews",
54
+ "ManageLists",
55
+ "ViewFormPages",
56
+ "AnonymousSearchAccessList",
57
+ "Open",
58
+ "ViewPages",
59
+ "AddAndCustomizePages",
60
+ "ApplyThemeAndBorder",
61
+ "ApplyStyleSheets",
62
+ "ViewUsageData",
63
+ "CreateSSCSite",
64
+ "ManageSubwebs",
65
+ "CreateGroups",
66
+ "ManagePermissions",
67
+ "BrowseDirectories",
68
+ "BrowseUserInfo",
69
+ "AddDelPrivateWebParts",
70
+ "UpdatePersonalWebParts",
71
+ "ManageWeb",
72
+ "AnonymousSearchAccessWebLists",
73
+ "UseClientIntegration",
74
+ "UseRemoteAPIs",
75
+ "ManageAlerts",
76
+ "CreateAlerts",
77
+ "EditMyUserInfo",
78
+ "EnumeratePermissions"
79
+ ],
80
+ "RoleTypeKindValue": "Administrator"
81
+ }
82
+ ]
83
+ ```
84
+
85
+ === "Text"
86
+
87
+ ```text
88
+ Id Name
89
+ ---------- -----------------------
90
+ 1073741829 Full Control
91
+ ```
92
+
93
+ === "CSV"
94
+
95
+ ```csv
96
+ Id,Name
97
+ 1073741829,Full Control
98
+ ```
@@ -11,26 +11,30 @@ m365 spo roledefinition remove [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site from which role should be removed
14
+ : URL of the site from which role should be removed.
15
15
 
16
16
  `-i, --id <id>`
17
- : ID of the role definition to remove
17
+ : ID of the role definition to remove.
18
18
 
19
19
  `--confirm`
20
- : Don't prompt for confirming removing the role definition
20
+ : Don't prompt for confirming removing the role definition.
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
24
24
  ## Examples
25
25
 
26
- Remove the role definition from site _https://contoso.sharepoint.com/sites/project-x_ with id _1_
26
+ Remove the role definition from the given site
27
27
 
28
28
  ```sh
29
29
  m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
30
30
  ```
31
31
 
32
- Remove the role definition from site _https://contoso.sharepoint.com/sites/project-x_ with id _1_ and don't prompt for confirmation
32
+ Remove the role definition from the given site and don't prompt for confirmation
33
33
 
34
34
  ```sh
35
35
  m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1 --confirm
36
36
  ```
37
+
38
+ ## Response
39
+
40
+ The command won't return a response on success.
@@ -17,10 +17,10 @@ m365 spo sp grant add
17
17
  ## Options
18
18
 
19
19
  `-r, --resource <resource>`
20
- : The name of the resource for which permissions should be granted
20
+ : The name of the resource for which permissions should be granted.
21
21
 
22
22
  `-s, --scope <scope>`
23
- : The name of the permission that should be granted
23
+ : The name of the permission that should be granted.
24
24
 
25
25
  --8<-- "docs/cmd/_global.md"
26
26
 
@@ -42,3 +42,40 @@ Grant the service principal permission to a custom API
42
42
  ```sh
43
43
  m365 spo serviceprincipal grant add --resource 'contoso-api' --scope 'user_impersonation'
44
44
  ```
45
+
46
+ ## Response
47
+
48
+ === "JSON"
49
+
50
+ ```json
51
+ {
52
+ "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
53
+ "ConsentType": "AllPrincipals",
54
+ "IsDomainIsolated": false,
55
+ "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
56
+ "PackageName": null,
57
+ "Resource": "Microsoft Graph",
58
+ "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
59
+ "Scope": "Mail.Read"
60
+ }
61
+ ```
62
+
63
+ === "Text"
64
+
65
+ ```text
66
+ ClientId : 6004a642-185c-479a-992a-15d1c23e2229
67
+ ConsentType : AllPrincipals
68
+ IsDomainIsolated: false
69
+ ObjectId : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
70
+ PackageName : null
71
+ Resource : Microsoft Graph
72
+ ResourceId : a46b0017-21e2-4db1-bc69-ca63576a38d6
73
+ Scope : Mail.Read
74
+ ```
75
+
76
+ === "CSV"
77
+
78
+ ```csv
79
+ ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
80
+ 6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Mail.Read
81
+ ```
@@ -30,3 +30,35 @@ List all permissions granted to the service principal
30
30
  ```sh
31
31
  m365 spo serviceprincipal grant list
32
32
  ```
33
+
34
+ ## Response
35
+
36
+ === "JSON"
37
+
38
+ ```json
39
+ [
40
+ {
41
+ "IsDomainIsolated": false,
42
+ "ObjectId": "QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E",
43
+ "PackageName": null,
44
+ "Resource": "Windows Azure Active Directory",
45
+ "ResourceId": "b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1",
46
+ "Scope": "User.Read"
47
+ }
48
+ ]
49
+ ```
50
+
51
+ === "Text"
52
+
53
+ ```text
54
+ IsDomainIsolated ObjectId PackageName Resource ResourceId Scope
55
+ ---------------- ------------------------------------------- ----------- ------------------------------ ------------------------------------ --------------------------
56
+ false QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E null Windows Azure Active Directory b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1 User.Read
57
+ ```
58
+
59
+ === "CSV"
60
+
61
+ ```csv
62
+ IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
63
+ ,QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E,,Windows Azure Active Directory,b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1,User.Read
64
+ ```
@@ -17,7 +17,7 @@ m365 spo sp grant revoke
17
17
  ## Options
18
18
 
19
19
  `-i, --id <id>`
20
- : `ObjectId` of the permission grant to revoke
20
+ : `ObjectId` of the permission grant to revoke.
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
@@ -30,8 +30,12 @@ The permission grant you want to revoke is denoted using its `ObjectId`. You can
30
30
 
31
31
  ## Examples
32
32
 
33
- Revoke permission grant with ObjectId _50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA_
33
+ Revoke permission grant
34
34
 
35
35
  ```sh
36
36
  m365 spo serviceprincipal grant revoke --id 50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA
37
37
  ```
38
+
39
+ ## Response
40
+
41
+ The command won't return a response on success.
@@ -16,14 +16,14 @@ m365 spo sp permissionrequest approve
16
16
 
17
17
  ## Options
18
18
 
19
- `-i, --id [id]`
20
- : ID of the permission request to approve
19
+ `-i, --id <id>`
20
+ : ID of the permission request to approve.
21
21
 
22
22
  `--all`
23
- : approve all pending permission requests
23
+ : approve all pending permission requests.
24
24
 
25
25
  `--resource [resource]`
26
- : The resource of the permissions requests to approve
26
+ : The resource of the permissions requests to approve.
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
@@ -36,105 +36,45 @@ The permission request you want to approve is denoted using its `ID`. You can re
36
36
 
37
37
  ## Examples
38
38
 
39
- Approve permission request with id
39
+ Approve permission request
40
40
 
41
41
  ```sh
42
42
  m365 spo serviceprincipal permissionrequest approve --id 4dc4c043-25ee-40f2-81d3-b3bf63da7538
43
43
  ```
44
44
 
45
- Approve all permission request
46
-
47
- ```sh
48
- m365 spo serviceprincipal permissionrequest approve --all
49
- ```
50
-
51
- Approve all permission request from a specific resource
52
-
53
- ```sh
54
- m365 spo serviceprincipal permissionrequest approve --resource "Microsoft Graph"
55
- ```
56
-
57
45
  ## Response
58
46
 
59
47
  === "JSON"
60
48
 
61
49
  ```json
62
50
  {
63
- "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
51
+ "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
64
52
  "ConsentType": "AllPrincipals",
65
53
  "IsDomainIsolated": false,
66
- "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
54
+ "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
67
55
  "PackageName": null,
68
56
  "Resource": "Microsoft Graph",
69
- "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
70
- "Scope": "User.Read.All"
57
+ "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
58
+ "Scope": "Reports.Read.All"
71
59
  }
72
60
  ```
73
61
 
74
62
  === "Text"
75
63
 
76
64
  ```text
77
- ClientId : 90a2c08e-e786-4100-9ea9-36c261be6c0d
65
+ ClientId : 6004a642-185c-479a-992a-15d1c23e2229
78
66
  ConsentType : AllPrincipals
79
67
  IsDomainIsolated: false
80
- ObjectId : jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM
68
+ ObjectId : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
81
69
  PackageName : null
82
70
  Resource : Microsoft Graph
83
- ResourceId : d6afc295-0a08-4777-a095-10bcb7e23903
84
- Scope : User.Read.All
85
- ```
86
-
87
- === "CSV"
88
-
89
- ```csv
90
- ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
91
- 90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,User.Read.All
92
- ```
93
-
94
- ### `all`, `resource` response
95
-
96
- When we make use of the option `all` or `resource` the response will differ.
97
-
98
- === "JSON"
99
-
100
- ```json
101
- [
102
- {
103
- "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
104
- "ConsentType": "AllPrincipals",
105
- "IsDomainIsolated": false,
106
- "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
107
- "PackageName": null,
108
- "Resource": "Microsoft Graph",
109
- "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
110
- "Scope": "User.Read.All"
111
- },
112
- {
113
- "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
114
- "ConsentType": "AllPrincipals",
115
- "IsDomainIsolated": false,
116
- "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
117
- "PackageName": null,
118
- "Resource": "Microsoft Graph",
119
- "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
120
- "Scope": "Sites.Read.All"
121
- }
122
- ]
123
- ```
124
-
125
- === "Text"
126
-
127
- ```text
128
- ClientId ConsentType IsDomainIsolated ObjectId PackageName Resource ResourceId Scope
129
- ------------------------------------ ------------- ---------------- ------------------------------------------- ----------- --------------- ------------------------------------ -----------------------
130
- 90a2c08e-e786-4100-9ea9-36c261be6c0d AllPrincipals false jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM null Microsoft Graph d6afc295-0a08-4777-a095-10bcb7e23903 User.Read.All
131
- 90a2c08e-e786-4100-9ea9-36c261be6c0d AllPrincipals false jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM null Microsoft Graph d6afc295-0a08-4777-a095-10bcb7e23903 Sites.Read.All
71
+ ResourceId : a46b0017-21e2-4db1-bc69-ca63576a38d6
72
+ Scope : Directory.ReadWrite.All
132
73
  ```
133
74
 
134
75
  === "CSV"
135
76
 
136
77
  ```csv
137
78
  ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
138
- 90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,User.Read.All
139
- 90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,Sites.Read.All
79
+ 6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,false,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,null,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Directory.ReadWrite.All
140
80
  ```
@@ -17,7 +17,7 @@ m365 spo sp permissionrequest deny
17
17
  ## Options
18
18
 
19
19
  `-i, --id <id>`
20
- : ID of the permission request to deny
20
+ : ID of the permission request to deny.
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
@@ -30,8 +30,12 @@ The permission request you want to approve is denoted using its `ID`. You can re
30
30
 
31
31
  ## Examples
32
32
 
33
- Deny permission request with id _4dc4c043-25ee-40f2-81d3-b3bf63da7538_
33
+ Deny permission request
34
34
 
35
35
  ```sh
36
36
  m365 spo serviceprincipal permissionrequest deny --id 4dc4c043-25ee-40f2-81d3-b3bf63da7538
37
37
  ```
38
+
39
+ ## Response
40
+
41
+ The command won't return a response on success.
@@ -30,3 +30,33 @@ List all pending permission requests
30
30
  ```sh
31
31
  m365 spo serviceprincipal permissionrequest list
32
32
  ```
33
+
34
+ ## Response
35
+
36
+ === "JSON"
37
+
38
+ ```json
39
+ [
40
+ {
41
+ "Id": "6eceed61-77e4-424d-ae1d-696a0de4d768",
42
+ "Resource": "Microsoft Graph",
43
+ "ResourceId": "Microsoft Graph",
44
+ "Scope": "Reports.Read.All"
45
+ }
46
+ ]
47
+ ```
48
+
49
+ === "Text"
50
+
51
+ ```text
52
+ Id Resource ResourceId Scope
53
+ ------------------------------------ --------------- --------------- -----------------------
54
+ 6eceed61-77e4-424d-ae1d-696a0de4d768 Microsoft Graph Microsoft Graph Reports.Read.All
55
+ ```
56
+
57
+ === "CSV"
58
+
59
+ ```csv
60
+ Id,Resource,ResourceId,Scope
61
+ 6eceed61-77e4-424d-ae1d-696a0de4d768,Microsoft Graph,Microsoft Graph,Reports.Read.All
62
+ ```
@@ -17,10 +17,10 @@ m365 spo sp set
17
17
  ## Options
18
18
 
19
19
  `-e, --enabled <enabled>`
20
- : Set to `true` to enable the service principal or to `false` to disable it. Valid values are `true,false`
20
+ : Set to `true` to enable the service principal or to `false` to disable it. Valid values are `true`, `false`.
21
21
 
22
22
  `--confirm`
23
- : Don't prompt for confirming enabling/disabling the service principal
23
+ : Don't prompt for confirming enabling/disabling the service principal.
24
24
 
25
25
  --8<-- "docs/cmd/_global.md"
26
26
 
@@ -50,3 +50,37 @@ Enable the service principal without prompting for confirmation
50
50
  ```sh
51
51
  m365 spo serviceprincipal set --enabled true --confirm
52
52
  ```
53
+
54
+ ## Response
55
+
56
+ === "JSON"
57
+
58
+ ```json
59
+ {
60
+ "AccountEnabled": true,
61
+ "AppId": "48535560-3cc0-442e-a1b4-94c084b3ff59",
62
+ "ReplyUrls": [
63
+ "https://fluidpreview.office.net/spfxsinglesignon",
64
+ "https://dev.fluidpreview.office.net/spfxsinglesignon",
65
+ "https://contoso.sharepoint.com/",
66
+ "https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx",
67
+ "https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect",
68
+ "https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx"
69
+ ]
70
+ }
71
+ ```
72
+
73
+ === "Text"
74
+
75
+ ```text
76
+ AccountEnabled: true
77
+ AppId : 48535560-3cc0-442e-a1b4-94c084b3ff59
78
+ ReplyUrls : ["https://fluidpreview.office.net/spfxsinglesignon","https://dev.fluidpreview.office.net/spfxsinglesignon","https://contoso.sharepoint.com/","https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx","https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect","https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx"]
79
+ ```
80
+
81
+ === "CSV"
82
+
83
+ ```csv
84
+ AccountEnabled,AppId,ReplyUrls
85
+ 1,48535560-3cc0-442e-a1b4-94c084b3ff59,"[""https://fluidpreview.office.net/spfxsinglesignon"",""https://dev.fluidpreview.office.net/spfxsinglesignon"",""https://contoso.sharepoint.com/"",""https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx"",""https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect"",""https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx""]"
86
+ ```