@pnp/cli-microsoft365 9.0.0-beta.2f8dd1e → 9.0.0-beta.39e78b2

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 (187) hide show
  1. package/.eslintrc.cjs +1 -0
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/Auth.js +10 -18
  5. package/dist/Command.js +50 -5
  6. package/dist/chili/chili.js +0 -23
  7. package/dist/cli/cli.js +100 -100
  8. package/dist/config.js +1 -1
  9. package/dist/m365/app/commands/permission/permission-add.js +9 -9
  10. package/dist/m365/cli/commands/cli-consent.js +3 -7
  11. package/dist/m365/commands/login.js +49 -96
  12. package/dist/m365/commands/setup.js +0 -4
  13. package/dist/m365/commands/status.js +2 -2
  14. package/dist/m365/connection/commands/connection-remove.js +6 -2
  15. package/dist/m365/connection/commands/connection-set.js +4 -1
  16. package/dist/m365/connection/commands/connection-use.js +25 -4
  17. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +13 -13
  18. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +18 -18
  19. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -1
  20. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
  21. package/dist/m365/entra/commands/group/group-set.js +256 -0
  22. package/dist/m365/entra/commands/group/group-user-list.js +4 -4
  23. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
  24. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
  25. package/dist/m365/entra/commands/m365group/m365group-set.js +66 -29
  26. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  27. package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
  28. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  29. package/dist/m365/entra/commands/multitenant/MultitenantOrganization.js +2 -0
  30. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  31. package/dist/m365/entra/commands/multitenant/multitenant-get.js +32 -0
  32. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  33. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  34. package/dist/m365/entra/commands.js +7 -0
  35. package/dist/m365/external/commands/connection/connection-doctor.js +10 -24
  36. package/dist/m365/flow/commands/flow-get.js +1 -1
  37. package/dist/m365/flow/commands/flow-list.js +23 -24
  38. package/dist/m365/graph/commands/subscription/subscription-add.js +4 -2
  39. package/dist/m365/onenote/commands/notebook/notebook-add.js +132 -0
  40. package/dist/m365/onenote/commands.js +1 -0
  41. package/dist/m365/outlook/commands/message/message-get.js +11 -11
  42. package/dist/m365/pa/commands/app/app-export.js +13 -7
  43. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  44. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  45. package/dist/m365/spe/commands.js +2 -1
  46. package/dist/m365/spfx/commands/project/DeployWorkflow.js +1 -1
  47. package/dist/m365/spfx/commands/project/base-project-command.js +36 -126
  48. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +1 -10
  49. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -22
  50. package/dist/m365/spo/commands/cdn/cdn-get.js +12 -15
  51. package/dist/m365/spo/commands/cdn/cdn-set.js +6 -4
  52. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  53. package/dist/m365/spo/commands/contenttype/contenttype-field-list.js +124 -0
  54. package/dist/m365/spo/commands/field/field-list.js +1 -1
  55. package/dist/m365/spo/commands/file/file-copy.js +55 -34
  56. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  57. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  58. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  59. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  60. package/dist/m365/spo/commands/folder/folder-set.js +0 -4
  61. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  62. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  63. package/dist/m365/spo/commands/group/group-member-add.js +103 -99
  64. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  65. package/dist/m365/spo/commands/list/list-get.js +9 -3
  66. package/dist/m365/spo/commands/list/list-list.js +1 -4
  67. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  68. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  69. package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js +2 -3
  70. package/dist/m365/spo/commands/page/page-text-add.js +2 -3
  71. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
  72. package/dist/m365/spo/commands/site/site-get.js +12 -16
  73. package/dist/m365/spo/commands/site/site-remove.js +1 -7
  74. package/dist/m365/spo/commands/spo-search.js +3 -4
  75. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  76. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  77. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
  78. package/dist/m365/spo/commands.js +3 -1
  79. package/dist/m365/teams/commands/meeting/meeting-attendancereport-get.js +119 -0
  80. package/dist/m365/teams/commands/message/message-remove.js +112 -0
  81. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  82. package/dist/m365/teams/commands.js +3 -0
  83. package/dist/m365/viva/commands/engage/engage-community-add.js +166 -0
  84. package/dist/m365/viva/commands/engage/engage-group-list.js +0 -5
  85. package/dist/m365/viva/commands/engage/engage-group-user-add.js +0 -5
  86. package/dist/m365/viva/commands/engage/engage-group-user-remove.js +0 -5
  87. package/dist/m365/viva/commands/engage/engage-message-add.js +0 -5
  88. package/dist/m365/viva/commands/engage/engage-message-get.js +0 -5
  89. package/dist/m365/viva/commands/engage/engage-message-like-set.js +0 -5
  90. package/dist/m365/viva/commands/engage/engage-message-list.js +0 -5
  91. package/dist/m365/viva/commands/engage/engage-message-remove.js +0 -5
  92. package/dist/m365/viva/commands/engage/engage-network-list.js +0 -5
  93. package/dist/m365/viva/commands/engage/engage-report-activitycounts.js +0 -8
  94. package/dist/m365/viva/commands/engage/engage-report-activityusercounts.js +0 -8
  95. package/dist/m365/viva/commands/engage/engage-report-activityuserdetail.js +0 -8
  96. package/dist/m365/viva/commands/engage/engage-report-deviceusagedistributionusercounts.js +0 -8
  97. package/dist/m365/viva/commands/engage/engage-report-deviceusageusercounts.js +0 -8
  98. package/dist/m365/viva/commands/engage/engage-report-deviceusageuserdetail.js +0 -8
  99. package/dist/m365/viva/commands/engage/engage-report-groupsactivitycounts.js +0 -8
  100. package/dist/m365/viva/commands/engage/engage-report-groupsactivitydetail.js +0 -8
  101. package/dist/m365/viva/commands/engage/engage-report-groupsactivitygroupcounts.js +0 -8
  102. package/dist/m365/viva/commands/engage/engage-search.js +0 -5
  103. package/dist/m365/viva/commands/engage/engage-user-get.js +0 -5
  104. package/dist/m365/viva/commands/engage/engage-user-list.js +0 -5
  105. package/dist/m365/viva/commands.js +1 -0
  106. package/dist/utils/drive.js +61 -0
  107. package/dist/utils/formatting.js +30 -1
  108. package/dist/utils/spo.js +143 -6
  109. package/dist/utils/teams.js +49 -0
  110. package/dist/utils/validation.js +19 -0
  111. package/dist/utils/zod.js +124 -0
  112. package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
  113. package/docs/docs/cmd/cli/cli-consent.mdx +1 -1
  114. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  115. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +12 -12
  116. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +14 -14
  117. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-list.mdx +5 -5
  118. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  119. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  120. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  121. package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
  122. package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
  123. package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
  124. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +37 -7
  125. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  126. package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
  127. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  128. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  129. package/docs/docs/cmd/entra/multitenant/multitenant-get.mdx +94 -0
  130. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  131. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  132. package/docs/docs/cmd/external/connection/connection-doctor.mdx +9 -9
  133. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  134. package/docs/docs/cmd/flow/flow-list.mdx +114 -56
  135. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +18 -0
  136. package/docs/docs/cmd/onenote/notebook/notebook-add.mdx +169 -0
  137. package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
  138. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  139. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  140. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  141. package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +11 -12
  142. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  143. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +88 -38
  144. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  145. package/docs/docs/cmd/spo/cdn/cdn-set.mdx +3 -3
  146. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  147. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  148. package/docs/docs/cmd/spo/contenttype/contenttype-field-list.mdx +172 -0
  149. package/docs/docs/cmd/spo/contenttype/contenttype-list.mdx +3 -3
  150. package/docs/docs/cmd/spo/field/field-list.mdx +3 -3
  151. package/docs/docs/cmd/spo/file/file-copy.mdx +119 -12
  152. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  153. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  154. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  155. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  156. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  157. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  158. package/docs/docs/cmd/spo/folder/folder-set.mdx +0 -6
  159. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  160. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  161. package/docs/docs/cmd/spo/group/group-member-add.mdx +34 -27
  162. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  163. package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
  164. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  165. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  166. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  167. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  168. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  169. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  170. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
  171. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  172. package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
  173. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  174. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  175. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  176. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  177. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
  178. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  179. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  180. package/docs/docs/cmd/teams/meeting/meeting-attendancereport-get.mdx +138 -0
  181. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  182. package/docs/docs/cmd/teams/message/message-remove.mdx +64 -0
  183. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  184. package/docs/docs/cmd/viva/engage/engage-community-add.mdx +168 -0
  185. package/npm-shrinkwrap.json +986 -1326
  186. package/package.json +27 -24
  187. package/dist/m365/viva/commands/engage/yammerCommands.js +0 -25
@@ -0,0 +1,65 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra enterpriseapp remove
6
+
7
+ Deletes an enterprise application (or service principal)
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra enterpriseapp remove [options]
13
+ ```
14
+
15
+ ## Alias
16
+
17
+ ```sh
18
+ m365 entra sp remove [options]
19
+ ```
20
+
21
+ ## Options
22
+
23
+ ```md definition-list
24
+ `-i, --id [id]`
25
+ : ID of the enterprise application.
26
+
27
+ `-n, --displayName [displayName]`
28
+ : Display name of the enterprise application.
29
+
30
+ `--objectId [objectId]`
31
+ : ObjectId of the enterprise application.
32
+
33
+ `-f, --force`
34
+ : Don't prompt for confirmation.
35
+ ```
36
+
37
+ <Global />
38
+
39
+ ## Examples
40
+
41
+ Delete an enterprise application by application ID.
42
+
43
+ ```sh
44
+ m365 entra enterpriseapp remove --id b2307a39-e878-458b-bc90-03bc578531d6 --force
45
+ ```
46
+
47
+ Delete an enterprise application by display name.
48
+
49
+ ```sh
50
+ m365 entra enterpriseapp remove --displayName "Contoso app"
51
+ ```
52
+
53
+ Delete an enterprise application by object ID.
54
+
55
+ ```sh
56
+ m365 entra enterpriseapp remove --objectId b2307a39-e878-458b-bc90-03bc578531dd
57
+ ```
58
+
59
+ ## Response
60
+
61
+ The command won't return a response on success.
62
+
63
+ ## More information
64
+
65
+ - Application and service principal objects in Microsoft Entra ID: [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
@@ -53,8 +53,6 @@ m365 aad group add [options]
53
53
 
54
54
  ## Remarks
55
55
 
56
- :::info
57
-
58
56
  The `visibility` option affects the behavior of the group.
59
57
 
60
58
  With the `Public` visibility:
@@ -74,8 +72,6 @@ With the `HiddenMembership` visibility:
74
72
  - Administrators (global, company, user, and helpdesk) can view the membership of the group.
75
73
  - The group appears in the global address book (GAL).
76
74
 
77
- :::
78
-
79
75
  :::note
80
76
 
81
77
  The `HiddenMembership` visibility can be set only for Microsoft 365 groups when the groups are created. It can't be updated later.
@@ -0,0 +1,89 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # entra group set
4
+
5
+ Updates a Microsoft Entra group
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 entra group set [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The ID of the Microsoft Entra group to update. Specify either `id` or `displayName` but not both.
18
+
19
+ `-n, --displayName [displayName]`
20
+ : The display name of the Microsoft Entra group to update. Specify either `id` or `displayName` but not both.
21
+
22
+ `--newDisplayName [newDisplayName]`
23
+ : The new display name of the Microsoft Entra group. The maximum length is 256 characters.
24
+
25
+ `--description [description]`
26
+ : The new description for the group.
27
+
28
+ `--mailNickname [mailNickname]`
29
+ : The new mail alias for the group (part before the @). Use only for mail-enabled groups. Maximum length is 64 characters.
30
+
31
+ `--ownerIds [ownerIds]`
32
+ : Comma-separated list of IDs of Microsoft Entra users that will be the group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
33
+
34
+ `--ownerUserNames [ownerUserNames]`
35
+ : Comma-separated list of UPNs of Microsoft Entra users that will be the group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
36
+
37
+ `--memberIds [memberIds]`
38
+ : Comma-separated list of IDs of Microsoft Entra users that will be the group members. Specify either `memberIds` or `memberUserNames`, but not both.
39
+
40
+ `--memberUserNames [memberUserNames]`
41
+ : Comma-separated list of UPNs of Microsoft Entra users that will be the group members. Specify either `memberIds` or `memberUserNames`, but not both.
42
+
43
+ `--visibility [visibility]`
44
+ : Specifies the group join policy and group content visibility for Microsoft 365 groups. Possible values are: `Private` or `Public`. Specify only when targeting a Microsoft 365 group.
45
+ ```
46
+
47
+ <Global />
48
+
49
+ ## Remarks
50
+
51
+ The `visibility` option affects the behavior of the group.
52
+
53
+ With the `Public` visibility:
54
+ - Anyone can join the group without needing owner approval.
55
+ - Anyone can view the attributes of the group.
56
+ - Anyone can see the members of the group.
57
+
58
+ With the `Private` visibilty:
59
+ - Owner approval is needed to join the group.
60
+ - Anyone can view the attributes of the group.
61
+ - Anyone can see the members of the group.
62
+
63
+ If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
64
+
65
+ Specifying `memberIds` or `memberUserNames` will make only those users members, removing all others. Similarly, specifying `ownerIds` or `ownerUserNames` will make only those users owners, removing all others.
66
+
67
+ ## Examples
68
+
69
+ Update the display name of a group specified by the display name
70
+
71
+ ```sh
72
+ m365 entra group set --displayName Devs --newDisplayName Developers
73
+ ```
74
+
75
+ Set the owners of a group to the specified people
76
+
77
+ ```sh
78
+ m365 entra group set --id 57fd6b33-54eb-42b0-9ea0-8a9ac04eab7d --ownerUserNames "john.doe@contoso.com,adele.vance@contoso.com"
79
+ ```
80
+
81
+ Update the description and mail nickname of a group
82
+
83
+ ```sh
84
+ m365 entra group set --id 57fd6b33-54eb-42b0-9ea0-8a9ac04eab7d --description "All developers of the company" --mailNickname developers
85
+ ```
86
+
87
+ ## Response
88
+
89
+ The command won't return a response on success.
@@ -22,10 +22,10 @@ m365 aad group user list [options]
22
22
 
23
23
  ```md definition-list
24
24
  `-i, --groupId [groupId]`
25
- : The ID of the Entra group. Specify `groupId` or `groupDisplayName` but not both.
25
+ : The ID of the Entra group. Specify `groupId` or `groupName` but not both.
26
26
 
27
- `-n, --groupDisplayName [groupDisplayName]`
28
- : The display name of the Entra group. Specify `groupId` or `groupDisplayName` but not both.
27
+ `-n, --groupName [groupName]`
28
+ : The display name of the Entra group. Specify `groupId` or `groupName` but not both.
29
29
 
30
30
  `-r, --role [role]`
31
31
  : Filter the results to only users with the given role: `Owner`, `Member`.
@@ -54,25 +54,25 @@ m365 entra group user list --groupId 03cba9da-3974-46c1-afaf-79caa2e45bbe
54
54
  List all owners from a group specified by display name.
55
55
 
56
56
  ```sh
57
- m365 entra group user list --groupDisplayName Developers --role Owner
57
+ m365 entra group user list --groupName Developers --role Owner
58
58
  ```
59
59
 
60
60
  List all group users from a group specified by name. For each one return the display name, e-mail address, and manager display name.
61
61
 
62
62
  ```sh
63
- m365 entra group user list --groupDisplayName Developers --properties "displayName,mail,manager/displayName"
63
+ m365 entra group user list --groupName Developers --properties "displayName,mail,manager/displayName"
64
64
  ```
65
65
 
66
66
  List all group users from a group specified by name. For each one return the display name, e-mail address, and manager information.
67
67
 
68
68
  ```sh
69
- m365 entra group user list --groupDisplayName Developers --properties "displayName,mail,manager/*"
69
+ m365 entra group user list --groupName Developers --properties "displayName,mail,manager/*"
70
70
  ```
71
71
 
72
72
  List all group members that are guest users.
73
73
 
74
74
  ```sh
75
- m365 entra group user list --groupDisplayName Developers --filter "userType eq 'Guest'"
75
+ m365 entra group user list --groupName Developers --filter "userType eq 'Guest'"
76
76
  ```
77
77
 
78
78
  ## Response
@@ -22,10 +22,10 @@ m365 aad m365group conversation post list [options]
22
22
 
23
23
  ```md definition-list
24
24
  `-i, --groupId [groupId]`
25
- : The Id of the Microsoft 365 Group. You can specify the groupId or groupDisplayName, but not both.
25
+ : The Id of the Microsoft 365 Group. You can specify the groupId or groupName, but not both.
26
26
 
27
- `-d, --groupDisplayName [groupDisplayName]`
28
- : The Displayname of the Microsoft 365 Group. You can specify the groupId or groupDisplayName, but not both.
27
+ `-d, --groupName [groupName]`
28
+ : The Displayname of the Microsoft 365 Group. You can specify the groupId or groupName, but not both.
29
29
 
30
30
  `-t, --threadId <threadId>`
31
31
  : The ID of the thread to retrieve details for
@@ -41,10 +41,10 @@ Lists the posts of the specific conversation of Microsoft 365 group by groupId
41
41
  m365 entra m365group conversation post list --groupId '00000000-0000-0000-0000-000000000000' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
42
42
  ```
43
43
 
44
- Lists the posts of the specific conversation of Microsoft 365 group by groupDisplayName
44
+ Lists the posts of the specific conversation of Microsoft 365 group by groupName
45
45
 
46
46
  ```sh
47
- m365 entra m365group conversation post list --groupDisplayName 'MyGroup' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
47
+ m365 entra m365group conversation post list --groupName 'MyGroup' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
48
48
  ```
49
49
 
50
50
  ## Response
@@ -21,7 +21,7 @@ m365 aad m365group recyclebinitem list [options]
21
21
  ## Options
22
22
 
23
23
  ```md definition-list
24
- `-d, --groupDisplayName [groupDisplayName]`
24
+ `-d, --groupName [groupName]`
25
25
  : Lists groups with DisplayName starting with the specified value
26
26
 
27
27
  `-m, --groupMailNickname [groupMailNickname]`
@@ -41,7 +41,7 @@ m365 entra m365group recyclebinitem list
41
41
  List deleted Microsoft 365 Groups with display name starting with _Project_
42
42
 
43
43
  ```sh
44
- m365 entra m365group recyclebinitem list --groupDisplayName Project
44
+ m365 entra m365group recyclebinitem list --groupName Project
45
45
  ```
46
46
 
47
47
  List deleted Microsoft 365 Groups mail nick name starting with _team_
@@ -53,7 +53,7 @@ m365 entra m365group recyclebinitem list --groupMailNickname team
53
53
  List deleted Microsoft 365 Groups mail nick name starting with _team_ and with display name starting with _Project_
54
54
 
55
55
  ```sh
56
- m365 entra m365group recyclebinitem list --groupMailNickname team --groupDisplayName Project
56
+ m365 entra m365group recyclebinitem list --groupMailNickname team --groupName Project
57
57
  ```
58
58
 
59
59
  ## Response
@@ -35,10 +35,22 @@ m365 aad m365group set [options]
35
35
  : Comma-separated list of Microsoft 365 Group members to add
36
36
 
37
37
  `--isPrivate [isPrivate]`
38
- : Set to true if the Microsoft 365 Group should be private and to false if it should be public (default)
38
+ : Set to `true` if the Microsoft 365 Group should be private and `false` if it should be public.
39
39
 
40
40
  `-l, --logoPath [logoPath]`
41
41
  : Local path to the image file to use as group logo
42
+
43
+ `--allowExternalSenders [allowExternalSenders]`
44
+ : Indicates if people external to the organization can send messages to the group. Valid values: `true`, `false`.
45
+
46
+ `--autoSubscribeNewMembers [autoSubscribeNewMembers]`
47
+ : Indicates if new members added to the group will be auto-subscribed to receive email notifications. Valid values: `true`, `false`.
48
+
49
+ `--hideFromAddressLists [hideFromAddressLists]`
50
+ : Indicates if the group is not displayed in certain parts of the Outlook UI: the Address Book, address lists for selecting message recipients, and the Browse Groups dialog for searching groups. Valid values: `true`, `false`.
51
+
52
+ `--hideFromOutlookClients [hideFromOutlookClients]`
53
+ : Indicates if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Valid values: `true`, `false`.
42
54
  ```
43
55
 
44
56
  <Global />
@@ -49,38 +61,56 @@ When updating group's owners and members, the command will add newly specified u
49
61
 
50
62
  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.
51
63
 
64
+ :::note
65
+
66
+ Options `allowExternalSenders` and `autoSubscribeNewMembers` can only be set using delegated permissions.
67
+
68
+ :::
69
+
52
70
  ## Examples
53
71
 
54
- Update Microsoft 365 Group display name
72
+ Update Microsoft 365 Group display name.
55
73
 
56
74
  ```sh
57
75
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --displayName Finance
58
76
  ```
59
77
 
60
- Change Microsoft 365 Group visibility to public
78
+ Change Microsoft 365 Group visibility to public.
61
79
 
62
80
  ```sh
63
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate false
81
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate `false`
64
82
  ```
65
83
 
66
- Add new Microsoft 365 Group owners
84
+ Add new Microsoft 365 Group owners.
67
85
 
68
86
  ```sh
69
87
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
70
88
  ```
71
89
 
72
- Add new Microsoft 365 Group members
90
+ Add new Microsoft 365 Group members.
73
91
 
74
92
  ```sh
75
93
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
76
94
  ```
77
95
 
78
- Update Microsoft 365 Group logo
96
+ Update Microsoft 365 Group logo.
79
97
 
80
98
  ```sh
81
99
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --logoPath images/logo.png
82
100
  ```
83
101
 
102
+ Hide the Microsoft 365 group from the address lists and the Outlook clients.
103
+
104
+ ```sh
105
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --hideFromOutlookClients true --hideFromAddressLists true
106
+ ```
107
+
108
+ Auto-subscribe new members to receive email notifications and do not allow external senders to send messages to the group.
109
+
110
+ ```sh
111
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --autoSubscribeNewMembers true --allowExternalSenders false
112
+ ```
113
+
84
114
  ## Response
85
115
 
86
116
  The command won't return a response on success.
@@ -26,13 +26,25 @@ m365 teams user add
26
26
 
27
27
  ```md definition-list
28
28
  `-i, --groupId [groupId]`
29
- : The ID of the Microsoft 365 Group to which to add the user
29
+ : The ID of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
30
+
31
+ `--groupName [groupName]`
32
+ : The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
30
33
 
31
34
  `--teamId [teamId]`
32
- : The ID of the Teams team to which to add the user
35
+ : The ID of the Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
36
+
37
+ `--teamName [teamName]`
38
+ : The display name of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
39
+
40
+ `-n, --userName [userName]`
41
+ : (deprecated) User's UPN (User Principal Name), e.g. johndoe@example.com.
42
+
43
+ `--ids [ids]`
44
+ : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
33
45
 
34
- `-n, --userName <userName>`
35
- : User's UPN (user principal name, eg. johndoe@example.com)
46
+ `--userNames [userNames]`
47
+ : The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
36
48
 
37
49
  `-r, --role [role]`
38
50
  : The role to be assigned to the new user: `Owner,Member`. Default `Member`
@@ -42,22 +54,28 @@ m365 teams user add
42
54
 
43
55
  ## Examples
44
56
 
45
- Add a new member to the specified Microsoft 365 Group
57
+ Add a new member with the userNames parameter to the specified Microsoft 365 Group
58
+
59
+ ```sh
60
+ m365 entra m365group user add --groupId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com'
61
+ ```
62
+
63
+ Add multiple new owners with the userNames parameter to the specified Microsoft 365 Group
46
64
 
47
65
  ```sh
48
- m365 entra m365group user add --groupId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com'
66
+ m365 entra m365group user add --groupName 'Contoso' --userNames 'anne.matthews@contoso.onmicrosoft.com, john.doe@contoso.onmicrosoft.com' --role Owner
49
67
  ```
50
68
 
51
- Add a new owner to the specified Microsoft 365 Group
69
+ Add a new member with the userNames parameter to the specified Microsoft Teams team
52
70
 
53
71
  ```sh
54
- m365 entra m365group user add --groupId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com' --role Owner
72
+ m365 entra m365group member add --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com' --role Member
55
73
  ```
56
74
 
57
- Add a new member to the specified Microsoft Teams team
75
+ Add multiple new members with the ids parameter to the specified Microsoft Teams team
58
76
 
59
77
  ```sh
60
- m365 teams user add --teamId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com'
78
+ m365 entra m365group user add --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
61
79
  ```
62
80
 
63
81
  ## Response
@@ -28,7 +28,7 @@ m365 aad m365group user list [options]
28
28
  : The display name of the Microsoft 365 group. Specify `groupId` or `groupDisplayName` but not both.
29
29
 
30
30
  `-r, --role [role]`
31
- : Filter the results to only users with the given role. Allowed values: `Owner`, `Member`, or (Deprecated) `Guest`.
31
+ : Filter the results to only users with the given role. Allowed values: `Owner`, `Member`.
32
32
 
33
33
  `-p, --properties [properties]`
34
34
  : Comma-separated list of properties to retrieve.
@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
2
2
 
3
3
  # entra m365group user set
4
4
 
5
- Updates role of the specified user in the specified Microsoft 365 Group or Microsoft Teams team
5
+ Updates role of the specified users in the specified Microsoft 365 Group or Microsoft Teams team
6
6
 
7
7
  ## Usage
8
8
 
@@ -24,13 +24,25 @@ m365 aad teams user set
24
24
 
25
25
  ```md definition-list
26
26
  `-i, --groupId [groupId]`
27
- : The ID of the Microsoft 365 group for which to update user
27
+ : The ID of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
28
+
29
+ `--groupName [groupName]`
30
+ : The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
28
31
 
29
32
  `--teamId [teamId]`
30
- : The ID of the Microsoft Teams team for which to update user
33
+ : The ID of the Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
34
+
35
+ `--teamName [teamName]`
36
+ : The display name of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
37
+
38
+ `-n, --userName [userName]`
39
+ : (deprecated) User's UPN (User Principal Name), e.g. johndoe@example.com.
31
40
 
32
- `-n, --userName <userName>`
33
- : UPN of the user for whom to update the role (eg. johndoe@example.com)
41
+ `--ids [ids]`
42
+ : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify only one of the following `userName`, `ids` or `userNames`.
43
+
44
+ `--userNames [userNames]`
45
+ : The user principal names of users. You can also pass a comma-separated list of UPNs. Specify only one of the following `userName`, `ids` or `userNames`.
34
46
 
35
47
  `-r, --role <role>`
36
48
  : Role to set for the given user in the specified Microsoft 365 Group or Microsoft Teams team. Allowed values: `Owner`, `Member`
@@ -44,28 +56,40 @@ The command will return an error if the user already has the specified role in t
44
56
 
45
57
  ## Examples
46
58
 
47
- Promote the specified user to owner of the given Microsoft 365 Group
59
+ Promote a single user to Owner of the given Microsoft 365 Group
48
60
 
49
61
  ```sh
50
62
  m365 entra m365group user set --groupId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com' --role Owner
51
63
  ```
52
64
 
53
- Demote the specified user from owner to member in the given Microsoft 365 Group
65
+ Promote multiple users specified by the userNames parameter to Owner of the given Microsoft 365 Group
66
+
67
+ ```sh
68
+ m365 entra m365group user set --groupName 'Contoso' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Owner
69
+ ```
70
+
71
+ Promote multiple users specified by the ids parameter to Owner of the given Microsoft 365 Group
72
+
73
+ ```sh
74
+ m365 entra m365group user set --groupId '00000000-0000-0000-0000-000000000000' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Owner
75
+ ```
76
+
77
+ Demote a single user from Owner to Member in the given Microsoft 365 Group
54
78
 
55
79
  ```sh
56
80
  m365 entra m365group user set --groupId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com' --role Member
57
81
  ```
58
82
 
59
- Promote the specified user to owner of the given Microsoft Teams team
83
+ Demote multiple users specified by the userNames parameter from Owner to Member of the given Microsoft Teams team
60
84
 
61
85
  ```sh
62
- m365 entra teams user set --teamId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com' --role Owner
86
+ m365 entra teams user set --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Member
63
87
  ```
64
88
 
65
- Demote the specified user from owner to member in the given Microsoft Teams team
89
+ Demote multiple users specified by the ids parameter from Owner to Member in the given Microsoft Teams team
66
90
 
67
91
  ```sh
68
- m365 entra teams user set --teamId '00000000-0000-0000-0000-000000000000' --userName 'anne.matthews@contoso.onmicrosoft.com' --role Member
92
+ m365 entra teams user set --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
69
93
  ```
70
94
 
71
95
  ## Response
@@ -0,0 +1,107 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra multitenant add
6
+
7
+ Creates a new multitenant organization
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra multitenant add [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-n, --displayname <displayName>`
19
+ : Display name for the multitenant organization.
20
+
21
+ `-d, --description [description]`
22
+ : Description for the multitenant organiztion.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::info
30
+
31
+ To use this command you must be at least **Security Administrator**.
32
+
33
+ :::
34
+
35
+ ## Examples
36
+
37
+ Create a new multitenant organization with display name only.
38
+
39
+ ```sh
40
+ m365 entra multitenant add --displayName 'Contoso organization'
41
+ ```
42
+
43
+ Create a new multitenant organization with display name and description.
44
+
45
+ ```sh
46
+ m365 entra multitenant add --displayName 'Contoso organization' --description 'Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank'
47
+ ```
48
+
49
+ ## Response
50
+
51
+ <Tabs>
52
+ <TabItem value="JSON">
53
+
54
+ ```json
55
+ {
56
+ "id": "c231d4a5-138f-4bdf-9fee-f26a90ea3ad0",
57
+ "createdDateTime": "2024-05-05T05:05:05Z",
58
+ "state": "active",
59
+ "displayName": "Contoso organization",
60
+ "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank"
61
+ }
62
+ ```
63
+
64
+ </TabItem>
65
+ <TabItem value="Text">
66
+
67
+ ```text
68
+ createdDateTime: 2024-05-05T05:05:05Z
69
+ description : Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank
70
+ displayName : Contoso organization
71
+ id : c231d4a5-138f-4bdf-9fee-f26a90ea3ad0
72
+ state : active
73
+ ```
74
+
75
+ </TabItem>
76
+ <TabItem value="CSV">
77
+
78
+ ```csv
79
+ id,createdDateTime,state,displayName,description
80
+ c231d4a5-138f-4bdf-9fee-f26a90ea3ad0,2024-05-05T05:05:05Z,active,Contoso organization,"Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank"
81
+ ```
82
+
83
+ </TabItem>
84
+ <TabItem value="Markdown">
85
+
86
+ ```md
87
+ # entra multitenant add
88
+
89
+ Date: 5/5/2024
90
+
91
+ ## Contoso organization (c231d4a5-138f-4bdf-9fee-f26a90ea3ad0)
92
+
93
+ Property | Value
94
+ ---------|-------
95
+ id | c231d4a5-138f-4bdf-9fee-f26a90ea3ad0
96
+ createdDateTime | 2024-05-05T05:05:05Z
97
+ state | active
98
+ displayName | Contoso organization
99
+ description | Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank
100
+ ```
101
+
102
+ </TabItem>
103
+ </Tabs>
104
+
105
+ ## More information
106
+
107
+ - Multitenant organization: https://learn.microsoft.com/entra/identity/multi-tenant-organizations/overview