@pnp/cli-microsoft365 7.0.0-beta.093ef31 → 7.0.0-beta.14c7857

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 (159) hide show
  1. package/README.md +4 -4
  2. package/dist/Auth.js +10 -1
  3. package/dist/cli/Cli.js +3 -3
  4. package/dist/m365/aad/commands/app/app-get.js +4 -1
  5. package/dist/m365/aad/commands/app/app-remove.js +3 -1
  6. package/dist/m365/aad/commands/app/app-role-add.js +4 -1
  7. package/dist/m365/aad/commands/app/app-role-list.js +4 -1
  8. package/dist/m365/aad/commands/app/app-role-remove.js +5 -2
  9. package/dist/m365/aad/commands/app/app-set.js +8 -5
  10. package/dist/m365/aad/commands/approleassignment/approleassignment-add.js +11 -6
  11. package/dist/m365/aad/commands/approleassignment/approleassignment-remove.js +4 -4
  12. package/dist/m365/aad/commands/group/group-get.js +4 -4
  13. package/dist/m365/aad/commands/group/group-list.js +1 -23
  14. package/dist/m365/aad/commands/group/group-remove.js +98 -0
  15. package/dist/m365/aad/commands/m365group/m365group-add.js +21 -12
  16. package/dist/m365/aad/commands/m365group/m365group-recyclebinitem-remove.js +3 -1
  17. package/dist/m365/aad/commands/m365group/m365group-recyclebinitem-restore.js +4 -1
  18. package/dist/m365/aad/commands/m365group/m365group-teamify.js +4 -1
  19. package/dist/m365/aad/commands/sp/sp-add.js +4 -1
  20. package/dist/m365/aad/commands/sp/sp-get.js +4 -1
  21. package/dist/m365/aad/commands/user/user-get.js +7 -2
  22. package/dist/m365/aad/commands.js +1 -0
  23. package/dist/m365/booking/commands/business/business-get.js +4 -1
  24. package/dist/m365/commands/login.js +2 -2
  25. package/dist/m365/graph/commands/subscription/subscription-add.js +5 -5
  26. package/dist/m365/outlook/commands/message/message-list.js +4 -2
  27. package/dist/m365/outlook/commands/message/message-move.js +4 -2
  28. package/dist/m365/pa/commands/app/app-export.js +7 -7
  29. package/dist/m365/planner/commands/bucket/bucket-add.js +4 -1
  30. package/dist/m365/planner/commands/bucket/bucket-get.js +9 -2
  31. package/dist/m365/planner/commands/bucket/bucket-list.js +4 -1
  32. package/dist/m365/planner/commands/bucket/bucket-remove.js +7 -2
  33. package/dist/m365/planner/commands/bucket/bucket-set.js +8 -2
  34. package/dist/m365/planner/commands/plan/plan-add.js +4 -1
  35. package/dist/m365/planner/commands/plan/plan-get.js +4 -1
  36. package/dist/m365/planner/commands/plan/plan-list.js +4 -1
  37. package/dist/m365/planner/commands/plan/plan-remove.js +4 -1
  38. package/dist/m365/planner/commands/plan/plan-set.js +4 -1
  39. package/dist/m365/planner/commands/roster/roster-get.js +4 -1
  40. package/dist/m365/planner/commands/roster/roster-member-add.js +4 -1
  41. package/dist/m365/planner/commands/roster/roster-member-get.js +4 -1
  42. package/dist/m365/planner/commands/roster/roster-member-list.js +4 -1
  43. package/dist/m365/planner/commands/roster/roster-member-remove.js +4 -1
  44. package/dist/m365/planner/commands/roster/roster-plan-list.js +4 -1
  45. package/dist/m365/planner/commands/roster/roster-remove.js +4 -1
  46. package/dist/m365/planner/commands/task/task-add.js +4 -1
  47. package/dist/m365/planner/commands/task/task-checklistitem-add.js +4 -1
  48. package/dist/m365/planner/commands/task/task-checklistitem-list.js +4 -1
  49. package/dist/m365/planner/commands/task/task-checklistitem-remove.js +4 -1
  50. package/dist/m365/planner/commands/task/task-get.js +11 -3
  51. package/dist/m365/planner/commands/task/task-list.js +10 -2
  52. package/dist/m365/planner/commands/task/task-reference-add.js +4 -1
  53. package/dist/m365/planner/commands/task/task-reference-list.js +4 -1
  54. package/dist/m365/planner/commands/task/task-reference-remove.js +4 -1
  55. package/dist/m365/planner/commands/task/task-remove.js +10 -4
  56. package/dist/m365/planner/commands/task/task-set.js +4 -1
  57. package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-get.js +4 -1
  58. package/dist/m365/pp/commands/card/card-get.js +3 -5
  59. package/dist/m365/pp/commands/chatbot/chatbot-get.js +3 -1
  60. package/dist/m365/pp/commands/managementapp/managementapp-add.js +4 -1
  61. package/dist/m365/search/commands/externalconnection/externalconnection-remove.js +3 -1
  62. package/dist/m365/spfx/commands/project/project-doctor/{doctor-1.18.0-beta.5.js → doctor-1.18.0.js} +2 -2
  63. package/dist/m365/spfx/commands/project/project-doctor.js +1 -1
  64. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN001022_DEP_office_ui_fabric_react.js +1 -1
  65. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN002028_DEVDEP_microsoft_rush_stack_compiler_4_7.js +13 -0
  66. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.18.0-beta.5.js → upgrade-1.18.0.js} +35 -27
  67. package/dist/m365/spfx/commands/project/project-upgrade.js +13 -15
  68. package/dist/m365/spfx/commands/spfx-doctor.js +3 -3
  69. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +5 -3
  70. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-remove.js +2 -2
  71. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-set.js +3 -2
  72. package/dist/m365/spo/commands/commandset/commandset-get.js +4 -2
  73. package/dist/m365/spo/commands/commandset/commandset-remove.js +2 -1
  74. package/dist/m365/spo/commands/commandset/commandset-set.js +3 -1
  75. package/dist/m365/spo/commands/customaction/customaction-get.js +5 -2
  76. package/dist/m365/spo/commands/customaction/customaction-remove.js +3 -1
  77. package/dist/m365/spo/commands/eventreceiver/eventreceiver-get.js +3 -1
  78. package/dist/m365/spo/commands/file/file-get.js +11 -8
  79. package/dist/m365/spo/commands/file/file-remove.js +2 -2
  80. package/dist/m365/spo/commands/file/file-version-clear.js +2 -2
  81. package/dist/m365/spo/commands/file/file-version-get.js +2 -2
  82. package/dist/m365/spo/commands/file/file-version-list.js +2 -2
  83. package/dist/m365/spo/commands/file/file-version-remove.js +2 -2
  84. package/dist/m365/spo/commands/file/file-version-restore.js +2 -2
  85. package/dist/m365/spo/commands/group/group-member-add.js +24 -24
  86. package/dist/m365/spo/commands/hubsite/hubsite-connect.js +7 -4
  87. package/dist/m365/spo/commands/hubsite/hubsite-disconnect.js +4 -1
  88. package/dist/m365/spo/commands/hubsite/hubsite-get.js +3 -1
  89. package/dist/m365/spo/commands/listitem/listitem-add.js +1 -0
  90. package/dist/m365/spo/commands/listitem/listitem-set.js +3 -2
  91. package/dist/m365/spo/commands/page/clientsidepages.js +18 -0
  92. package/dist/m365/spo/commands/page/page-get.js +1 -0
  93. package/dist/m365/spo/commands/page/page-list.js +4 -3
  94. package/dist/m365/spo/commands/page/page-section-add.js +56 -21
  95. package/dist/m365/spo/commands/page/page-set.js +13 -2
  96. package/dist/m365/spo/commands/site/site-commsite-enable.js +34 -5
  97. package/dist/m365/spo/commands/site/site-list.js +5 -7
  98. package/dist/m365/spo/commands/tenant/tenant-appcatalog-add.js +1 -1
  99. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +8 -3
  100. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-list.js +3 -2
  101. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-remove.js +2 -1
  102. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-set.js +3 -2
  103. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +8 -3
  104. package/dist/m365/spo/commands/tenant/tenant-commandset-list.js +3 -2
  105. package/dist/m365/spo/commands/tenant/tenant-commandset-remove.js +3 -1
  106. package/dist/m365/spo/commands/term/term-get.js +6 -6
  107. package/dist/m365/teams/commands/app/app-remove.js +49 -15
  108. package/dist/m365/teams/commands/channel/channel-add.js +5 -1
  109. package/dist/m365/teams/commands/channel/channel-member-add.js +12 -10
  110. package/dist/m365/teams/commands/channel/channel-member-remove.js +3 -1
  111. package/dist/m365/teams/commands/channel/channel-member-set.js +4 -1
  112. package/dist/m365/teams/commands/chat/chat-get.js +7 -10
  113. package/dist/m365/teams/commands/chat/chat-message-send.js +8 -10
  114. package/dist/m365/teams/commands/team/team-clone.js +5 -10
  115. package/dist/m365/teams/commands/team/team-list.js +94 -30
  116. package/dist/m365/tenant/commands/info/info-get.js +83 -0
  117. package/dist/m365/tenant/commands.js +1 -0
  118. package/dist/utils/aadGroup.js +5 -3
  119. package/dist/utils/formatting.js +7 -0
  120. package/dist/utils/powerPlatform.js +1 -1
  121. package/docs/docs/cmd/aad/app/app-set.mdx +15 -15
  122. package/docs/docs/cmd/aad/approleassignment/approleassignment-add.mdx +9 -9
  123. package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.mdx +10 -10
  124. package/docs/docs/cmd/aad/group/group-get.mdx +5 -5
  125. package/docs/docs/cmd/aad/group/group-list.mdx +0 -11
  126. package/docs/docs/cmd/aad/group/group-remove.mdx +44 -0
  127. package/docs/docs/cmd/aad/m365group/m365group-add.mdx +13 -3
  128. package/docs/docs/cmd/aad/policy/policy-list.mdx +5 -5
  129. package/docs/docs/cmd/cli/config/config-list.mdx +1 -1
  130. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +10 -10
  131. package/docs/docs/cmd/pa/app/app-export.mdx +5 -5
  132. package/docs/docs/cmd/pp/solution/solution-publisher-get.mdx +2 -2
  133. package/docs/docs/cmd/pp/solution/solution-publisher-remove.mdx +2 -2
  134. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +1 -1
  135. package/docs/docs/cmd/spo/file/file-get.mdx +2 -2
  136. package/docs/docs/cmd/spo/file/file-remove.mdx +2 -2
  137. package/docs/docs/cmd/spo/file/file-version-clear.mdx +2 -2
  138. package/docs/docs/cmd/spo/file/file-version-get.mdx +2 -2
  139. package/docs/docs/cmd/spo/file/file-version-list.mdx +2 -2
  140. package/docs/docs/cmd/spo/file/file-version-remove.mdx +2 -2
  141. package/docs/docs/cmd/spo/file/file-version-restore.mdx +2 -2
  142. package/docs/docs/cmd/spo/group/group-member-add.mdx +27 -27
  143. package/docs/docs/cmd/spo/list/list-contenttype-remove.mdx +1 -1
  144. package/docs/docs/cmd/spo/listitem/listitem-add.mdx +2 -5
  145. package/docs/docs/cmd/spo/listitem/listitem-set.mdx +2 -5
  146. package/docs/docs/cmd/spo/page/page-get.mdx +0 -1
  147. package/docs/docs/cmd/spo/page/page-list.mdx +0 -1
  148. package/docs/docs/cmd/spo/page/page-section-add.mdx +25 -1
  149. package/docs/docs/cmd/spo/page/page-set.mdx +23 -0
  150. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +11 -2
  151. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +2 -4
  152. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +2 -4
  153. package/docs/docs/cmd/teams/app/app-remove.mdx +9 -6
  154. package/docs/docs/cmd/teams/channel/channel-member-add.mdx +4 -4
  155. package/docs/docs/cmd/teams/team/team-clone.mdx +3 -3
  156. package/docs/docs/cmd/teams/team/team-list.mdx +47 -22
  157. package/docs/docs/cmd/tenant/info/info-get.mdx +101 -0
  158. package/npm-shrinkwrap.json +24 -24
  159. package/package.json +8 -12
@@ -1,6 +1,7 @@
1
1
  const prefix = 'tenant';
2
2
  export default {
3
3
  ID_GET: `${prefix} id get`,
4
+ INFO_GET: `${prefix} info get`,
4
5
  REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
5
6
  REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
6
7
  REPORT_OFFICE365ACTIVATIONCOUNTS: `${prefix} report office365activationcounts`,
@@ -1,13 +1,14 @@
1
1
  import request from "../request.js";
2
2
  import { formatting } from "./formatting.js";
3
3
  import { odata } from "./odata.js";
4
+ import { Cli } from '../cli/Cli.js';
4
5
  const graphResource = 'https://graph.microsoft.com';
5
6
  export const aadGroup = {
6
7
  /**
7
8
  * Retrieve a single group.
8
9
  * @param id Group ID.
9
10
  */
10
- getGroupById(id) {
11
+ async getGroupById(id) {
11
12
  const requestOptions = {
12
13
  url: `${graphResource}/v1.0/groups/${id}`,
13
14
  headers: {
@@ -21,7 +22,7 @@ export const aadGroup = {
21
22
  * Get a list of groups by display name.
22
23
  * @param displayName Group display name.
23
24
  */
24
- getGroupsByDisplayName(displayName) {
25
+ async getGroupsByDisplayName(displayName) {
25
26
  return odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
26
27
  },
27
28
  /**
@@ -36,7 +37,8 @@ export const aadGroup = {
36
37
  throw Error(`The specified group '${displayName}' does not exist.`);
37
38
  }
38
39
  if (groups.length > 1) {
39
- throw Error(`Multiple groups with name '${displayName}' found: ${groups.map(x => x.id).join(',')}.`);
40
+ const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', groups);
41
+ return await Cli.handleMultipleResultsFound(`Multiple groups with name '${displayName}' found.`, resultAsKeyValuePair);
40
42
  }
41
43
  return groups[0];
42
44
  },
@@ -153,6 +153,13 @@ export const formatting = {
153
153
  const success = primarySupported ? '✔' : '√';
154
154
  const failure = primarySupported ? '✖' : '×';
155
155
  return `${result === CheckStatus.Success ? chalk.green(success) : chalk.red(failure)} ${message}`;
156
+ },
157
+ convertArrayToHashTable(key, array) {
158
+ const resultAsKeyValuePair = {};
159
+ array.forEach((obj) => {
160
+ resultAsKeyValuePair[obj[key]] = obj;
161
+ });
162
+ return resultAsKeyValuePair;
156
163
  }
157
164
  };
158
165
  //# sourceMappingURL=formatting.js.map
@@ -19,7 +19,7 @@ export const powerPlatform = {
19
19
  };
20
20
  try {
21
21
  const response = await request.get(requestOptions);
22
- return Promise.resolve(response.properties.linkedEnvironmentMetadata.instanceApiUrl);
22
+ return response.properties.linkedEnvironmentMetadata.instanceApiUrl;
23
23
  }
24
24
  catch (ex) {
25
25
  throw Error(`The environment '${environment}' could not be retrieved. See the inner exception for more details: ${ex.message}`);
@@ -14,34 +14,34 @@ m365 aad app set [options]
14
14
 
15
15
  ```md definition-list
16
16
  `--appId [appId]`
17
- : Application (client) ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`
17
+ : Application (client) ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
18
18
 
19
19
  `--objectId [objectId]`
20
- : Object ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`
20
+ : Object ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
21
21
 
22
22
  `--name [name]`
23
- : Name of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`
23
+ : Name of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
24
24
 
25
- `-u, --uri [uri]`
26
- : Comma-separated list of Application ID URIs to update
25
+ `-u, --uris [uris]`
26
+ : Comma-separated list of Application ID URIs to update.
27
27
 
28
28
  `-r, --redirectUris [redirectUris]`
29
- : Comma-separated list of redirect URIs to add to the app registration. Requires `platform` to be specified
29
+ : Comma-separated list of redirect URIs to add to the app registration. Requires `platform` to be specified.
30
30
 
31
31
  `-p, --platform [platform]`
32
- : Platform for which the `redirectUri` should be configured. Allowed values `spa`, `web`, `publicClient`
32
+ : Platform for which the `redirectUri` should be configured. Allowed values `spa`, `web`, `publicClient`.
33
33
 
34
34
  `--redirectUrisToRemove [redirectUrisToRemove]`
35
- : Comma-separated list of existing redirect URIs to remove. Specify, when you want to replace existing redirect URIs with another
35
+ : Comma-separated list of existing redirect URIs to remove. Specify, when you want to replace existing redirect URIs with another.
36
36
 
37
37
  `--certificateFile [certificateFile]`
38
- : Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`
38
+ : Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
39
39
 
40
40
  `--certificateBase64Encoded [certificateBase64Encoded]`
41
- : Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`
41
+ : Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
42
42
 
43
43
  `--certificateDisplayName [certificateDisplayName]`
44
- : Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`
44
+ : Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`.
45
45
  ```
46
46
 
47
47
  <Global />
@@ -59,19 +59,19 @@ When a certificate is specified it will be added to the list of certificates of
59
59
  Update the app URI of the Azure AD application registration specified by its object ID
60
60
 
61
61
  ```sh
62
- m365 aad app set --objectId d75be2e1-0204-4f95-857d-51a37cf40be8 --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
62
+ m365 aad app set --objectId d75be2e1-0204-4f95-857d-51a37cf40be8 --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
63
63
  ```
64
64
 
65
65
  Update the app URI of the Azure AD application registration specified by its app (client) ID
66
66
 
67
67
  ```sh
68
- m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
68
+ m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
69
69
  ```
70
70
 
71
71
  Update the app URI of the Azure AD application registration specified by its name
72
72
 
73
73
  ```sh
74
- m365 aad app set --name "My app" --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
74
+ m365 aad app set --name "My app" --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
75
75
  ```
76
76
 
77
77
  Add a new redirect URI for SPA authentication
@@ -94,4 +94,4 @@ m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --certificateDispl
94
94
 
95
95
  ## Response
96
96
 
97
- The command won't return a response on success.
97
+ The command won't return a response on success.
@@ -16,19 +16,19 @@ m365 aad approleassignment add [options]
16
16
 
17
17
  ```md definition-list
18
18
  `--appId [appId]`
19
- : Application appId also known as clientId of the App Registration to which the configured scopes (app roles) should be applied
19
+ : Application appId also known as clientId of the App Registration to which the configured scopes (app roles) should be applied.
20
20
 
21
21
  `--appObjectId [appObjectId]`
22
- : Application objectId of the App Registration to which the configured scopes (app roles) should be applied
22
+ : Application objectId of the App Registration to which the configured scopes (app roles) should be applied.
23
23
 
24
24
  `--appDisplayName [appDisplayName]`
25
- : Application name of the App Registration to which the configured scopes (app roles) should be applied
25
+ : Application name of the App Registration to which the configured scopes (app roles) should be applied.
26
26
 
27
27
  `-r, --resource <resource>`
28
28
  : Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`.
29
29
 
30
- `-s, --scope <scope>`
31
- : Permissions known also as scopes and roles to grant the application with. If multiple permissions have to be granted, they have to be comma-separated e.g. `Sites.Read.All`, `Sites.ReadWrite.all`
30
+ `-s, --scopes <scopes>`
31
+ : Permissions known also as scopes and roles to grant the application with. If multiple permissions have to be granted, they have to be comma-separated e.g. `Sites.Read.All`, `Sites.ReadWrite.all`.
32
32
  ```
33
33
 
34
34
  <Global />
@@ -48,19 +48,19 @@ This command can also be used to assign permissions to system or user-assigned m
48
48
  Adds SharePoint _Sites.Read.All_ application permissions to Azure AD application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_
49
49
 
50
50
  ```sh
51
- m365 aad approleassignment add --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scope "Sites.Read.All"
51
+ m365 aad approleassignment add --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scopes "Sites.Read.All"
52
52
  ```
53
53
 
54
54
  Adds multiple Microsoft Graph application permissions to an Azure AD application with the name _MyAppName__
55
55
 
56
56
  ```sh
57
- m365 aad approleassignment add --appDisplayName "MyAppName" --resource "Microsoft Graph" --scope "Mail.Read,Mail.Send"
57
+ m365 aad approleassignment add --appDisplayName "MyAppName" --resource "Microsoft Graph" --scopes "Mail.Read,Mail.Send"
58
58
  ```
59
59
 
60
60
  Adds Microsoft Graph _Mail.Read_ application permissions to a system-managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
61
61
 
62
62
  ```sh
63
- m365 aad approleassignment add --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scope "Mail.Read"
63
+ m365 aad approleassignment add --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scopes "Mail.Read"
64
64
  ```
65
65
 
66
66
  ## Response
@@ -106,7 +106,7 @@ m365 aad approleassignment add --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e4
106
106
  <TabItem value="Markdown">
107
107
 
108
108
  ```md
109
- # aad approleassignment add --appId "e89804ac-a571-48cf-b2ba-fd57b5d49993" --resource "Microsoft Graph" --scope "Mail.Read"
109
+ # aad approleassignment add --appId "e89804ac-a571-48cf-b2ba-fd57b5d49993" --resource "Microsoft Graph" --scopes "Mail.Read"
110
110
 
111
111
  Date: 2023-06-01
112
112
 
@@ -14,22 +14,22 @@ m365 aad approleassignment remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `--appId [appId]`
17
- : Application appId also known as clientId of the App Registration for which the configured scopes (app roles) should be deleted
17
+ : Application appId also known as clientId of the App Registration for which the configured scopes (app roles) should be deleted.
18
18
 
19
19
  `--appObjectId [appObjectId]`
20
- : Application objectId of the App Registration for which the configured scopes (app roles) should be deleted
20
+ : Application objectId of the App Registration for which the configured scopes (app roles) should be deleted.
21
21
 
22
22
  `--appDisplayName [appDisplayName]`
23
- : Application name of the App Registration for which the configured scopes (app roles) should be deleted
23
+ : Application name of the App Registration for which the configured scopes (app roles) should be deleted.
24
24
 
25
25
  `-r, --resource <resource>`
26
- : Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`
26
+ : Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`.
27
27
 
28
- `-s, --scope <scope>`
29
- : Permissions known also as scopes and roles to be deleted from the application. If multiple permissions have to be deleted, they have to be comma-separated e.g. `Sites.Read.All`,`Sites.ReadWrite.All`
28
+ `-s, --scopes <scopes>`
29
+ : Permissions known also as scopes and roles to be deleted from the application. If multiple permissions have to be deleted, they have to be comma-separated e.g. `Sites.Read.All`,`Sites.ReadWrite.All`.
30
30
 
31
31
  `-f, --force`
32
- : Don't prompt for confirming removing the all role assignment
32
+ : Don't prompt for confirming removing the all role assignment.
33
33
  ```
34
34
 
35
35
  <Global />
@@ -49,19 +49,19 @@ This command can also be used to assign permissions to system- or user-assigned
49
49
  Deletes SharePoint _Sites.Read.All_ application permissions from Azure AD application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_
50
50
 
51
51
  ```sh
52
- m365 aad approleassignment remove --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scope "Sites.Read.All"
52
+ m365 aad approleassignment remove --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scopes "Sites.Read.All"
53
53
  ```
54
54
 
55
55
  Deletes multiple Microsoft Graph application permissions from an Azure AD application with name _MyAppName_
56
56
 
57
57
  ```sh
58
- m365 aad approleassignment remove --appDisplayName "MyAppName" --resource "Microsoft Graph" --scope "Mail.Read,Mail.Send"
58
+ m365 aad approleassignment remove --appDisplayName "MyAppName" --resource "Microsoft Graph" --scopes "Mail.Read,Mail.Send"
59
59
  ```
60
60
 
61
61
  Deletes Microsoft Graph _Mail.Read_ application permissions from a system-managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
62
62
 
63
63
  ```sh
64
- m365 aad approleassignment remove --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scope "Mail.Read"
64
+ m365 aad approleassignment remove --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scopes "Mail.Read"
65
65
  ```
66
66
 
67
67
  ## Response
@@ -16,10 +16,10 @@ m365 aad group get [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-i, --id [id]`
19
- : The object Id of the Azure AD group. Specify either `id` or `title` but not both
19
+ : The object Id of the Azure AD group. Specify either `id` or `displayName` but not both.
20
20
 
21
- `-t, --title [title]`
22
- : The display name of the Azure AD group. Specify either `id` or `title` but not both
21
+ `-n, --displayName [displayName]`
22
+ : The display name of the Azure AD group. Specify either `id` or `displayName` but not both.
23
23
  ```
24
24
 
25
25
  <Global />
@@ -32,10 +32,10 @@ Get information about an Azure AD Group by id
32
32
  m365 aad group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
33
33
  ```
34
34
 
35
- Get information about an Azure AD Group by title
35
+ Get information about an Azure AD Group by its display name
36
36
 
37
37
  ```sh
38
- m365 aad group get --title "Finance"
38
+ m365 aad group get --displayName Finance
39
39
  ```
40
40
 
41
41
  ## Response
@@ -14,11 +14,6 @@ m365 aad group list [options]
14
14
 
15
15
  ## Options
16
16
 
17
- ```md definition-list
18
- `-d, --deleted`
19
- : Use to retrieve deleted groups
20
- ```
21
-
22
17
  <Global />
23
18
 
24
19
  ## Examples
@@ -29,12 +24,6 @@ Lists all groups defined in Azure Active Directory.
29
24
  m365 aad group list
30
25
  ```
31
26
 
32
- List all recently deleted groups in the tenant
33
-
34
- ```sh
35
- m365 aad group list --deleted
36
- ```
37
-
38
27
  ## Response
39
28
 
40
29
  <Tabs>
@@ -0,0 +1,44 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # aad group remove
4
+
5
+ Removes an Azure AD group
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 aad group remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The ID of the Azure AD group. Specify either `id` or `displayName` but not both.
18
+
19
+ `-n, --displayName [displayName]`
20
+ : The display name of the Azure AD group. Specify either `id` or `displayName` but not both.
21
+
22
+ `-f, --force`
23
+ : Don't prompt for confirmation.
24
+ ```
25
+
26
+ <Global />
27
+
28
+ ## Examples
29
+
30
+ Remove an Azure AD group by display name
31
+
32
+ ```sh
33
+ m365 aad group remove --displayName Developers
34
+ ```
35
+
36
+ Remove an Azure AD group by ID
37
+
38
+ ```sh
39
+ m365 aad group remove --id 016bf125-195b-43c5-a1a0-28ccd3192c6d
40
+ ```
41
+
42
+ ## Response
43
+
44
+ The command won't return a response on success.
@@ -30,8 +30,8 @@ m365 aad m365group add [options]
30
30
  `--members [members]`
31
31
  : Comma-separated list of Microsoft 365 Group members
32
32
 
33
- `--isPrivate`
34
- : Specify, if the Microsoft 365 Group should be private. If not specified, will create a public group (default)
33
+ `--visibility [visibility]`
34
+ : Specifies the group join policy and group content visibility for groups. Possible values are: `Private`, `Public`, or `HiddenMembership`. Defaults to `Public`.
35
35
 
36
36
  `--allowMembersToPost [allowMembersToPost]`
37
37
  : Set if only group members should be able to post conversations to the group
@@ -53,9 +53,19 @@ m365 aad m365group add [options]
53
53
 
54
54
  ## Remarks
55
55
 
56
+ You cannot change the group type when you choose `HiddenMembership` visibility. HiddenMembership can be set only for Microsoft 365 groups, when the groups are created. It can't be updated later.
57
+
56
58
  When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
57
59
  If an invalid user is provided in the comma-separated list of Owners or Members, the command operation will fail and the Microsoft 365 Group will not be created.
58
60
 
61
+ Group visibility options:
62
+
63
+ Value | Description
64
+ -------|-------------
65
+ Public | Anyone can join the group without needing owner permission. Anyone can view the attributes of the group. Anyone can see the members of the group.
66
+ Private | Owner permission is needed to join the group. Anyone can view the attributes of the group. Anyone can see the members of the group.
67
+ HiddenMembership | Owner permission is needed to join the group. Guest users cannot view the attributes of the group. Non-members cannot see the members of the group. Administrators (global, company, user, and helpdesk) can view the membership of the group. The group appears in the global address book (GAL).
68
+
59
69
  ## Examples
60
70
 
61
71
  Create a public Microsoft 365 Group
@@ -67,7 +77,7 @@ m365 aad m365group add --displayName Finance --description "This is the Contoso
67
77
  Create a private Microsoft 365 Group
68
78
 
69
79
  ```sh
70
- m365 aad m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate
80
+ m365 aad m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --visibility Private
71
81
  ```
72
82
 
73
83
  Create a public Microsoft 365 Group and set specified users as its owners
@@ -35,10 +35,6 @@ Returns claim-mapping policies from Azure AD
35
35
  m365 aad policy list --type "claimsMapping"
36
36
  ```
37
37
 
38
- ## More information
39
-
40
- - Microsoft Graph Azure AD policy overview: [https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0)
41
-
42
38
  ## Response
43
39
 
44
40
  <Tabs>
@@ -112,4 +108,8 @@ m365 aad policy list --type "claimsMapping"
112
108
  ```
113
109
 
114
110
  </TabItem>
115
- </Tabs>
111
+ </Tabs>
112
+
113
+ ## More information
114
+
115
+ - Microsoft Graph Azure AD policy overview: [https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0)
@@ -5,7 +5,7 @@ import TabItem from '@theme/TabItem';
5
5
 
6
6
  # cli config list
7
7
 
8
- List all self set CLI for Microsoft 365 configurations
8
+ List all self-set CLI for Microsoft 365 configurations
9
9
 
10
10
  ## Usage
11
11
 
@@ -16,19 +16,19 @@ m365 graph subscription add [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-r, --resource <resource>`
19
- : The resource that will be monitored for changes
19
+ : The resource that will be monitored for changes.
20
20
 
21
- `-c, --changeType <changeType>`
22
- : The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list
21
+ `-c, --changeTypes <changeTypes>`
22
+ : The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list.
23
23
 
24
24
  `-u, --notificationUrl <notificationUrl>`
25
- : The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol
25
+ : The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol.
26
26
 
27
27
  `-e, --expirationDateTime [expirationDateTime]`
28
- : The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used
28
+ : The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used.
29
29
 
30
30
  `-s, --clientState [clientState]`
31
- : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters
31
+ : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters.
32
32
  ```
33
33
 
34
34
  <Global />
@@ -52,19 +52,19 @@ To subscribe to change notifications of Outlook contacts, events, or messages in
52
52
  Create a subscription
53
53
 
54
54
  ```sh
55
- m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
55
+ m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
56
56
  ```
57
57
 
58
58
  Create a subscription on multiple change types
59
59
 
60
60
  ```sh
61
- m365 graph subscription add --resource groups --changeType updated,deleted --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
61
+ m365 graph subscription add --resource groups --changeTypes "updated,deleted" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
62
62
  ```
63
63
 
64
64
  Create a subscription using the maximum allowed expiration for Group resources
65
65
 
66
66
  ```sh
67
- m365 graph subscription add --resource groups --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
67
+ m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
68
68
  ```
69
69
 
70
70
  ## Response
@@ -125,7 +125,7 @@ m365 graph subscription add --resource groups --changeType "updated" --notificat
125
125
  <TabItem value="Markdown">
126
126
 
127
127
  ```md
128
- # graph subscription add --resource "groups" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
128
+ # graph subscription add --resource "groups" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
129
129
 
130
130
  Date: 2023-05-22
131
131
 
@@ -13,13 +13,13 @@ m365 pa app export [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-i, --id <id>`
17
- : The id of the Power App to export
16
+ `-n, --name <name>`
17
+ : The name (GUID) of the Power Apps app to export
18
18
 
19
19
  `-e, --environmentName <environmentName>`
20
20
  : The name of the environment for which to export the app
21
21
 
22
- `-n, --packageDisplayName [packageDisplayName]`
22
+ `--packageDisplayName [packageDisplayName]`
23
23
  : The display name to use in the exported package
24
24
 
25
25
  `-d, --packageDescription [packageDescription]`
@@ -42,13 +42,13 @@ m365 pa app export [options]
42
42
  Export the specified Power App as a ZIP file
43
43
 
44
44
  ```sh
45
- m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
45
+ m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
46
46
  ```
47
47
 
48
48
  Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
49
49
 
50
50
  ```sh
51
- m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
51
+ m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
52
52
  ```
53
53
 
54
54
  ## Response
@@ -19,10 +19,10 @@ m365 pp solution publisher get [options]
19
19
  : The name of the environment.
20
20
 
21
21
  `-i --id [id]`
22
- : The ID of the solution. Specify either `id` or `name` but not both.
22
+ : The ID of the publisher. Specify either `id` or `name` but not both.
23
23
 
24
24
  `-n, --name [name]`
25
- : The unique name (not the display name) of the solution. Specify either `id` or `name` but not both.
25
+ : The unique name of the publisher. Specify either `id` or `name` but not both.
26
26
 
27
27
  `--asAdmin`
28
28
  : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -17,10 +17,10 @@ m365 pp solution publisher remove [options]
17
17
  : The name of the environment.
18
18
 
19
19
  `-i, --id [id]`
20
- : The id of the solution. Specify either `id` or `name` but not both.
20
+ : The id of the publisher. Specify either `id` or `name` but not both.
21
21
 
22
22
  `-n, --name [name]`
23
- : The name of the solution. Specify either `id` or `name` but not both.
23
+ : The unique name of the publisher. Specify either `id` or `name` but not both.
24
24
 
25
25
  `--asAdmin`
26
26
  : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
35
35
 
36
36
  ## Remarks
37
37
 
38
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.4).
38
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.0).
39
39
 
40
40
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
41
41
 
@@ -15,10 +15,10 @@ m365 spo file get [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
- `-u, --url [url]`
21
+ `--url [url]`
22
22
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
23
23
 
24
24
  `-i, --id [id]`
@@ -19,13 +19,13 @@ m365 spo page template remove
19
19
  ## Options
20
20
 
21
21
  ```md definition-list
22
- `-w, --webUrl <webUrl>`
22
+ `-u, --webUrl <webUrl>`
23
23
  : URL of the site where the file to remove is located
24
24
 
25
25
  `-i, --id [id]`
26
26
  : The ID of the file to remove. Specify either `id` or `url` but not both
27
27
 
28
- `-u, --url [url]`
28
+ `--url [url]`
29
29
  : The server- or site-relative decoded URL of the file to remove. Specify either `id` or `url` but not both
30
30
 
31
31
  `--recycle`
@@ -13,10 +13,10 @@ m365 spo file version clear [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-w, --webUrl <webUrl>`
16
+ `-u, --webUrl <webUrl>`
17
17
  : The URL of the site where the file is located
18
18
 
19
- `-u, --fileUrl [fileUrl]`
19
+ `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
@@ -15,13 +15,13 @@ m365 spo file version get [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
21
  `--label <label>`
22
22
  : Label of version which will be retrieved
23
23
 
24
- `-u, --fileUrl [fileUrl]`
24
+ `--fileUrl [fileUrl]`
25
25
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
26
26
 
27
27
  `-i, --fileId [fileId]`
@@ -15,10 +15,10 @@ m365 spo file version list [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
- `-u, --fileUrl [fileUrl]`
21
+ `--fileUrl [fileUrl]`
22
22
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both
23
23
 
24
24
  `-i, --fileId [fileId]`