@pnp/cli-microsoft365 9.0.0-beta.62575a1 → 9.0.0-beta.872d524

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 (147) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +9 -9
  4. package/dist/Command.js +49 -2
  5. package/dist/cli/cli.js +66 -39
  6. package/dist/config.js +1 -1
  7. package/dist/m365/app/commands/permission/permission-add.js +9 -9
  8. package/dist/m365/cli/commands/cli-consent.js +3 -7
  9. package/dist/m365/commands/login.js +44 -96
  10. package/dist/m365/commands/status.js +2 -2
  11. package/dist/m365/connection/commands/connection-remove.js +6 -2
  12. package/dist/m365/connection/commands/connection-set.js +4 -1
  13. package/dist/m365/connection/commands/connection-use.js +25 -4
  14. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +13 -13
  15. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +18 -18
  16. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -1
  17. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
  18. package/dist/m365/entra/commands/group/group-set.js +256 -0
  19. package/dist/m365/entra/commands/group/group-user-list.js +4 -4
  20. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
  21. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
  22. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  23. package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
  24. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  25. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  26. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  27. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  28. package/dist/m365/entra/commands.js +6 -0
  29. package/dist/m365/flow/commands/flow-get.js +1 -1
  30. package/dist/m365/outlook/commands/message/message-get.js +11 -11
  31. package/dist/m365/pa/commands/app/app-export.js +13 -7
  32. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  33. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  34. package/dist/m365/spe/commands.js +2 -1
  35. package/dist/m365/spfx/commands/project/DeployWorkflow.js +1 -1
  36. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +1 -10
  37. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -22
  38. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  39. package/dist/m365/spo/commands/file/file-copy.js +55 -34
  40. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  41. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  42. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  43. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  44. package/dist/m365/spo/commands/folder/folder-set.js +0 -4
  45. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  46. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  47. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  48. package/dist/m365/spo/commands/list/list-get.js +9 -3
  49. package/dist/m365/spo/commands/list/list-list.js +1 -4
  50. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  51. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  52. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
  53. package/dist/m365/spo/commands/site/site-remove.js +1 -7
  54. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  55. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  56. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
  57. package/dist/m365/spo/commands.js +2 -1
  58. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  59. package/dist/m365/teams/commands.js +1 -0
  60. package/dist/m365/viva/commands/engage/engage-group-list.js +0 -5
  61. package/dist/m365/viva/commands/engage/engage-group-user-add.js +0 -5
  62. package/dist/m365/viva/commands/engage/engage-group-user-remove.js +0 -5
  63. package/dist/m365/viva/commands/engage/engage-message-add.js +0 -5
  64. package/dist/m365/viva/commands/engage/engage-message-get.js +0 -5
  65. package/dist/m365/viva/commands/engage/engage-message-like-set.js +0 -5
  66. package/dist/m365/viva/commands/engage/engage-message-list.js +0 -5
  67. package/dist/m365/viva/commands/engage/engage-message-remove.js +0 -5
  68. package/dist/m365/viva/commands/engage/engage-network-list.js +0 -5
  69. package/dist/m365/viva/commands/engage/engage-report-activitycounts.js +0 -8
  70. package/dist/m365/viva/commands/engage/engage-report-activityusercounts.js +0 -8
  71. package/dist/m365/viva/commands/engage/engage-report-activityuserdetail.js +0 -8
  72. package/dist/m365/viva/commands/engage/engage-report-deviceusagedistributionusercounts.js +0 -8
  73. package/dist/m365/viva/commands/engage/engage-report-deviceusageusercounts.js +0 -8
  74. package/dist/m365/viva/commands/engage/engage-report-deviceusageuserdetail.js +0 -8
  75. package/dist/m365/viva/commands/engage/engage-report-groupsactivitycounts.js +0 -8
  76. package/dist/m365/viva/commands/engage/engage-report-groupsactivitydetail.js +0 -8
  77. package/dist/m365/viva/commands/engage/engage-report-groupsactivitygroupcounts.js +0 -8
  78. package/dist/m365/viva/commands/engage/engage-search.js +0 -5
  79. package/dist/m365/viva/commands/engage/engage-user-get.js +0 -5
  80. package/dist/m365/viva/commands/engage/engage-user-list.js +0 -5
  81. package/dist/utils/drive.js +61 -0
  82. package/dist/utils/formatting.js +16 -0
  83. package/dist/utils/spo.js +143 -6
  84. package/dist/utils/zod.js +124 -0
  85. package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
  86. package/docs/docs/cmd/cli/cli-consent.mdx +1 -1
  87. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  88. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +12 -12
  89. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +14 -14
  90. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-list.mdx +5 -5
  91. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  92. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  93. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  94. package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
  95. package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
  96. package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
  97. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  98. package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
  99. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  100. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  101. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  102. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  103. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  104. package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
  105. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  106. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  107. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  108. package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +11 -12
  109. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  110. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +88 -38
  111. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  112. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  113. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  114. package/docs/docs/cmd/spo/file/file-copy.mdx +119 -12
  115. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  116. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  117. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  118. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  119. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  120. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  121. package/docs/docs/cmd/spo/folder/folder-set.mdx +0 -6
  122. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  123. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  124. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  125. package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
  126. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  127. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  128. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  129. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  130. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  131. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  132. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
  133. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  134. package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
  135. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  136. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  137. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  138. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  139. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
  140. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  141. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  142. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  143. package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
  144. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  145. package/npm-shrinkwrap.json +1002 -1147
  146. package/package.json +26 -23
  147. package/dist/m365/viva/commands/engage/yammerCommands.js +0 -25
@@ -51,7 +51,7 @@ class EntraM365GroupConversationPostListCommand extends GraphCommand {
51
51
  if (args.options.groupId) {
52
52
  return formatting.encodeQueryParameter(args.options.groupId);
53
53
  }
54
- const group = await entraGroup.getGroupByDisplayName(args.options.groupDisplayName);
54
+ const group = await entraGroup.getGroupByDisplayName(args.options.groupName);
55
55
  return group.id;
56
56
  }
57
57
  }
@@ -59,14 +59,14 @@ _EntraM365GroupConversationPostListCommand_instances = new WeakSet(), _EntraM365
59
59
  this.telemetry.push((args) => {
60
60
  Object.assign(this.telemetryProperties, {
61
61
  groupId: typeof args.options.groupId !== 'undefined',
62
- groupDisplayName: typeof args.options.groupDisplayName !== 'undefined'
62
+ groupName: typeof args.options.groupName !== 'undefined'
63
63
  });
64
64
  });
65
65
  }, _EntraM365GroupConversationPostListCommand_initOptions = function _EntraM365GroupConversationPostListCommand_initOptions() {
66
66
  this.options.unshift({
67
67
  option: '-i, --groupId [groupId]'
68
68
  }, {
69
- option: '-d, --groupDisplayName [groupDisplayName]'
69
+ option: '-d, --groupName [groupName]'
70
70
  }, {
71
71
  option: '-t, --threadId <threadId>'
72
72
  });
@@ -78,7 +78,7 @@ _EntraM365GroupConversationPostListCommand_instances = new WeakSet(), _EntraM365
78
78
  return true;
79
79
  });
80
80
  }, _EntraM365GroupConversationPostListCommand_initOptionSets = function _EntraM365GroupConversationPostListCommand_initOptionSets() {
81
- this.optionSets.push({ options: ['groupId', 'groupDisplayName'] });
81
+ this.optionSets.push({ options: ['groupId', 'groupName'] });
82
82
  };
83
83
  export default new EntraM365GroupConversationPostListCommand();
84
84
  //# sourceMappingURL=m365group-conversation-post-list.js.map
@@ -32,7 +32,7 @@ class EntraM365GroupRecycleBinItemListCommand extends GraphCommand {
32
32
  await this.showDeprecationWarning(logger, aadCommands.M365GROUP_RECYCLEBINITEM_LIST, commands.M365GROUP_RECYCLEBINITEM_LIST);
33
33
  try {
34
34
  const filter = `?$filter=groupTypes/any(c:c+eq+'Unified')`;
35
- const displayNameFilter = args.options.groupDisplayName ? ` and startswith(DisplayName,'${formatting.encodeQueryParameter(args.options.groupDisplayName).replace(/'/g, `''`)}')` : '';
35
+ const displayNameFilter = args.options.groupName ? ` and startswith(DisplayName,'${formatting.encodeQueryParameter(args.options.groupName).replace(/'/g, `''`)}')` : '';
36
36
  const mailNicknameFilter = args.options.groupMailNickname ? ` and startswith(MailNickname,'${formatting.encodeQueryParameter(args.options.groupMailNickname).replace(/'/g, `''`)}')` : '';
37
37
  const topCount = '&$top=100';
38
38
  const endpoint = `${this.resource}/v1.0/directory/deletedItems/Microsoft.Graph.Group${filter}${displayNameFilter}${mailNicknameFilter}${topCount}`;
@@ -47,13 +47,13 @@ class EntraM365GroupRecycleBinItemListCommand extends GraphCommand {
47
47
  _EntraM365GroupRecycleBinItemListCommand_instances = new WeakSet(), _EntraM365GroupRecycleBinItemListCommand_initTelemetry = function _EntraM365GroupRecycleBinItemListCommand_initTelemetry() {
48
48
  this.telemetry.push((args) => {
49
49
  Object.assign(this.telemetryProperties, {
50
- groupDisplayName: typeof args.options.groupDisplayName !== 'undefined',
50
+ groupName: typeof args.options.groupName !== 'undefined',
51
51
  groupMailNickname: typeof args.options.groupMailNickname !== 'undefined'
52
52
  });
53
53
  });
54
54
  }, _EntraM365GroupRecycleBinItemListCommand_initOptions = function _EntraM365GroupRecycleBinItemListCommand_initOptions() {
55
55
  this.options.unshift({
56
- option: '-d, --groupDisplayName [groupDisplayName]'
56
+ option: '-d, --groupName [groupName]'
57
57
  }, {
58
58
  option: '-m, --groupMailNickname [groupMailNickname]'
59
59
  });
@@ -3,14 +3,15 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
3
3
  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
4
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
5
  };
6
- var _EntraM365GroupUserAddCommand_instances, _EntraM365GroupUserAddCommand_initTelemetry, _EntraM365GroupUserAddCommand_initOptions, _EntraM365GroupUserAddCommand_initValidators, _EntraM365GroupUserAddCommand_initOptionSets;
6
+ var _EntraM365GroupUserAddCommand_instances, _EntraM365GroupUserAddCommand_initTelemetry, _EntraM365GroupUserAddCommand_initOptions, _EntraM365GroupUserAddCommand_initValidators, _EntraM365GroupUserAddCommand_initOptionSets, _EntraM365GroupUserAddCommand_initTypes;
7
7
  import request from '../../../../request.js';
8
8
  import { entraGroup } from '../../../../utils/entraGroup.js';
9
- import { formatting } from '../../../../utils/formatting.js';
10
9
  import { validation } from '../../../../utils/validation.js';
10
+ import { formatting } from '../../../../utils/formatting.js';
11
11
  import GraphCommand from '../../../base/GraphCommand.js';
12
12
  import teamsCommands from '../../../teams/commands.js';
13
13
  import aadCommands from '../../aadCommands.js';
14
+ import { entraUser } from '../../../../utils/entraUser.js';
14
15
  import commands from '../../commands.js';
15
16
  class EntraM365GroupUserAddCommand extends GraphCommand {
16
17
  get name() {
@@ -25,79 +26,155 @@ class EntraM365GroupUserAddCommand extends GraphCommand {
25
26
  constructor() {
26
27
  super();
27
28
  _EntraM365GroupUserAddCommand_instances.add(this);
29
+ this.allowedRoles = ['owner', 'member'];
28
30
  __classPrivateFieldGet(this, _EntraM365GroupUserAddCommand_instances, "m", _EntraM365GroupUserAddCommand_initTelemetry).call(this);
29
31
  __classPrivateFieldGet(this, _EntraM365GroupUserAddCommand_instances, "m", _EntraM365GroupUserAddCommand_initOptions).call(this);
30
32
  __classPrivateFieldGet(this, _EntraM365GroupUserAddCommand_instances, "m", _EntraM365GroupUserAddCommand_initValidators).call(this);
31
33
  __classPrivateFieldGet(this, _EntraM365GroupUserAddCommand_instances, "m", _EntraM365GroupUserAddCommand_initOptionSets).call(this);
34
+ __classPrivateFieldGet(this, _EntraM365GroupUserAddCommand_instances, "m", _EntraM365GroupUserAddCommand_initTypes).call(this);
32
35
  }
33
36
  async commandAction(logger, args) {
34
37
  await this.showDeprecationWarning(logger, aadCommands.M365GROUP_USER_ADD, commands.M365GROUP_USER_ADD);
38
+ if (args.options.userName) {
39
+ await this.warn(logger, `Option 'userName' is deprecated. Please use 'ids' or 'userNames' instead.`);
40
+ }
35
41
  try {
36
- const providedGroupId = (typeof args.options.groupId !== 'undefined') ? args.options.groupId : args.options.teamId;
42
+ const userNames = args.options.userNames || args.options.userName;
43
+ const providedGroupId = await this.getGroupId(logger, args);
37
44
  const isUnifiedGroup = await entraGroup.isUnifiedGroup(providedGroupId);
38
45
  if (!isUnifiedGroup) {
39
46
  throw Error(`Specified group with id '${providedGroupId}' is not a Microsoft 365 group.`);
40
47
  }
41
- let requestOptions = {
42
- url: `${this.resource}/v1.0/users/${formatting.encodeQueryParameter(args.options.userName)}/id`,
43
- headers: {
44
- accept: 'application/json;odata.metadata=none'
45
- },
46
- responseType: 'json'
47
- };
48
- const res = await request.get(requestOptions);
49
- const endpoint = `${this.resource}/v1.0/groups/${providedGroupId}/${((typeof args.options.role !== 'undefined') ? args.options.role : '').toLowerCase() === 'owner' ? 'owners' : 'members'}/$ref`;
50
- requestOptions = {
51
- url: endpoint,
48
+ const userIds = await this.getUserIds(logger, args.options.ids, userNames);
49
+ if (this.verbose) {
50
+ await logger.logToStderr(`Adding user(s) ${args.options.ids || userNames} to group ${args.options.groupId || args.options.groupName || args.options.teamId || args.options.teamName}...`);
51
+ }
52
+ await this.addUsers(providedGroupId, userIds, args.options.role);
53
+ }
54
+ catch (err) {
55
+ this.handleRejectedODataJsonPromise(err);
56
+ }
57
+ }
58
+ async getGroupId(logger, args) {
59
+ if (args.options.groupId) {
60
+ return args.options.groupId;
61
+ }
62
+ if (args.options.teamId) {
63
+ return args.options.teamId;
64
+ }
65
+ const name = args.options.groupName || args.options.teamName;
66
+ if (this.verbose) {
67
+ await logger.logToStderr('Retrieving Group ID by display name...');
68
+ }
69
+ return entraGroup.getGroupIdByDisplayName(name);
70
+ }
71
+ async getUserIds(logger, userIds, userNames) {
72
+ if (userIds) {
73
+ return formatting.splitAndTrim(userIds);
74
+ }
75
+ if (this.verbose) {
76
+ await logger.logToStderr('Retrieving user ID(s) by username(s)...');
77
+ }
78
+ return entraUser.getUserIdsByUpns(formatting.splitAndTrim(userNames));
79
+ }
80
+ async addUsers(groupId, userIds, role) {
81
+ for (let i = 0; i < userIds.length; i += 400) {
82
+ const userIdsBatch = userIds.slice(i, i + 400);
83
+ const requestOptions = {
84
+ url: `${this.resource}/v1.0/$batch`,
52
85
  headers: {
53
- 'accept': 'application/json;odata.metadata=none'
86
+ 'content-type': 'application/json;odata.metadata=none'
54
87
  },
55
88
  responseType: 'json',
56
- data: { "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/" + res.value }
89
+ data: {
90
+ requests: []
91
+ }
57
92
  };
58
- await request.post(requestOptions);
59
- }
60
- catch (err) {
61
- this.handleRejectedODataJsonPromise(err);
93
+ for (let j = 0; j < userIdsBatch.length; j += 20) {
94
+ const userIdsChunk = userIdsBatch.slice(j, j + 20);
95
+ requestOptions.data.requests.push({
96
+ id: j + 1,
97
+ method: 'PATCH',
98
+ url: `/groups/${groupId}`,
99
+ headers: {
100
+ 'content-type': 'application/json;odata.metadata=none'
101
+ },
102
+ body: {
103
+ [`${((typeof role !== 'undefined') ? role : '').toLowerCase() === 'owner' ? 'owners' : 'members'}@odata.bind`]: userIdsChunk.map(u => `${this.resource}/v1.0/directoryObjects/${u}`)
104
+ }
105
+ });
106
+ }
107
+ const res = await request.post(requestOptions);
108
+ for (const response of res.responses) {
109
+ if (response.status !== 204) {
110
+ throw response.body;
111
+ }
112
+ }
62
113
  }
63
114
  }
64
115
  }
65
116
  _EntraM365GroupUserAddCommand_instances = new WeakSet(), _EntraM365GroupUserAddCommand_initTelemetry = function _EntraM365GroupUserAddCommand_initTelemetry() {
66
117
  this.telemetry.push((args) => {
67
118
  Object.assign(this.telemetryProperties, {
68
- role: args.options.role,
119
+ role: args.options.role !== 'undefined',
69
120
  teamId: typeof args.options.teamId !== 'undefined',
70
- groupId: typeof args.options.groupId !== 'undefined'
121
+ groupId: typeof args.options.groupId !== 'undefined',
122
+ teamName: typeof args.options.teamName !== 'undefined',
123
+ groupName: typeof args.options.groupName !== 'undefined',
124
+ ids: typeof args.options.ids !== 'undefined',
125
+ userNames: typeof args.options.userNames !== 'undefined',
126
+ userName: typeof args.options.userName !== 'undefined'
71
127
  });
72
128
  });
73
129
  }, _EntraM365GroupUserAddCommand_initOptions = function _EntraM365GroupUserAddCommand_initOptions() {
74
130
  this.options.unshift({
75
- option: '-n, --userName <userName>'
131
+ option: '-n, --userName [userName]'
76
132
  }, {
77
- option: "-i, --groupId [groupId]"
133
+ option: '--ids [ids]'
78
134
  }, {
79
- option: "--teamId [teamId]"
135
+ option: '--userNames [userNames]'
136
+ }, {
137
+ option: '-i, --groupId [groupId]'
138
+ }, {
139
+ option: '--groupName [groupName]'
140
+ }, {
141
+ option: '--teamId [teamId]'
142
+ }, {
143
+ option: '--teamName [teamName]'
80
144
  }, {
81
145
  option: '-r, --role [role]',
82
- autocomplete: ['Owner', 'Member']
146
+ autocomplete: this.allowedRoles
83
147
  });
84
148
  }, _EntraM365GroupUserAddCommand_initValidators = function _EntraM365GroupUserAddCommand_initValidators() {
85
149
  this.validators.push(async (args) => {
86
150
  if (args.options.teamId && !validation.isValidGuid(args.options.teamId)) {
87
- return `${args.options.teamId} is not a valid GUID`;
151
+ return `'${args.options.teamId}' is not a valid GUID for option 'teamId'.`;
88
152
  }
89
153
  if (args.options.groupId && !validation.isValidGuid(args.options.groupId)) {
90
- return `${args.options.groupId} is not a valid GUID`;
154
+ return `'${args.options.groupId}' is not a valid GUID for option 'groupId'.`;
91
155
  }
92
- if (args.options.role) {
93
- if (['owner', 'member'].indexOf(args.options.role.toLowerCase()) === -1) {
94
- return `${args.options.role} is not a valid role value. Allowed values Owner|Member`;
156
+ if (args.options.ids) {
157
+ const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ids);
158
+ if (isValidGUIDArrayResult !== true) {
159
+ return `The following GUIDs are invalid for the option 'ids': ${isValidGUIDArrayResult}.`;
95
160
  }
96
161
  }
162
+ if (args.options.userNames) {
163
+ const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.userNames);
164
+ if (isValidUPNArrayResult !== true) {
165
+ return `The following user principal names are invalid for the option 'userNames': ${isValidUPNArrayResult}.`;
166
+ }
167
+ }
168
+ if (args.options.role && !this.allowedRoles.some(role => role.toLowerCase() === args.options.role.toLowerCase())) {
169
+ return `'${args.options.role}' is not a valid role. Allowed values are: ${this.allowedRoles.join(',')}`;
170
+ }
97
171
  return true;
98
172
  });
99
173
  }, _EntraM365GroupUserAddCommand_initOptionSets = function _EntraM365GroupUserAddCommand_initOptionSets() {
100
- this.optionSets.push({ options: ['groupId', 'teamId'] });
174
+ this.optionSets.push({ options: ['groupId', 'groupName', 'teamId', 'teamName'] });
175
+ this.optionSets.push({ options: ['userName', 'ids', 'userNames'] });
176
+ }, _EntraM365GroupUserAddCommand_initTypes = function _EntraM365GroupUserAddCommand_initTypes() {
177
+ this.types.string.push('userName', 'ids', 'userNames', 'groupId', 'groupName', 'teamId', 'teamName', 'role');
101
178
  };
102
179
  export default new EntraM365GroupUserAddCommand();
103
180
  //# sourceMappingURL=m365group-user-add.js.map
@@ -31,9 +31,6 @@ class EntraM365GroupUserListCommand extends GraphCommand {
31
31
  async commandAction(logger, args) {
32
32
  await this.showDeprecationWarning(logger, aadCommands.M365GROUP_USER_LIST, commands.M365GROUP_USER_LIST);
33
33
  try {
34
- if (args.options.role === 'Guest') {
35
- await this.warn(logger, `Value 'Guest' for the option role is deprecated. Use --filter "userType eq 'Guest'" instead.`);
36
- }
37
34
  const groupId = await this.getGroupId(args.options, logger);
38
35
  const isUnifiedGroup = await entraGroup.isUnifiedGroup(groupId);
39
36
  if (!isUnifiedGroup) {
@@ -42,9 +39,9 @@ class EntraM365GroupUserListCommand extends GraphCommand {
42
39
  let users = [];
43
40
  if (!args.options.role || args.options.role === 'Owner') {
44
41
  const owners = await this.getUsers(args.options, 'Owners', groupId, logger);
45
- owners.forEach(owner => users.push({ ...owner, roles: ['Owner'], userType: 'Owner' }));
42
+ owners.forEach(owner => users.push({ ...owner, roles: ['Owner'] }));
46
43
  }
47
- if (!args.options.role || args.options.role === 'Member' || args.options.role === 'Guest') {
44
+ if (!args.options.role || args.options.role === 'Member') {
48
45
  const members = await this.getUsers(args.options, 'Members', groupId, logger);
49
46
  members.forEach((member) => {
50
47
  const user = users.find((u) => u.id === member.id);
@@ -57,7 +54,7 @@ class EntraM365GroupUserListCommand extends GraphCommand {
57
54
  });
58
55
  }
59
56
  if (args.options.role) {
60
- users = users.filter(i => i.userType === args.options.role);
57
+ users = users.filter(i => i.roles.indexOf(args.options.role) > -1);
61
58
  }
62
59
  await logger.log(users);
63
60
  }
@@ -128,7 +125,7 @@ _EntraM365GroupUserListCommand_instances = new WeakSet(), _EntraM365GroupUserLis
128
125
  option: "-n, --groupDisplayName [groupDisplayName]"
129
126
  }, {
130
127
  option: "-r, --role [type]",
131
- autocomplete: ["Owner", "Member", "Guest"]
128
+ autocomplete: ["Owner", "Member"]
132
129
  }, {
133
130
  option: "-p, --properties [properties]"
134
131
  }, {
@@ -144,8 +141,8 @@ _EntraM365GroupUserListCommand_instances = new WeakSet(), _EntraM365GroupUserLis
144
141
  return `${args.options.groupId} is not a valid GUID`;
145
142
  }
146
143
  if (args.options.role) {
147
- if (['Owner', 'Member', 'Guest'].indexOf(args.options.role) === -1) {
148
- return `${args.options.role} is not a valid role value. Allowed values Owner|Member|Guest`;
144
+ if (['Owner', 'Member'].indexOf(args.options.role) === -1) {
145
+ return `${args.options.role} is not a valid role value. Allowed values Owner|Member`;
149
146
  }
150
147
  }
151
148
  return true;
@@ -3,14 +3,15 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
3
3
  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
4
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
5
  };
6
- var _EntraM365GroupUserSetCommand_instances, _EntraM365GroupUserSetCommand_initTelemetry, _EntraM365GroupUserSetCommand_initOptions, _EntraM365GroupUserSetCommand_initValidators, _EntraM365GroupUserSetCommand_initOptionSets;
6
+ var _EntraM365GroupUserSetCommand_instances, _EntraM365GroupUserSetCommand_initTelemetry, _EntraM365GroupUserSetCommand_initOptions, _EntraM365GroupUserSetCommand_initValidators, _EntraM365GroupUserSetCommand_initOptionSets, _EntraM365GroupUserSetCommand_initTypes;
7
7
  import request from '../../../../request.js';
8
- import { odata } from '../../../../utils/odata.js';
9
8
  import { validation } from '../../../../utils/validation.js';
9
+ import { formatting } from '../../../../utils/formatting.js';
10
10
  import GraphCommand from '../../../base/GraphCommand.js';
11
11
  import teamsCommands from '../../../teams/commands.js';
12
12
  import commands from '../../commands.js';
13
13
  import { entraGroup } from '../../../../utils/entraGroup.js';
14
+ import { entraUser } from '../../../../utils/entraUser.js';
14
15
  import aadCommands from '../../aadCommands.js';
15
16
  class EntraM365GroupUserSetCommand extends GraphCommand {
16
17
  get name() {
@@ -25,135 +26,209 @@ class EntraM365GroupUserSetCommand extends GraphCommand {
25
26
  constructor() {
26
27
  super();
27
28
  _EntraM365GroupUserSetCommand_instances.add(this);
29
+ this.allowedRoles = ['owner', 'member'];
28
30
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initTelemetry).call(this);
29
31
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initOptions).call(this);
30
32
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initValidators).call(this);
31
33
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initOptionSets).call(this);
34
+ __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initTypes).call(this);
32
35
  }
33
36
  async commandAction(logger, args) {
34
37
  await this.showDeprecationWarning(logger, aadCommands.M365GROUP_USER_SET, commands.M365GROUP_USER_SET);
38
+ if (args.options.userName) {
39
+ await this.warn(logger, `Option 'userName' is deprecated. Please use 'ids' or 'userNames' instead.`);
40
+ }
35
41
  try {
36
- const groupId = (typeof args.options.groupId !== 'undefined') ? args.options.groupId : args.options.teamId;
42
+ const userNames = args.options.userNames || args.options.userName;
43
+ const groupId = await this.getGroupId(logger, args);
37
44
  const isUnifiedGroup = await entraGroup.isUnifiedGroup(groupId);
38
45
  if (!isUnifiedGroup) {
39
46
  throw Error(`Specified group with id '${groupId}' is not a Microsoft 365 group.`);
40
47
  }
41
- let users = await this.getOwners(groupId, logger);
42
- const membersAndGuests = await this.getMembersAndGuests(groupId, logger);
43
- users = users.concat(membersAndGuests);
44
- // Filter out duplicate added values for owners (as they are returned as members as well)
45
- users = users.filter((groupUser, index, self) => index === self.findIndex((t) => (t.id === groupUser.id && t.displayName === groupUser.displayName)));
46
- if (this.debug) {
47
- await logger.logToStderr((typeof args.options.groupId !== 'undefined') ? 'Group owners and members:' : 'Team owners and members:');
48
- await logger.logToStderr(users);
49
- await logger.logToStderr('');
50
- }
51
- if (users.filter(i => args.options.userName.toUpperCase() === i.userPrincipalName.toUpperCase()).length <= 0) {
52
- const userNotInGroup = (typeof args.options.groupId !== 'undefined') ?
53
- 'The specified user does not belong to the given Microsoft 365 Group. Please use the \'m365group user add\' command to add new users.' :
54
- 'The specified user does not belong to the given Microsoft Teams team. Please use the \'graph teams user add\' command to add new users.';
55
- throw new Error(userNotInGroup);
56
- }
57
- if (args.options.role === "Owner") {
58
- const foundMember = users.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Member');
59
- if (foundMember !== undefined) {
60
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/$ref`;
61
- const requestOptions = {
62
- url: endpoint,
63
- headers: {
64
- 'accept': 'application/json;odata.metadata=none'
65
- },
66
- responseType: 'json',
67
- data: { "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/" + foundMember.id }
68
- };
69
- await request.post(requestOptions);
70
- }
71
- else {
72
- const userAlreadyOwner = (typeof args.options.groupId !== 'undefined') ?
73
- 'The specified user is already an owner in the specified Microsoft 365 group, and thus cannot be promoted.' :
74
- 'The specified user is already an owner in the specified Microsoft Teams team, and thus cannot be promoted.';
75
- throw new Error(userAlreadyOwner);
76
- }
77
- }
78
- else {
79
- const foundOwner = users.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Owner');
80
- if (foundOwner !== undefined) {
81
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/${foundOwner.id}/$ref`;
82
- const requestOptions = {
83
- url: endpoint,
84
- headers: {
85
- 'accept': 'application/json;odata.metadata=none'
86
- }
87
- };
88
- await request.delete(requestOptions);
89
- }
90
- else {
91
- const userAlreadyMember = (typeof args.options.groupId !== 'undefined') ?
92
- 'The specified user is already a member in the specified Microsoft 365 group, and thus cannot be demoted.' :
93
- 'The specified user is already a member in the specified Microsoft Teams team, and thus cannot be demoted.';
94
- throw new Error(userAlreadyMember);
95
- }
96
- }
48
+ const userIds = await this.getUserIds(logger, args.options.ids, userNames);
49
+ // we can't simply switch the role
50
+ // first add users to the new role
51
+ await this.addUsers(groupId, userIds, args.options.role);
52
+ // remove users from the old role
53
+ await this.removeUsersFromRole(logger, groupId, userIds, args.options.role);
97
54
  }
98
55
  catch (err) {
99
56
  this.handleRejectedODataJsonPromise(err);
100
57
  }
101
58
  }
102
- async getOwners(groupId, logger) {
59
+ async getGroupId(logger, args) {
60
+ if (args.options.groupId) {
61
+ return args.options.groupId;
62
+ }
63
+ if (args.options.teamId) {
64
+ return args.options.teamId;
65
+ }
66
+ const name = args.options.groupName || args.options.teamName;
103
67
  if (this.verbose) {
104
- await logger.logToStderr(`Retrieving owners of the group with id ${groupId}`);
105
- }
106
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners?$select=id,displayName,userPrincipalName,userType`;
107
- const users = await odata.getAllItems(endpoint);
108
- // Currently there is a bug in the Microsoft Graph that returns Owners as
109
- // userType 'member'. We therefore update all returned user as owner
110
- users.forEach(user => {
111
- user.userType = 'Owner';
112
- });
113
- return users;
68
+ await logger.logToStderr('Retrieving Group ID by display name...');
69
+ }
70
+ return entraGroup.getGroupIdByDisplayName(name);
71
+ }
72
+ async getUserIds(logger, userIds, userNames) {
73
+ if (userIds) {
74
+ return formatting.splitAndTrim(userIds);
75
+ }
76
+ if (this.verbose) {
77
+ await logger.logToStderr('Retrieving user ID(s) by username(s)...');
78
+ }
79
+ return entraUser.getUserIdsByUpns(formatting.splitAndTrim(userNames));
114
80
  }
115
- async getMembersAndGuests(groupId, logger) {
81
+ async removeUsersFromRole(logger, groupId, userIds, role) {
82
+ const userIdsToRemove = [];
83
+ const currentRole = (role.toLowerCase() === 'member') ? 'owners' : 'members';
116
84
  if (this.verbose) {
117
- await logger.logToStderr(`Retrieving members of the group with id ${groupId}`);
85
+ await logger.logToStderr(`Removing users from the old role '${currentRole}'.`);
86
+ }
87
+ for (let i = 0; i < userIds.length; i += 20) {
88
+ const userIdsBatch = userIds.slice(i, i + 20);
89
+ const requestOptions = this.getRequestOptions();
90
+ userIdsBatch.map(userId => {
91
+ requestOptions.data.requests.push({
92
+ id: userId,
93
+ method: 'GET',
94
+ url: `/groups/${groupId}/${currentRole}/$count?$filter=id eq '${userId}'`,
95
+ headers: {
96
+ 'ConsistencyLevel': 'eventual'
97
+ }
98
+ });
99
+ });
100
+ // send batch request
101
+ const res = await request.post(requestOptions);
102
+ for (const response of res.responses) {
103
+ if (response.status === 200) {
104
+ if (response.body === 1) {
105
+ // user can be removed from current role
106
+ userIdsToRemove.push(response.id);
107
+ }
108
+ }
109
+ else {
110
+ throw response.body;
111
+ }
112
+ }
113
+ }
114
+ for (let i = 0; i < userIdsToRemove.length; i += 20) {
115
+ const userIdsBatch = userIds.slice(i, i + 20);
116
+ const requestOptions = this.getRequestOptions();
117
+ userIdsBatch.map(userId => {
118
+ requestOptions.data.requests.push({
119
+ id: userId,
120
+ method: 'DELETE',
121
+ url: `/groups/${groupId}/${currentRole}/${userId}/$ref`
122
+ });
123
+ });
124
+ const res = await request.post(requestOptions);
125
+ for (const response of res.responses) {
126
+ if (response.status !== 204) {
127
+ throw response.body;
128
+ }
129
+ }
130
+ }
131
+ }
132
+ async addUsers(groupId, userIds, role) {
133
+ for (let i = 0; i < userIds.length; i += 400) {
134
+ const userIdsBatch = userIds.slice(i, i + 400);
135
+ const requestOptions = this.getRequestOptions();
136
+ for (let j = 0; j < userIdsBatch.length; j += 20) {
137
+ const userIdsChunk = userIdsBatch.slice(j, j + 20);
138
+ requestOptions.data.requests.push({
139
+ id: j + 1,
140
+ method: 'PATCH',
141
+ url: `/groups/${groupId}`,
142
+ headers: {
143
+ 'content-type': 'application/json;odata.metadata=none'
144
+ },
145
+ body: {
146
+ [`${role.toLowerCase() === 'member' ? 'members' : 'owners'}@odata.bind`]: userIdsChunk.map(u => `${this.resource}/v1.0/directoryObjects/${u}`)
147
+ }
148
+ });
149
+ }
150
+ const res = await request.post(requestOptions);
151
+ for (const response of res.responses) {
152
+ if (response.status !== 204) {
153
+ throw response.body;
154
+ }
155
+ }
118
156
  }
119
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/members?$select=id,displayName,userPrincipalName,userType`;
120
- return await odata.getAllItems(endpoint);
157
+ }
158
+ getRequestOptions() {
159
+ const requestOptions = {
160
+ url: `${this.resource}/v1.0/$batch`,
161
+ headers: {
162
+ 'content-type': 'application/json;odata.metadata=none'
163
+ },
164
+ responseType: 'json',
165
+ data: {
166
+ requests: []
167
+ }
168
+ };
169
+ return requestOptions;
121
170
  }
122
171
  }
123
172
  _EntraM365GroupUserSetCommand_instances = new WeakSet(), _EntraM365GroupUserSetCommand_initTelemetry = function _EntraM365GroupUserSetCommand_initTelemetry() {
124
173
  this.telemetry.push((args) => {
125
174
  Object.assign(this.telemetryProperties, {
126
175
  teamId: typeof args.options.teamId !== 'undefined',
176
+ teamName: typeof args.options.teamName !== 'undefined',
127
177
  groupId: typeof args.options.groupId !== 'undefined',
128
- role: args.options.role
178
+ groupName: typeof args.options.groupName !== 'undefined',
179
+ ids: typeof args.options.ids !== 'undefined',
180
+ userNames: typeof args.options.userNames !== 'undefined'
129
181
  });
130
182
  });
131
183
  }, _EntraM365GroupUserSetCommand_initOptions = function _EntraM365GroupUserSetCommand_initOptions() {
132
184
  this.options.unshift({
133
- option: "-i, --groupId [groupId]"
185
+ option: '-n, --userName [userName]'
186
+ }, {
187
+ option: '--ids [ids]'
188
+ }, {
189
+ option: '--userNames [userNames]'
190
+ }, {
191
+ option: '-i, --groupId [groupId]'
134
192
  }, {
135
- option: "--teamId [teamId]"
193
+ option: '--groupName [groupName]'
136
194
  }, {
137
- option: '-n, --userName <userName>'
195
+ option: '--teamId [teamId]'
196
+ }, {
197
+ option: '--teamName [teamName]'
138
198
  }, {
139
199
  option: '-r, --role <role>',
140
- autocomplete: ['Owner', 'Member']
200
+ autocomplete: this.allowedRoles
141
201
  });
142
202
  }, _EntraM365GroupUserSetCommand_initValidators = function _EntraM365GroupUserSetCommand_initValidators() {
143
203
  this.validators.push(async (args) => {
144
204
  if (args.options.teamId && !validation.isValidGuid(args.options.teamId)) {
145
- return `${args.options.teamId} is not a valid GUID`;
205
+ return `'${args.options.teamId}' is not a valid GUID for option 'teamId'.`;
146
206
  }
147
207
  if (args.options.groupId && !validation.isValidGuid(args.options.groupId)) {
148
- return `${args.options.groupId} is not a valid GUID`;
208
+ return `'${args.options.groupId}' is not a valid GUID for option 'groupId'.`;
209
+ }
210
+ if (args.options.ids) {
211
+ const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ids);
212
+ if (isValidGUIDArrayResult !== true) {
213
+ return `The following GUIDs are invalid for the option 'ids': ${isValidGUIDArrayResult}.`;
214
+ }
215
+ }
216
+ if (args.options.userNames) {
217
+ const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.userNames);
218
+ if (isValidUPNArrayResult !== true) {
219
+ return `The following user principal names are invalid for the option 'userNames': ${isValidUPNArrayResult}.`;
220
+ }
149
221
  }
150
- if (['Owner', 'Member'].indexOf(args.options.role) === -1) {
151
- return `${args.options.role} is not a valid role value. Allowed values Owner|Member`;
222
+ if (args.options.role && !this.allowedRoles.some(role => role.toLowerCase() === args.options.role.toLowerCase())) {
223
+ return `'${args.options.role}' is not a valid role. Allowed values are: ${this.allowedRoles.join(',')}`;
152
224
  }
153
225
  return true;
154
226
  });
155
227
  }, _EntraM365GroupUserSetCommand_initOptionSets = function _EntraM365GroupUserSetCommand_initOptionSets() {
156
- this.optionSets.push({ options: ['groupId', 'teamId'] });
228
+ this.optionSets.push({ options: ['groupId', 'groupName', 'teamId', 'teamName'] });
229
+ this.optionSets.push({ options: ['userName', 'ids', 'userNames'] });
230
+ }, _EntraM365GroupUserSetCommand_initTypes = function _EntraM365GroupUserSetCommand_initTypes() {
231
+ this.types.string.push('userName', 'ids', 'userNames', 'groupId', 'groupName', 'teamId', 'teamName', 'role');
157
232
  };
158
233
  export default new EntraM365GroupUserSetCommand();
159
234
  //# sourceMappingURL=m365group-user-set.js.map