@pnp/cli-microsoft365 10.11.0 → 11.0.0-beta.3655c37

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 (86) hide show
  1. package/.devproxy/api-specs/sharepoint.yaml +54 -0
  2. package/.eslintrc.cjs +2 -0
  3. package/allCommands.json +1 -1
  4. package/allCommandsFull.json +1 -1
  5. package/dist/Command.js +4 -0
  6. package/dist/m365/adaptivecard/commands/adaptivecard-send.js +1 -1
  7. package/dist/m365/entra/commands/administrativeunit/administrativeunit-add.js +13 -27
  8. package/dist/m365/entra/commands/administrativeunit/administrativeunit-get.js +18 -43
  9. package/dist/m365/entra/commands/administrativeunit/administrativeunit-list.js +10 -21
  10. package/dist/m365/entra/commands/administrativeunit/administrativeunit-remove.js +25 -49
  11. package/dist/m365/entra/commands/app/app-add.js +14 -2
  12. package/dist/m365/entra/commands/roleassignment/roleassignment-add.js +146 -0
  13. package/dist/m365/entra/commands.js +1 -0
  14. package/dist/m365/flow/commands/environment/environment-get.js +19 -29
  15. package/dist/m365/graph/commands/openextension/openextension-add.js +2 -2
  16. package/dist/m365/graph/commands/openextension/openextension-set.js +2 -6
  17. package/dist/m365/outlook/commands/mail/mail-searchfolder-add.js +85 -0
  18. package/dist/m365/outlook/commands.js +1 -0
  19. package/dist/m365/pa/commands/environment/environment-get.js +18 -23
  20. package/dist/m365/pp/commands/copilot/copilot-get.js +0 -4
  21. package/dist/m365/pp/commands/copilot/copilot-list.js +0 -4
  22. package/dist/m365/pp/commands/copilot/copilot-remove.js +0 -4
  23. package/dist/m365/pp/commands/environment/environment-get.js +19 -26
  24. package/dist/m365/pp/commands.js +0 -7
  25. package/dist/m365/spfx/commands/project/project-upgrade.js +23 -66
  26. package/dist/m365/spo/commands/customaction/customaction-list.js +3 -10
  27. package/dist/m365/spo/commands/file/file-version-keep.js +78 -0
  28. package/dist/m365/spo/commands/homesite/homesite-get.js +28 -14
  29. package/dist/m365/spo/commands/homesite/homesite-list.js +1 -12
  30. package/dist/m365/spo/commands/homesite/homesite-remove.js +6 -34
  31. package/dist/m365/spo/commands/homesite/homesite-set.js +88 -44
  32. package/dist/m365/spo/commands/list/list-view-add.js +1 -1
  33. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-list.js +17 -25
  34. package/dist/m365/spo/commands.js +1 -2
  35. package/dist/m365/teams/commands/report/report-directroutingcalls.js +5 -12
  36. package/dist/m365/teams/commands/report/report-pstncalls.js +5 -12
  37. package/dist/m365/viva/commands.js +0 -3
  38. package/dist/utils/entraAdministrativeUnit.js +1 -1
  39. package/dist/utils/entraApp.js +15 -0
  40. package/docs/docs/cmd/entra/app/app-add.mdx +7 -1
  41. package/docs/docs/cmd/entra/roleassignment/roleassignment-add.mdx +163 -0
  42. package/docs/docs/cmd/flow/environment/environment-get.mdx +6 -5
  43. package/docs/docs/cmd/outlook/mail/mail-searchfolder-add.mdx +147 -0
  44. package/docs/docs/cmd/pa/environment/environment-get.mdx +5 -2
  45. package/docs/docs/cmd/pp/copilot/copilot-get.mdx +0 -6
  46. package/docs/docs/cmd/pp/copilot/copilot-list.mdx +0 -6
  47. package/docs/docs/cmd/pp/copilot/copilot-remove.mdx +0 -6
  48. package/docs/docs/cmd/pp/environment/environment-get.mdx +5 -2
  49. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +18 -5
  50. package/docs/docs/cmd/spo/file/file-version-keep.mdx +68 -0
  51. package/docs/docs/cmd/spo/homesite/homesite-get.mdx +44 -23
  52. package/docs/docs/cmd/spo/homesite/homesite-list.mdx +0 -6
  53. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +10 -35
  54. package/docs/docs/cmd/spo/homesite/homesite-set.mdx +85 -45
  55. package/docs/docs/cmd/spo/list/list-view-add.mdx +11 -11
  56. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-list.mdx +18 -18
  57. package/docs/docs/cmd/teams/report/report-directroutingcalls.mdx +25 -44
  58. package/docs/docs/cmd/teams/report/report-pstncalls.mdx +25 -48
  59. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +19 -0
  60. package/docs/docs/cmd/viva/engage/engage-community-user-add.mdx +19 -0
  61. package/docs/docs/cmd/viva/engage/engage-community-user-remove.mdx +19 -0
  62. package/npm-shrinkwrap.json +53 -53
  63. package/package.json +13 -13
  64. package/dist/m365/pp/commands/card/card-clone.js +0 -101
  65. package/dist/m365/pp/commands/card/card-get.js +0 -89
  66. package/dist/m365/pp/commands/card/card-list.js +0 -55
  67. package/dist/m365/pp/commands/card/card-remove.js +0 -105
  68. package/dist/m365/skype/commands/report/report-activitycounts.js +0 -15
  69. package/dist/m365/skype/commands/report/report-activityusercounts.js +0 -15
  70. package/dist/m365/skype/commands/report/report-activityuserdetail.js +0 -15
  71. package/dist/m365/skype/commands.js +0 -7
  72. package/dist/m365/spo/commands/mail/mail-send.js +0 -108
  73. package/dist/m365/viva/commands/engage/engage-group-list.js +0 -93
  74. package/dist/m365/viva/commands/engage/engage-group-user-add.js +0 -73
  75. package/dist/m365/viva/commands/engage/engage-group-user-remove.js +0 -88
  76. package/docs/docs/cmd/pp/card/card-clone.mdx +0 -103
  77. package/docs/docs/cmd/pp/card/card-get.mdx +0 -212
  78. package/docs/docs/cmd/pp/card/card-list.mdx +0 -163
  79. package/docs/docs/cmd/pp/card/card-remove.mdx +0 -86
  80. package/docs/docs/cmd/skype/report/report-activitycounts.mdx +0 -96
  81. package/docs/docs/cmd/skype/report/report-activityusercounts.mdx +0 -96
  82. package/docs/docs/cmd/skype/report/report-activityuserdetail.mdx +0 -134
  83. package/docs/docs/cmd/spo/mail/mail-send.mdx +0 -69
  84. package/docs/docs/cmd/viva/engage/engage-group-list.mdx +0 -174
  85. package/docs/docs/cmd/viva/engage/engage-group-user-add.mdx +0 -60
  86. package/docs/docs/cmd/viva/engage/engage-group-user-remove.mdx +0 -58
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
4
4
 
5
5
  # spo homesite set
6
6
 
7
- Sets the specified site as the Home Site
7
+ Updates an existing SharePoint home site.
8
8
 
9
9
  ## Usage
10
10
 
@@ -15,11 +15,23 @@ m365 spo homesite set [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-u, --siteUrl <siteUrl>`
19
- : The URL of the site to set as Home site.
18
+ `-u, --url <url>`
19
+ : The URL of the home site
20
+
21
+ `--draftMode [draftMode]`
22
+ : Set draft status. Valid values are: `true`, `false`.
23
+
24
+ `--audienceIds [audienceIds]`
25
+ : Comma-separated list of group Ids to set as audiences. Specify either `audienceIds` or `audienceNames`, but not both.
26
+
27
+ `--audienceNames [audienceNames]`
28
+ : Comma-separated list of group names to set as audiences. You must use either `audienceIds` or `audienceNames`, but not both. Pass `''` to clear audience.
29
+
30
+ `--targetedLicenseType [targetedLicenseType]`
31
+ : Value of either `everyone`, `frontLineWorkers` or `informationWorkers` to create an experience for a distinct audience by license type.
20
32
 
21
33
  `--vivaConnectionsDefaultStart [vivaConnectionsDefaultStart]`
22
- : When set to `true`, the Viva Connections landing experience is set to the SharePoint home site. If set to `false`, the Viva Connections home experience will be used.
34
+ : Specifies whether the home site is the default start for Viva Connections. Accepts `true` or `false`.
23
35
  ```
24
36
 
25
37
  <Global />
@@ -34,91 +46,119 @@ To use this command you must be a Global or SharePoint administrator.
34
46
 
35
47
  ## Examples
36
48
 
37
- Set the specified site as the Home Site.
49
+ Sets the home site to the provided site collection url and sets the Viva Connections landing experience to the SharePoint home site
38
50
 
39
51
  ```sh
40
- m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms
52
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart true
41
53
  ```
42
54
 
43
- Sets the Home site to the provided site collection url and sets the Viva Connections landing experience to the SharePoint home site
55
+ Set the home site in draft mode
44
56
 
45
57
  ```sh
46
- m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart true
58
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --draftMode true
47
59
  ```
48
60
 
49
- Sets the Home site to the provided site collection url and sets the Viva Connections landing experience to the default experience
61
+ Set the audience to everyone
50
62
 
51
63
  ```sh
52
- m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart false
64
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --targetedLicenseType "everyone"
53
65
  ```
54
66
 
55
- ## Response
56
-
57
- ### Standard response
58
-
59
- <Tabs>
60
- <TabItem value="JSON">
61
-
62
- ```json
63
- "The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details."
64
- ```
67
+ Set the audience to groups using groups Ids
65
68
 
66
- </TabItem>
67
- <TabItem value="Text">
69
+ ```sh
70
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceIds "978b5280-4f80-47ea-a1db-b0d1d2fb1ba4,21af775d-17b3-4637-94a4-2ba8625277cb"
71
+ ```
68
72
 
69
- ```text
70
- The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
71
- ```
73
+ Set the audience to using their display name
72
74
 
73
- </TabItem>
74
- <TabItem value="CSV">
75
+ ```sh
76
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames "Marketing, IT department"
77
+ ```
75
78
 
76
- ```csv
77
- The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
78
- ```
79
+ Clear the audience and set to draft
79
80
 
80
- </TabItem>
81
- <TabItem value="Markdown">
81
+ ```sh
82
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames '' --draftMode true
83
+ ```
82
84
 
83
- ```md
84
- The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
85
- ```
85
+ Configure multiple options
86
86
 
87
- </TabItem>
88
- </Tabs>
87
+ ```sh
88
+ m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames 'Marketing, IT department' --draftMode true --targetedLicenseType "everyone" --vivaConnectionsDefaultStart true
89
+ ```
89
90
 
90
- ### `vivaConnectionsDefaultStart` response
91
+ ## Response
91
92
 
92
- When we make use of the option `vivaConnectionsDefaultStart` the response will differ.
93
+ ### Standard response
93
94
 
94
95
  <Tabs>
95
96
  <TabItem value="JSON">
96
97
 
97
98
  ```json
98
- "The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details."
99
+ {
100
+ "Audiences": [
101
+ {
102
+ "Email": "active@contoso.onmicrosoft.com",
103
+ "Id": "7a1eea7f-9ab0-40ff-8f2e-0083d9d63451",
104
+ "Title": "active Members"
105
+ }
106
+ ],
107
+ "IsInDraftMode": true,
108
+ "IsVivaBackendSite": false,
109
+ "SiteId": "431d7819-4aaf-49a1-b664-b2fe9e609b63",
110
+ "TargetedLicenseType": 2,
111
+ "Title": "The Landing",
112
+ "Url": "https://contoso.sharepoint.com/sites/TheLanding",
113
+ "VivaConnectionsDefaultStart": true,
114
+ "WebId": "626c1724-8ac8-45d5-af87-c07c752fab75"
115
+ }
99
116
  ```
100
117
 
101
118
  </TabItem>
102
119
  <TabItem value="Text">
103
120
 
104
121
  ```text
105
- The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
122
+ Audiences : [{"Email":"active@contoso.onmicrosoft.com","Id":"7a1eea7f-9ab0-40ff-8f2e-0083d9d63451","Title":"active Members"}]
123
+ IsInDraftMode : true
124
+ IsVivaBackendSite : false
125
+ SiteId : 431d7819-4aaf-49a1-b664-b2fe9e609b63
126
+ TargetedLicenseType : 2
127
+ Title : The Landing
128
+ Url : https://contoso.sharepoint.com/sites/TheLanding
129
+ VivaConnectionsDefaultStart: true
130
+ WebId : 626c1724-8ac8-45d5-af87-c07c752fab75
106
131
  ```
107
132
 
108
133
  </TabItem>
109
134
  <TabItem value="CSV">
110
135
 
111
136
  ```csv
112
- The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
137
+ IsInDraftMode,IsVivaBackendSite,SiteId,TargetedLicenseType,Title,Url,VivaConnectionsDefaultStart,WebId
138
+ 1,0,431d7819-4aaf-49a1-b664-b2fe9e609b63,2,The Landing,https://contoso.sharepoint.com/sites/TheLanding,1,626c1724-8ac8-45d5-af87-c07c752fab75
113
139
  ```
114
-
140
+
115
141
  </TabItem>
116
142
  <TabItem value="Markdown">
117
143
 
118
144
  ```md
119
- The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
145
+ # spo homesite set --url "https://contoso.sharepoint.com/sites/TheLanding" --vivaConnectionsDefaultStart "true" --audienceNames "active"
146
+
147
+ Date: 7/27/2025
148
+
149
+ ## The Landing (https://contoso.sharepoint.com/sites/TheLanding)
150
+
151
+ Property | Value
152
+ ---------|-------
153
+ IsInDraftMode | true
154
+ IsVivaBackendSite | false
155
+ SiteId | 431d7819-4aaf-49a1-b664-b2fe9e609b63
156
+ TargetedLicenseType | 2
157
+ Title | The Landing
158
+ Url | https://contoso.sharepoint.com/sites/TheLanding
159
+ VivaConnectionsDefaultStart | true
160
+ WebId | 626c1724-8ac8-45d5-af87-c07c752fab75
120
161
  ```
121
-
122
162
  </TabItem>
123
163
  </Tabs>
124
164
 
@@ -63,8 +63,8 @@ m365 spo list view add [options]
63
63
  `--default`
64
64
  : View will be set as default view, if specified.
65
65
 
66
- `--paged`
67
- : View supports paging, if specified (recommended to use this).
66
+ `--paged [paged]`
67
+ : View supports paging. Valid values are `true`, `false`. Defaults to `true`.
68
68
 
69
69
  `--rowLimit [rowLimit]`
70
70
  : Sets the number of items to display for the view. Default value is 30.
@@ -76,7 +76,7 @@ m365 spo list view add [options]
76
76
 
77
77
  :::tip
78
78
 
79
- We recommend using the `paged` option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the `rowLimit` is absolute, and there is no link to see more items.
79
+ We recommend using the `paged` option. Paging is enabled by default: the view shows items page by page, up to the specified `rowLimit` per page. To disable paging, set `paged` to `false`; in a non-paged view, the `rowLimit` is absolute and there is no link to see more items.
80
80
 
81
81
  :::
82
82
 
@@ -85,43 +85,43 @@ We recommend using the `paged` option. When specified, the view supports display
85
85
  Add a list view called to a list with specific title.
86
86
 
87
87
  ```sh
88
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged
88
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact"
89
89
  ```
90
90
 
91
91
  Add a gallery view as default view to a list with a specific URL.
92
92
 
93
93
  ```sh
94
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --default
94
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --default
95
95
  ```
96
96
 
97
97
  Add a view with defined filter and sorting.
98
98
 
99
99
  ```sh
100
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>" --paged
100
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>"
101
101
  ```
102
102
 
103
103
  Add a gallery view as personal view.
104
104
 
105
105
  ```sh
106
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --personal
106
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --personal
107
107
  ```
108
108
 
109
109
  Add a calendar view with month layout.
110
110
 
111
111
  ```sh
112
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --paged
112
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle
113
113
  ```
114
114
 
115
115
  Add a calendar view with week layout and subtitle.
116
116
 
117
117
  ```sh
118
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week --paged
118
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week
119
119
  ```
120
120
 
121
121
  Add a Kanban board view.
122
122
 
123
123
  ```sh
124
- m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status --paged
124
+ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status
125
125
  ```
126
126
 
127
127
  ## Response
@@ -252,7 +252,7 @@ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --lis
252
252
  <TabItem value="Markdown">
253
253
 
254
254
  ```md
255
- # spo list view add --webUrl "https://contoso.sharepoint.com" --listTitle "Test" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>" --paged "true"
255
+ # spo list view add --webUrl "https://contoso.sharepoint.com" --listTitle "Test" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>"
256
256
 
257
257
  Date: 2/20/2023
258
258
 
@@ -46,12 +46,12 @@ m365 spo serviceprincipal grant list
46
46
  ```json
47
47
  [
48
48
  {
49
- "IsDomainIsolated": false,
50
- "ObjectId": "QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E",
51
- "PackageName": null,
52
- "Resource": "Windows Azure Active Directory",
53
- "ResourceId": "b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1",
54
- "Scope": "User.Read"
49
+ "clientId": "1e551032-3e2d-4d6b-9392-9b25451313a0",
50
+ "consentType": "AllPrincipals",
51
+ "id": "MhBVHi0-a02TkpslRRMToFw7FM2TduxCifs3fo6XqP8",
52
+ "principalId": null,
53
+ "resourceId": "cd143b5c-7693-42ec-89fb-377e8e97a8ff",
54
+ "scope": "User.Read"
55
55
  }
56
56
  ]
57
57
  ```
@@ -60,17 +60,17 @@ m365 spo serviceprincipal grant list
60
60
  <TabItem value="Text">
61
61
 
62
62
  ```text
63
- IsDomainIsolated ObjectId PackageName Resource ResourceId Scope
64
- ---------------- ------------------------------------------- ----------- ------------------------------ ------------------------------------ --------------------------
65
- false QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E null Windows Azure Active Directory b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1 User.Read
63
+ clientId consentType id principalId resourceId scope
64
+ ------------------------------------ ------------- ------------------------------------------- ----------- ------------------------------------ ----------
65
+ 1e551032-3e2d-4d6b-9392-9b25451313a0 AllPrincipals MhBVHi0-a02TkpslRRMToFw7FM2TduxCifs3fo6XqP8 null cd143b5c-7693-42ec-89fb-377e8e97a8ff User.Read
66
66
  ```
67
67
 
68
68
  </TabItem>
69
69
  <TabItem value="CSV">
70
70
 
71
71
  ```csv
72
- IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
73
- ,QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E,,Windows Azure Active Directory,b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1,User.Read
72
+ clientId,consentType,id,principalId,resourceId,scope
73
+ 1e551032-3e2d-4d6b-9392-9b25451313a0,AllPrincipals,MhBVHi0-a02TkpslRRMToFw7FM2TduxCifs3fo6XqP8,,cd143b5c-7693-42ec-89fb-377e8e97a8ff,User.Read
74
74
  ```
75
75
 
76
76
  </TabItem>
@@ -79,17 +79,17 @@ m365 spo serviceprincipal grant list
79
79
  ```md
80
80
  # spo serviceprincipal grant list
81
81
 
82
- Date: 5/7/2023
82
+ Date: 7/8/2025
83
83
 
84
- ## 4WtBzD8u5kW-sYuikIWL_8ZYTP5mJB1LnC6OT4Ibr94
84
+ ## MhBVHi0-a02TkpslRRMToFw7FM2TduxCifs3fo6XqP8
85
85
 
86
86
  Property | Value
87
87
  ---------|-------
88
- IsDomainIsolated | false
89
- ObjectId | 4WtBzD8u5kW-sYuikIWL\_8ZYTP5mJB1LnC6OT4Ibr94
90
- Resource | Microsoft Graph
91
- ResourceId | fe4c58c6-2466-4b1d-9c2e-8e4f821bafde
92
- Scope | Mail.Read
88
+ clientId | 1e551032-3e2d-4d6b-9392-9b25451313a0
89
+ consentType | AllPrincipals
90
+ id | MhBVHi0-a02TkpslRRMToFw7FM2TduxCifs3fo6XqP8
91
+ resourceId | cd143b5c-7693-42ec-89fb-377e8e97a8ff
92
+ scope | User.Read
93
93
  ```
94
94
 
95
95
  </TabItem>
@@ -62,42 +62,31 @@ m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020
62
62
  <TabItem value="JSON">
63
63
 
64
64
  ``` json
65
- {
66
- "@odata.count": 1,
67
- "value": [
68
- {
69
- "id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
70
- "correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
71
- "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
72
- "userPrincipalName": "richard.malk@contoso.com",
73
- "userDisplayName": "Richard Malk",
74
- "startDateTime": "2019-11-01T00:00:25.105Z",
75
- "inviteDateTime": "2019-11-01T00:00:21.949Z",
76
- "failureDateTime": "0001-01-01T00:00:00Z",
77
- "endDateTime": "2019-11-01T00:00:30.105Z",
78
- "duration": 5,
79
- "callType": "ByotIn",
80
- "successfulCall": true,
81
- "callerNumber": "+12345678***",
82
- "calleeNumber": "+01234567***",
83
- "mediaPathLocation": "USWE",
84
- "signalingLocation": "EUNO",
85
- "finalSipCode": 0,
86
- "callEndSubReason": 540000,
87
- "finalSipCodePhrase": "BYE",
88
- "trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
89
- "mediaBypassEnabled": false
90
- }
91
- ]
92
- }
93
- ```
94
-
95
- </TabItem>
96
- <TabItem value="Text">
97
-
98
- ``` text
99
- id,calleeNumber,callerNumber,startDateTime
100
- 9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
65
+ [
66
+ {
67
+ "id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
68
+ "correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
69
+ "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
70
+ "userPrincipalName": "richard.malk@contoso.com",
71
+ "userDisplayName": "Richard Malk",
72
+ "startDateTime": "2019-11-01T00:00:25.105Z",
73
+ "inviteDateTime": "2019-11-01T00:00:21.949Z",
74
+ "failureDateTime": "0001-01-01T00:00:00Z",
75
+ "endDateTime": "2019-11-01T00:00:30.105Z",
76
+ "duration": 5,
77
+ "callType": "ByotIn",
78
+ "successfulCall": true,
79
+ "callerNumber": "+12345678***",
80
+ "calleeNumber": "+01234567***",
81
+ "mediaPathLocation": "USWE",
82
+ "signalingLocation": "EUNO",
83
+ "finalSipCode": 0,
84
+ "callEndSubReason": 540000,
85
+ "finalSipCodePhrase": "BYE",
86
+ "trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
87
+ "mediaBypassEnabled": false
88
+ }
89
+ ]
101
90
  ```
102
91
 
103
92
  </TabItem>
@@ -108,14 +97,6 @@ m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020
108
97
  9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
109
98
  ```
110
99
 
111
- </TabItem>
112
- <TabItem value="Markdown">
113
-
114
- ```md
115
- id,calleeNumber,callerNumber,startDateTime
116
- 9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
117
- ```
118
-
119
100
  </TabItem>
120
101
  </Tabs>
121
102
 
@@ -56,52 +56,37 @@ Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports
56
56
  m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output json > "pstncalls.json"
57
57
  ```
58
58
 
59
- ## More information
60
-
61
- - List PSTN calls: [https://learn.microsoft.com/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)
62
-
63
59
  ## Response
64
60
 
65
61
  <Tabs>
66
62
  <TabItem value="JSON">
67
63
 
68
64
  ``` json
69
- {
70
- "@odata.count": 1,
71
- "value": [
72
- {
73
- "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
74
- "callId": "1835317186_112562680@61.221.3.176",
75
- "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
76
- "userPrincipalName": "richard.malk@contoso.com",
77
- "userDisplayName": "Richard Malk",
78
- "startDateTime": "2019-11-01T00:00:08.2589935Z",
79
- "endDateTime": "2019-11-01T00:03:47.2589935Z",
80
- "duration": 219,
81
- "charge": 0.00,
82
- "callType": "user_in",
83
- "currency": "USD",
84
- "calleeNumber": "+1234567890",
85
- "usageCountryCode": "US",
86
- "tenantCountryCode": "US",
87
- "connectionCharge": 0.00,
88
- "callerNumber": "+0123456789",
89
- "destinationContext": null,
90
- "destinationName": "United States",
91
- "conferenceId": null,
92
- "licenseCapability": "MCOPSTNU",
93
- "inventoryType": "Subscriber"
94
- }
95
- ]
96
- }
97
- ```
98
-
99
- </TabItem>
100
- <TabItem value="Text">
101
-
102
- ``` text
103
- id,calleeNumber,callerNumber,startDateTime
104
- 9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
65
+ [
66
+ {
67
+ "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
68
+ "callId": "1835317186_112562680@61.221.3.176",
69
+ "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
70
+ "userPrincipalName": "richard.malk@contoso.com",
71
+ "userDisplayName": "Richard Malk",
72
+ "startDateTime": "2019-11-01T00:00:08.2589935Z",
73
+ "endDateTime": "2019-11-01T00:03:47.2589935Z",
74
+ "duration": 219,
75
+ "charge": 0.00,
76
+ "callType": "user_in",
77
+ "currency": "USD",
78
+ "calleeNumber": "+1234567890",
79
+ "usageCountryCode": "US",
80
+ "tenantCountryCode": "US",
81
+ "connectionCharge": 0.00,
82
+ "callerNumber": "+0123456789",
83
+ "destinationContext": null,
84
+ "destinationName": "United States",
85
+ "conferenceId": null,
86
+ "licenseCapability": "MCOPSTNU",
87
+ "inventoryType": "Subscriber"
88
+ }
89
+ ]
105
90
  ```
106
91
 
107
92
  </TabItem>
@@ -112,14 +97,6 @@ m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --
112
97
  9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
113
98
  ```
114
99
 
115
- </TabItem>
116
- <TabItem value="Markdown">
117
-
118
- ```md
119
- id,calleeNumber,callerNumber,startDateTime
120
- 9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
121
- ```
122
-
123
100
  </TabItem>
124
101
  </Tabs>
125
102
 
@@ -16,6 +16,25 @@ m365 viva engage community list [options]
16
16
 
17
17
  <Global />
18
18
 
19
+ ## Permissions
20
+
21
+ <Tabs>
22
+ <TabItem value="Delegated">
23
+
24
+ | Resource | Permissions |
25
+ |-----------------|--------------------|
26
+ | Microsoft Graph | Community.Read.All |
27
+
28
+ </TabItem>
29
+ <TabItem value="Application">
30
+
31
+ | Resource | Permissions |
32
+ |-----------------|--------------------|
33
+ | Microsoft Graph | Community.Read.All |
34
+
35
+ </TabItem>
36
+ </Tabs>
37
+
19
38
  ## Examples
20
39
 
21
40
  Lists all Viva Engage communities
@@ -36,6 +36,25 @@ m365 viva engage community user add [options]
36
36
 
37
37
  <Global />
38
38
 
39
+ ## Permissions
40
+
41
+ <Tabs>
42
+ <TabItem value="Delegated">
43
+
44
+ | Resource | Permissions |
45
+ |-----------------|---------------------------|
46
+ | Microsoft Graph | GroupMember.ReadWrite.All |
47
+
48
+ </TabItem>
49
+ <TabItem value="Application">
50
+
51
+ | Resource | Permissions |
52
+ |-----------------|---------------------------|
53
+ | Microsoft Graph | GroupMember.ReadWrite.All |
54
+
55
+ </TabItem>
56
+ </Tabs>
57
+
39
58
  ## Examples
40
59
 
41
60
  Add a single user specified by ID as a member to a community specified by display name.
@@ -36,6 +36,25 @@ m365 viva engage community user remove [options]
36
36
 
37
37
  <Global />
38
38
 
39
+ ## Permissions
40
+
41
+ <Tabs>
42
+ <TabItem value="Delegated">
43
+
44
+ | Resource | Permissions |
45
+ |-----------------|---------------------------|
46
+ | Microsoft Graph | GroupMember.ReadWrite.All |
47
+
48
+ </TabItem>
49
+ <TabItem value="Application">
50
+
51
+ | Resource | Permissions |
52
+ |-----------------|---------------------------|
53
+ | Microsoft Graph | GroupMember.ReadWrite.All |
54
+
55
+ </TabItem>
56
+ </Tabs>
57
+
39
58
  ## Examples
40
59
 
41
60
  Remove a user specified by ID as a member from a community specified by display name.