@pnp/cli-microsoft365 10.0.0-beta.a868b81 → 10.0.0-beta.d54aaac

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 (82) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +3 -1
  4. package/dist/Command.js +4 -1
  5. package/dist/m365/commands/login.js +1 -1
  6. package/dist/m365/file/commands/file-move.js +135 -0
  7. package/dist/m365/file/commands.js +2 -1
  8. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js +47 -0
  9. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-restore.js +48 -0
  10. package/dist/m365/flow/commands.js +2 -0
  11. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0-rc.1.js +25 -0
  12. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  13. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0-rc.1.js +57 -0
  14. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  15. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  16. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  17. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  18. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  19. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  20. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  21. package/dist/m365/spo/commands/site/site-admin-list.js +2 -27
  22. package/dist/m365/spo/commands/site/site-admin-remove.js +193 -0
  23. package/dist/m365/spo/commands/user/user-get.js +67 -9
  24. package/dist/m365/spo/commands.js +5 -0
  25. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  26. package/dist/m365/spp/commands.js +5 -0
  27. package/dist/m365/teams/MeetingTranscript.js +2 -0
  28. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  29. package/dist/m365/teams/commands.js +1 -0
  30. package/dist/utils/driveUtil.js +51 -0
  31. package/dist/utils/spo.js +45 -0
  32. package/dist/utils/zod.js +1 -1
  33. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  34. package/docs/docs/cmd/file/file-move.mdx +79 -0
  35. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  36. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  37. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  38. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  39. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  40. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  41. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  42. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  43. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  44. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  45. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  46. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  47. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  48. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  49. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  50. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  51. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  52. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  53. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  54. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  55. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  56. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  57. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  58. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  59. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  60. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  61. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  62. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  63. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  64. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  65. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  66. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  67. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  68. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  69. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  70. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  71. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  72. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  73. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  74. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  75. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  76. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  77. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  78. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  79. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  80. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  81. package/npm-shrinkwrap.json +203 -375
  82. package/package.json +16 -17
@@ -0,0 +1,193 @@
1
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
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
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
+ };
6
+ var _SpoSiteAdminRemoveCommand_instances, _SpoSiteAdminRemoveCommand_initTelemetry, _SpoSiteAdminRemoveCommand_initOptions, _SpoSiteAdminRemoveCommand_initValidators, _SpoSiteAdminRemoveCommand_initOptionSets, _SpoSiteAdminRemoveCommand_initTypes;
7
+ import { cli } from '../../../../cli/cli.js';
8
+ import request from '../../../../request.js';
9
+ import { entraGroup } from '../../../../utils/entraGroup.js';
10
+ import { entraUser } from '../../../../utils/entraUser.js';
11
+ import { formatting } from '../../../../utils/formatting.js';
12
+ import { spo } from '../../../../utils/spo.js';
13
+ import { validation } from '../../../../utils/validation.js';
14
+ import SpoCommand from '../../../base/SpoCommand.js';
15
+ import commands from '../../commands.js';
16
+ class SpoSiteAdminRemoveCommand extends SpoCommand {
17
+ get name() {
18
+ return commands.SITE_ADMIN_REMOVE;
19
+ }
20
+ get description() {
21
+ return 'Removes a user or group as site collection administrator';
22
+ }
23
+ constructor() {
24
+ super();
25
+ _SpoSiteAdminRemoveCommand_instances.add(this);
26
+ __classPrivateFieldGet(this, _SpoSiteAdminRemoveCommand_instances, "m", _SpoSiteAdminRemoveCommand_initTelemetry).call(this);
27
+ __classPrivateFieldGet(this, _SpoSiteAdminRemoveCommand_instances, "m", _SpoSiteAdminRemoveCommand_initOptions).call(this);
28
+ __classPrivateFieldGet(this, _SpoSiteAdminRemoveCommand_instances, "m", _SpoSiteAdminRemoveCommand_initValidators).call(this);
29
+ __classPrivateFieldGet(this, _SpoSiteAdminRemoveCommand_instances, "m", _SpoSiteAdminRemoveCommand_initOptionSets).call(this);
30
+ __classPrivateFieldGet(this, _SpoSiteAdminRemoveCommand_instances, "m", _SpoSiteAdminRemoveCommand_initTypes).call(this);
31
+ }
32
+ async commandAction(logger, args) {
33
+ try {
34
+ if (!args.options.force) {
35
+ const principalToDelete = args.options.groupId || args.options.groupName ? 'group' : 'user';
36
+ const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove specified ${principalToDelete} from the site administrators list ${args.options.siteUrl}?` });
37
+ if (!result) {
38
+ return;
39
+ }
40
+ }
41
+ const loginNameToRemove = await this.getCorrectLoginName(args.options);
42
+ if (args.options.asAdmin) {
43
+ await this.callActionAsAdmin(logger, args, loginNameToRemove);
44
+ return;
45
+ }
46
+ await this.callAction(logger, args, loginNameToRemove);
47
+ }
48
+ catch (err) {
49
+ this.handleRejectedODataJsonPromise(err);
50
+ }
51
+ }
52
+ async callActionAsAdmin(logger, args, loginNameToRemove) {
53
+ if (this.verbose) {
54
+ await logger.logToStderr('Removing site administrator as an administrator...');
55
+ }
56
+ const adminUrl = await spo.getSpoAdminUrl(logger, this.debug);
57
+ const siteId = await this.getSiteId(args.options.siteUrl, logger);
58
+ const primaryAdminLoginName = await spo.getPrimaryAdminLoginNameAsAdmin(adminUrl, siteId, logger, this.verbose);
59
+ if (loginNameToRemove === primaryAdminLoginName) {
60
+ throw 'You cannot remove the primary site collection administrator.';
61
+ }
62
+ const existingAdmins = await this.getSiteAdmins(adminUrl, siteId);
63
+ const adminsToSet = existingAdmins.filter(u => u.loginName.toLowerCase() !== loginNameToRemove.toLowerCase());
64
+ await this.setSiteAdminsAsAdmin(adminUrl, siteId, adminsToSet);
65
+ }
66
+ async getSiteId(siteUrl, logger) {
67
+ const siteGraphId = await spo.getSiteId(siteUrl, logger, this.verbose);
68
+ const match = siteGraphId.match(/,([a-f0-9\-]{36}),/i);
69
+ if (!match) {
70
+ throw `Site with URL ${siteUrl} not found`;
71
+ }
72
+ return match[1];
73
+ }
74
+ async getSiteAdmins(adminUrl, siteId) {
75
+ const requestOptions = {
76
+ url: `${adminUrl}/_api/SPO.Tenant/GetSiteAdministrators?siteId='${siteId}'`,
77
+ headers: {
78
+ accept: 'application/json;odata=nometadata',
79
+ 'content-type': 'application/json;charset=utf-8'
80
+ }
81
+ };
82
+ const response = await request.post(requestOptions);
83
+ const responseContent = JSON.parse(response);
84
+ return responseContent.value;
85
+ }
86
+ async getCorrectLoginName(options) {
87
+ if (options.userId || options.userName) {
88
+ const userPrincipalName = options.userName ? options.userName : await entraUser.getUpnByUserId(options.userId);
89
+ if (userPrincipalName) {
90
+ return `i:0#.f|membership|${userPrincipalName}`;
91
+ }
92
+ throw 'User not found.';
93
+ }
94
+ else {
95
+ const group = options.groupId ? await entraGroup.getGroupById(options.groupId) : await entraGroup.getGroupByDisplayName(options.groupName);
96
+ //for entra groups, M365 groups have an associated email and security groups don't
97
+ if (group?.mail) {
98
+ //M365 group is prefixed with c:0o.c|federateddirectoryclaimprovider
99
+ return `c:0o.c|federateddirectoryclaimprovider|${group.id}`;
100
+ }
101
+ else {
102
+ //security group is prefixed with c:0t.c|tenant
103
+ return `c:0t.c|tenant|${group?.id}`;
104
+ }
105
+ }
106
+ }
107
+ async setSiteAdminsAsAdmin(adminUrl, siteId, admins) {
108
+ const requestOptions = {
109
+ url: `${adminUrl}/_api/SPOInternalUseOnly.Tenant/SetSiteSecondaryAdministrators`,
110
+ headers: {
111
+ accept: 'application/json;odata=nometadata',
112
+ 'content-type': 'application/json;charset=utf-8'
113
+ },
114
+ data: {
115
+ secondaryAdministratorsFieldsData: {
116
+ siteId: siteId,
117
+ secondaryAdministratorLoginNames: admins.map(u => u.loginName)
118
+ }
119
+ }
120
+ };
121
+ await request.post(requestOptions);
122
+ }
123
+ async callAction(logger, args, loginNameToRemove) {
124
+ if (this.verbose) {
125
+ await logger.logToStderr('Removing site administrator...');
126
+ }
127
+ const primaryOwnerLogin = await spo.getPrimaryOwnerLoginFromSite(args.options.siteUrl, logger, this.verbose);
128
+ if (loginNameToRemove === primaryOwnerLogin) {
129
+ throw 'You cannot remove the primary site collection administrator.';
130
+ }
131
+ const requestOptions = {
132
+ url: `${args.options.siteUrl}/_api/web/siteusers('${formatting.encodeQueryParameter(loginNameToRemove)}')`,
133
+ headers: {
134
+ 'accept': 'application/json',
135
+ 'X-Http-Method': 'MERGE',
136
+ 'If-Match': '*'
137
+ },
138
+ data: { IsSiteAdmin: false },
139
+ responseType: 'json'
140
+ };
141
+ await request.post(requestOptions);
142
+ }
143
+ }
144
+ _SpoSiteAdminRemoveCommand_instances = new WeakSet(), _SpoSiteAdminRemoveCommand_initTelemetry = function _SpoSiteAdminRemoveCommand_initTelemetry() {
145
+ this.telemetry.push((args) => {
146
+ Object.assign(this.telemetryProperties, {
147
+ userId: typeof args.options.userId !== 'undefined',
148
+ userName: typeof args.options.userName !== 'undefined',
149
+ groupId: typeof args.options.groupId !== 'undefined',
150
+ groupName: typeof args.options.groupName !== 'undefined',
151
+ force: !!args.options.force,
152
+ asAdmin: !!args.options.asAdmin
153
+ });
154
+ });
155
+ }, _SpoSiteAdminRemoveCommand_initOptions = function _SpoSiteAdminRemoveCommand_initOptions() {
156
+ this.options.unshift({
157
+ option: '-u, --siteUrl <siteUrl>'
158
+ }, {
159
+ option: '--userId [userId]'
160
+ }, {
161
+ option: '--userName [userName]'
162
+ }, {
163
+ option: '--groupId [groupId]'
164
+ }, {
165
+ option: '--groupName [groupName]'
166
+ }, {
167
+ option: '--asAdmin'
168
+ }, {
169
+ option: '-f, --force'
170
+ });
171
+ }, _SpoSiteAdminRemoveCommand_initValidators = function _SpoSiteAdminRemoveCommand_initValidators() {
172
+ this.validators.push(async (args) => {
173
+ if (args.options.userId &&
174
+ !validation.isValidGuid(args.options.userId)) {
175
+ return `${args.options.userId} is not a valid GUID`;
176
+ }
177
+ if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
178
+ return `${args.options.userName} is not a valid userName`;
179
+ }
180
+ if (args.options.groupId &&
181
+ !validation.isValidGuid(args.options.groupId)) {
182
+ return `${args.options.groupId} is not a valid GUID`;
183
+ }
184
+ return validation.isValidSharePointUrl(args.options.siteUrl);
185
+ });
186
+ }, _SpoSiteAdminRemoveCommand_initOptionSets = function _SpoSiteAdminRemoveCommand_initOptionSets() {
187
+ this.optionSets.push({ options: ['userId', 'userName', 'groupId', 'groupName'] });
188
+ }, _SpoSiteAdminRemoveCommand_initTypes = function _SpoSiteAdminRemoveCommand_initTypes() {
189
+ this.types.string.push('siteUrl', 'userId', 'userName', 'groupId', 'groupName');
190
+ this.types.boolean.push('force', 'asAdmin');
191
+ };
192
+ export default new SpoSiteAdminRemoveCommand();
193
+ //# sourceMappingURL=site-admin-remove.js.map
@@ -3,8 +3,9 @@ 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 _SpoUserGetCommand_instances, _SpoUserGetCommand_initTelemetry, _SpoUserGetCommand_initOptions, _SpoUserGetCommand_initValidators, _SpoUserGetCommand_initOptionSets;
6
+ var _SpoUserGetCommand_instances, _SpoUserGetCommand_initTelemetry, _SpoUserGetCommand_initOptions, _SpoUserGetCommand_initTypes, _SpoUserGetCommand_initValidators, _SpoUserGetCommand_initOptionSets;
7
7
  import request from '../../../../request.js';
8
+ import { entraGroup } from '../../../../utils/entraGroup.js';
8
9
  import { formatting } from '../../../../utils/formatting.js';
9
10
  import { validation } from '../../../../utils/validation.js';
10
11
  import SpoCommand from '../../../base/SpoCommand.js';
@@ -23,23 +24,38 @@ class SpoUserGetCommand extends SpoCommand {
23
24
  __classPrivateFieldGet(this, _SpoUserGetCommand_instances, "m", _SpoUserGetCommand_initOptions).call(this);
24
25
  __classPrivateFieldGet(this, _SpoUserGetCommand_instances, "m", _SpoUserGetCommand_initValidators).call(this);
25
26
  __classPrivateFieldGet(this, _SpoUserGetCommand_instances, "m", _SpoUserGetCommand_initOptionSets).call(this);
27
+ __classPrivateFieldGet(this, _SpoUserGetCommand_instances, "m", _SpoUserGetCommand_initTypes).call(this);
26
28
  }
27
29
  async commandAction(logger, args) {
28
30
  if (this.verbose) {
29
31
  await logger.logToStderr(`Retrieving information for user in site '${args.options.webUrl}'...`);
30
32
  }
31
- let requestUrl = '';
33
+ let requestUrl = `${args.options.webUrl}/_api/web/`;
32
34
  if (args.options.id) {
33
- requestUrl = `${args.options.webUrl}/_api/web/siteusers/GetById('${formatting.encodeQueryParameter(args.options.id.toString())}')`;
35
+ requestUrl += `siteusers/GetById('${formatting.encodeQueryParameter(args.options.id.toString())}')`;
34
36
  }
35
37
  else if (args.options.email) {
36
- requestUrl = `${args.options.webUrl}/_api/web/siteusers/GetByEmail('${formatting.encodeQueryParameter(args.options.email)}')`;
38
+ requestUrl += `siteusers/GetByEmail('${formatting.encodeQueryParameter(args.options.email)}')`;
37
39
  }
38
40
  else if (args.options.loginName) {
39
- requestUrl = `${args.options.webUrl}/_api/web/siteusers/GetByLoginName('${formatting.encodeQueryParameter(args.options.loginName)}')`;
41
+ requestUrl += `siteusers/GetByLoginName('${formatting.encodeQueryParameter(args.options.loginName)}')`;
42
+ }
43
+ else if (args.options.userName) {
44
+ const user = await this.getUser(requestUrl, args.options.userName);
45
+ requestUrl += `siteusers/GetById('${formatting.encodeQueryParameter(user.Id.toString())}')`;
46
+ }
47
+ else if (args.options.entraGroupId || args.options.entraGroupName) {
48
+ const entraGroup = await this.getEntraGroup(args.options.entraGroupId, args.options.entraGroupName);
49
+ // For entra groups, M365 groups have an associated email and security groups don't
50
+ if (entraGroup?.mail) {
51
+ requestUrl += `siteusers/GetByEmail('${formatting.encodeQueryParameter(entraGroup.mail)}')`;
52
+ }
53
+ else {
54
+ requestUrl += `siteusers/GetByLoginName('c:0t.c|tenant|${entraGroup?.id}')`;
55
+ }
40
56
  }
41
57
  else {
42
- requestUrl = `${args.options.webUrl}/_api/web/currentuser`;
58
+ requestUrl += `currentuser`;
43
59
  }
44
60
  const requestOptions = {
45
61
  url: requestUrl,
@@ -57,13 +73,38 @@ class SpoUserGetCommand extends SpoCommand {
57
73
  this.handleRejectedODataJsonPromise(err);
58
74
  }
59
75
  }
76
+ async getUser(baseUrl, userName) {
77
+ const requestUrl = `${baseUrl}siteusers?$filter=UserPrincipalName eq ('${formatting.encodeQueryParameter(userName)}')`;
78
+ const requestOptions = {
79
+ url: requestUrl,
80
+ headers: {
81
+ accept: 'application/json;odata=nometadata'
82
+ },
83
+ responseType: 'json'
84
+ };
85
+ const userInstance = await request.get(requestOptions);
86
+ const userInstanceValue = userInstance.value[0];
87
+ if (!userInstanceValue) {
88
+ throw `User not found: ${userName}`;
89
+ }
90
+ return userInstanceValue;
91
+ }
92
+ async getEntraGroup(entraGroupId, entraGroupName) {
93
+ if (entraGroupId) {
94
+ return entraGroup.getGroupById(entraGroupId);
95
+ }
96
+ return entraGroup.getGroupByDisplayName(entraGroupName);
97
+ }
60
98
  }
61
99
  _SpoUserGetCommand_instances = new WeakSet(), _SpoUserGetCommand_initTelemetry = function _SpoUserGetCommand_initTelemetry() {
62
100
  this.telemetry.push((args) => {
63
101
  Object.assign(this.telemetryProperties, {
64
102
  id: typeof args.options.id !== 'undefined',
65
103
  email: typeof args.options.email !== 'undefined',
66
- loginName: typeof args.options.loginName !== 'undefined'
104
+ loginName: typeof args.options.loginName !== 'undefined',
105
+ userName: typeof args.options.userName !== 'undefined',
106
+ entraGroupId: typeof args.options.entraGroupId !== 'undefined',
107
+ entraGroupName: typeof args.options.entraGroupName !== 'undefined'
67
108
  });
68
109
  });
69
110
  }, _SpoUserGetCommand_initOptions = function _SpoUserGetCommand_initOptions() {
@@ -75,19 +116,36 @@ _SpoUserGetCommand_instances = new WeakSet(), _SpoUserGetCommand_initTelemetry =
75
116
  option: '--email [email]'
76
117
  }, {
77
118
  option: '--loginName [loginName]'
119
+ }, {
120
+ option: '--userName [userName]'
121
+ }, {
122
+ option: '--entraGroupId [entraGroupId]'
123
+ }, {
124
+ option: '--entraGroupName [entraGroupName]'
78
125
  });
126
+ }, _SpoUserGetCommand_initTypes = function _SpoUserGetCommand_initTypes() {
127
+ this.types.string.push('webUrl', 'id', 'email', 'loginName', 'userName', 'entraGroupId', 'entraGroupName');
79
128
  }, _SpoUserGetCommand_initValidators = function _SpoUserGetCommand_initValidators() {
80
129
  this.validators.push(async (args) => {
81
130
  if (args.options.id &&
82
131
  typeof args.options.id !== 'number') {
83
132
  return `Specified id ${args.options.id} is not a number`;
84
133
  }
134
+ if (args.options.entraGroupId && !validation.isValidGuid(args.options.entraGroupId)) {
135
+ return `${args.options.entraGroupId} is not a valid GUID.`;
136
+ }
137
+ if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
138
+ return `${args.options.userName} is not a valid userName.`;
139
+ }
140
+ if (args.options.email && !validation.isValidUserPrincipalName(args.options.email)) {
141
+ return `${args.options.email} is not a valid email.`;
142
+ }
85
143
  return validation.isValidSharePointUrl(args.options.webUrl);
86
144
  });
87
145
  }, _SpoUserGetCommand_initOptionSets = function _SpoUserGetCommand_initOptionSets() {
88
146
  this.optionSets.push({
89
- options: ['id', 'email', 'loginName'],
90
- runsWhen: (args) => args.options.id || args.options.loginName || args.options.email
147
+ options: ['id', 'email', 'loginName', 'userName', 'entraGroupId', 'entraGroupName'],
148
+ runsWhen: (args) => args.options.id || args.options.email || args.options.loginName || args.options.userName || args.options.entraGroupId || args.options.entraGroupName
91
149
  });
92
150
  };
93
151
  export default new SpoUserGetCommand();
@@ -99,8 +99,11 @@ export default {
99
99
  FOLDER_ROLEASSIGNMENT_ADD: `${prefix} folder roleassignment add`,
100
100
  FOLDER_ROLEINHERITANCE_BREAK: `${prefix} folder roleinheritance break`,
101
101
  FOLDER_ROLEINHERITANCE_RESET: `${prefix} folder roleinheritance reset`,
102
+ FOLDER_SHARINGLINK_ADD: `${prefix} folder sharinglink add`,
103
+ FOLDER_SHARINGLINK_CLEAR: `${prefix} folder sharinglink clear`,
102
104
  FOLDER_SHARINGLINK_GET: `${prefix} folder sharinglink get`,
103
105
  FOLDER_SHARINGLINK_LIST: `${prefix} folder sharinglink list`,
106
+ FOLDER_SHARINGLINK_REMOVE: `${prefix} folder sharinglink remove`,
104
107
  GET: `${prefix} get`,
105
108
  GROUP_ADD: `${prefix} group add`,
106
109
  GROUP_GET: `${prefix} group get`,
@@ -241,7 +244,9 @@ export default {
241
244
  SERVICEPRINCIPAL_SET: `${prefix} serviceprincipal set`,
242
245
  SET: `${prefix} set`,
243
246
  SITE_ADD: `${prefix} site add`,
247
+ SITE_ADMIN_ADD: `${prefix} site admin add`,
244
248
  SITE_ADMIN_LIST: `${prefix} site admin list`,
249
+ SITE_ADMIN_REMOVE: `${prefix} site admin remove`,
245
250
  SITE_APPCATALOG_ADD: `${prefix} site appcatalog add`,
246
251
  SITE_APPCATALOG_LIST: `${prefix} site appcatalog list`,
247
252
  SITE_APPCATALOG_REMOVE: `${prefix} site appcatalog remove`,
@@ -0,0 +1,56 @@
1
+ import config from '../../../../config.js';
2
+ import request from '../../../../request.js';
3
+ import { spo } from '../../../../utils/spo.js';
4
+ import SpoCommand from '../../../base/SpoCommand.js';
5
+ import commands from '../../commands.js';
6
+ class SppContentCenterListCommand extends SpoCommand {
7
+ get name() {
8
+ return commands.CONTENTCENTER_LIST;
9
+ }
10
+ get description() {
11
+ return 'Gets information about the SharePoint Premium content centers';
12
+ }
13
+ defaultProperties() {
14
+ return ['Title', 'Url'];
15
+ }
16
+ async commandAction(logger) {
17
+ try {
18
+ if (this.verbose) {
19
+ await logger.logToStderr(`Retrieving list of content centers...`);
20
+ }
21
+ const spoAdminUrl = await spo.getSpoAdminUrl(logger, this.debug);
22
+ const allContentCenters = await this.getContentCenters(spoAdminUrl, logger);
23
+ await logger.log(allContentCenters);
24
+ }
25
+ catch (err) {
26
+ this.handleRejectedODataJsonPromise(err);
27
+ }
28
+ }
29
+ async getContentCenters(spoAdminUrl, logger) {
30
+ const allSites = [];
31
+ let currentStartIndex = '0';
32
+ const res = await spo.ensureFormDigest(spoAdminUrl, logger, undefined, this.debug);
33
+ do {
34
+ const requestBody = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="2" ObjectPathId="1" /><ObjectPath Id="4" ObjectPathId="3" /><Query Id="5" ObjectPathId="3"><Query SelectAllProperties="true"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties /></ChildItemQuery></Query></Actions><ObjectPaths><Constructor Id="1" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /><Method Id="3" ParentId="1" Name="GetSitePropertiesFromSharePointByFilters"><Parameters><Parameter TypeId="{b92aeee2-c92c-4b67-abcc-024e471bc140}"><Property Name="Filter" Type="String"></Property><Property Name="IncludeDetail" Type="Boolean">false</Property><Property Name="IncludePersonalSite" Type="Enum">0</Property><Property Name="StartIndex" Type="String">${currentStartIndex}</Property><Property Name="Template" Type="String">CONTENTCTR#0</Property></Parameter></Parameters></Method></ObjectPaths></Request>`;
35
+ const requestOptions = {
36
+ url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
37
+ headers: {
38
+ 'X-RequestDigest': res.FormDigestValue
39
+ },
40
+ data: requestBody
41
+ };
42
+ const response = await request.post(requestOptions);
43
+ const json = JSON.parse(response);
44
+ const responseContent = json[0];
45
+ if (responseContent.ErrorInfo) {
46
+ throw responseContent.ErrorInfo.ErrorMessage;
47
+ }
48
+ const sites = json[json.length - 1];
49
+ allSites.push(...sites._Child_Items_);
50
+ currentStartIndex = sites.NextStartIndexFromSharePoint;
51
+ } while (currentStartIndex);
52
+ return allSites;
53
+ }
54
+ }
55
+ export default new SppContentCenterListCommand();
56
+ //# sourceMappingURL=contentcenter-list.js.map
@@ -0,0 +1,5 @@
1
+ const prefix = 'spp';
2
+ export default {
3
+ CONTENTCENTER_LIST: `${prefix} contentcenter list`
4
+ };
5
+ //# sourceMappingURL=commands.js.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=MeetingTranscript.js.map
@@ -0,0 +1,152 @@
1
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
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
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
+ };
6
+ var _TeamsMeetingTranscriptGetCommand_instances, _TeamsMeetingTranscriptGetCommand_initTelemetry, _TeamsMeetingTranscriptGetCommand_initOptions, _TeamsMeetingTranscriptGetCommand_initValidators, _TeamsMeetingTranscriptGetCommand_initOptionSets;
7
+ import auth from '../../../../Auth.js';
8
+ import request from '../../../../request.js';
9
+ import { entraUser } from '../../../../utils/entraUser.js';
10
+ import { accessToken } from '../../../../utils/accessToken.js';
11
+ import { validation } from '../../../../utils/validation.js';
12
+ import GraphCommand from '../../../base/GraphCommand.js';
13
+ import commands from '../../commands.js';
14
+ import fs from 'fs';
15
+ import path from 'path';
16
+ class TeamsMeetingTranscriptGetCommand extends GraphCommand {
17
+ get name() {
18
+ return commands.MEETING_TRANSCRIPT_GET;
19
+ }
20
+ get description() {
21
+ return 'Downloads a transcript for a given meeting';
22
+ }
23
+ constructor() {
24
+ super();
25
+ _TeamsMeetingTranscriptGetCommand_instances.add(this);
26
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptGetCommand_instances, "m", _TeamsMeetingTranscriptGetCommand_initTelemetry).call(this);
27
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptGetCommand_instances, "m", _TeamsMeetingTranscriptGetCommand_initOptions).call(this);
28
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptGetCommand_instances, "m", _TeamsMeetingTranscriptGetCommand_initValidators).call(this);
29
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptGetCommand_instances, "m", _TeamsMeetingTranscriptGetCommand_initOptionSets).call(this);
30
+ }
31
+ async commandAction(logger, args) {
32
+ try {
33
+ const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[this.resource].accessToken);
34
+ if (this.verbose) {
35
+ await logger.logToStderr(`Retrieving transcript for the given meeting...`);
36
+ }
37
+ let requestUrl = `${this.resource}/beta/`;
38
+ if (isAppOnlyAccessToken) {
39
+ if (!args.options.userId && !args.options.userName && !args.options.email) {
40
+ throw `The option 'userId', 'userName' or 'email' is required when retrieving meeting transcript using app only permissions`;
41
+ }
42
+ requestUrl += 'users/';
43
+ if (args.options.userId) {
44
+ requestUrl += args.options.userId;
45
+ }
46
+ else if (args.options.userName) {
47
+ requestUrl += args.options.userName;
48
+ }
49
+ else if (args.options.email) {
50
+ if (this.verbose) {
51
+ await logger.logToStderr(`Getting user ID for user with email '${args.options.email}'.`);
52
+ }
53
+ const userId = await entraUser.getUserIdByEmail(args.options.email);
54
+ requestUrl += userId;
55
+ }
56
+ }
57
+ else {
58
+ if (args.options.userId || args.options.userName || args.options.email) {
59
+ throw `The options 'userId', 'userName', and 'email' cannot be used while retrieving meeting transcript using delegated permissions`;
60
+ }
61
+ requestUrl += `me`;
62
+ }
63
+ requestUrl += `/onlineMeetings/${args.options.meetingId}/transcripts/${args.options.id}`;
64
+ if (args.options.outputFile) {
65
+ requestUrl += '/content?$format=text/vtt';
66
+ }
67
+ const requestOptions = {
68
+ url: requestUrl,
69
+ headers: {
70
+ accept: 'application/json;odata.metadata=none'
71
+ },
72
+ responseType: args.options.outputFile ? 'stream' : 'json'
73
+ };
74
+ const meetingTranscript = await request.get(requestOptions);
75
+ if (meetingTranscript) {
76
+ if (args.options.outputFile) {
77
+ // Not possible to use async/await for this promise
78
+ await new Promise((resolve, reject) => {
79
+ const writer = fs.createWriteStream(args.options.outputFile);
80
+ meetingTranscript.data.pipe(writer);
81
+ writer.on('error', err => {
82
+ reject(err);
83
+ });
84
+ writer.on('close', async () => {
85
+ const filePath = args.options.outputFile;
86
+ if (this.verbose) {
87
+ await logger.logToStderr(`File saved to path ${filePath}`);
88
+ }
89
+ return resolve();
90
+ });
91
+ });
92
+ }
93
+ else {
94
+ await logger.log(meetingTranscript);
95
+ }
96
+ }
97
+ else {
98
+ throw `The specified meeting transcript was not found`;
99
+ }
100
+ }
101
+ catch (err) {
102
+ this.handleRejectedODataJsonPromise(err);
103
+ }
104
+ }
105
+ }
106
+ _TeamsMeetingTranscriptGetCommand_instances = new WeakSet(), _TeamsMeetingTranscriptGetCommand_initTelemetry = function _TeamsMeetingTranscriptGetCommand_initTelemetry() {
107
+ this.telemetry.push((args) => {
108
+ Object.assign(this.telemetryProperties, {
109
+ userId: typeof args.options.userId !== 'undefined',
110
+ userName: typeof args.options.userName !== 'undefined',
111
+ email: typeof args.options.email !== 'undefined',
112
+ outputFile: typeof args.options.outputFile !== 'undefined'
113
+ });
114
+ });
115
+ }, _TeamsMeetingTranscriptGetCommand_initOptions = function _TeamsMeetingTranscriptGetCommand_initOptions() {
116
+ this.options.unshift({
117
+ option: '-u, --userId [userId]'
118
+ }, {
119
+ option: '-n, --userName [userName]'
120
+ }, {
121
+ option: '--email [email]'
122
+ }, {
123
+ option: '-m, --meetingId <meetingId>'
124
+ }, {
125
+ option: '-i, --id <id>'
126
+ }, {
127
+ option: '-f, --outputFile [outputFile]'
128
+ });
129
+ }, _TeamsMeetingTranscriptGetCommand_initValidators = function _TeamsMeetingTranscriptGetCommand_initValidators() {
130
+ this.validators.push(async (args) => {
131
+ if (args.options.userId && !validation.isValidGuid(args.options.userId)) {
132
+ return `${args.options.userId} is not a valid Guid`;
133
+ }
134
+ if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
135
+ return `${args.options.userName} is not a valid user principal name (UPN)`;
136
+ }
137
+ if (args.options.email && !validation.isValidUserPrincipalName(args.options.email)) {
138
+ return `${args.options.email} is not a valid email`;
139
+ }
140
+ if (args.options.outputFile && !fs.existsSync(path.dirname(args.options.outputFile))) {
141
+ return 'Specified path where to save the file does not exits';
142
+ }
143
+ return true;
144
+ });
145
+ }, _TeamsMeetingTranscriptGetCommand_initOptionSets = function _TeamsMeetingTranscriptGetCommand_initOptionSets() {
146
+ this.optionSets.push({
147
+ options: ['userId', 'userName', 'email'],
148
+ runsWhen: (args) => args.options.userId || args.options.userName || args.options.email
149
+ });
150
+ };
151
+ export default new TeamsMeetingTranscriptGetCommand();
152
+ //# sourceMappingURL=meeting-transcript-get.js.map
@@ -32,6 +32,7 @@ export default {
32
32
  MEETING_LIST: `${prefix} meeting list`,
33
33
  MEETING_ATTENDANCEREPORT_GET: `${prefix} meeting attendancereport get`,
34
34
  MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
35
+ MEETING_TRANSCRIPT_GET: `${prefix} meeting transcript get`,
35
36
  MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
36
37
  MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
37
38
  MEMBERSETTINGS_SET: `${prefix} membersettings set`,
@@ -0,0 +1,51 @@
1
+ import request from "../request.js";
2
+ export const driveUtil = {
3
+ /**
4
+ * Retrieves the Drive associated with the specified site and URL.
5
+ * @param siteId Site ID
6
+ * @param url Drive URL
7
+ * @returns The Drive associated with the drive URL.
8
+ */
9
+ async getDriveByUrl(siteId, url) {
10
+ const requestOptions = {
11
+ url: `https://graph.microsoft.com/v1.0/sites/${siteId}/drives?$select=webUrl,id`,
12
+ headers: {
13
+ accept: 'application/json;odata.metadata=none'
14
+ },
15
+ responseType: 'json'
16
+ };
17
+ const drives = await request.get(requestOptions);
18
+ const lowerCaseFolderUrl = url.href.toLowerCase();
19
+ const drive = drives.value
20
+ .sort((a, b) => b.webUrl.localeCompare(a.webUrl))
21
+ .find((d) => {
22
+ const driveUrl = d.webUrl.toLowerCase();
23
+ return lowerCaseFolderUrl.startsWith(driveUrl) &&
24
+ (driveUrl.length === lowerCaseFolderUrl.length ||
25
+ lowerCaseFolderUrl[driveUrl.length] === '/');
26
+ });
27
+ if (!drive) {
28
+ throw `Drive '${url.href}' not found`;
29
+ }
30
+ return drive;
31
+ },
32
+ /**
33
+ * Retrieves the ID of a drive item (file, folder, etc.) associated with the given drive and item URL.
34
+ * @param drive The Drive object containing the item
35
+ * @param itemUrl Item URL
36
+ * @returns Drive item ID
37
+ */
38
+ async getDriveItemId(drive, itemUrl) {
39
+ const relativeItemUrl = itemUrl.href.replace(new RegExp(`${drive.webUrl}`, 'i'), '').replace(/\/+$/, '');
40
+ const requestOptions = {
41
+ url: `https://graph.microsoft.com/v1.0/drives/${drive.id}/root${relativeItemUrl ? `:${relativeItemUrl}` : ''}?$select=id`,
42
+ headers: {
43
+ accept: 'application/json;odata.metadata=none'
44
+ },
45
+ responseType: 'json'
46
+ };
47
+ const driveItem = await request.get(requestOptions);
48
+ return driveItem?.id;
49
+ }
50
+ };
51
+ //# sourceMappingURL=driveUtil.js.map