@pnp/cli-microsoft365 9.0.0 → 9.1.0-beta.2d61838

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 (122) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +6 -4
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/Command.js +4 -1
  6. package/dist/api.js +1 -1
  7. package/dist/config.js +1 -0
  8. package/dist/m365/base/PowerAutomateCommand.js +1 -1
  9. package/dist/m365/commands/login.js +1 -1
  10. package/dist/m365/external/commands/item/item-add.js +2 -5
  11. package/dist/m365/file/commands/file-move.js +135 -0
  12. package/dist/m365/file/commands.js +2 -1
  13. package/dist/m365/flow/commands/environment/environment-get.js +1 -1
  14. package/dist/m365/flow/commands/environment/environment-list.js +1 -1
  15. package/dist/m365/flow/commands/flow-disable.js +1 -1
  16. package/dist/m365/flow/commands/flow-enable.js +1 -1
  17. package/dist/m365/flow/commands/flow-export.js +17 -16
  18. package/dist/m365/flow/commands/flow-get.js +1 -1
  19. package/dist/m365/flow/commands/flow-list.js +1 -1
  20. package/dist/m365/flow/commands/flow-remove.js +1 -1
  21. package/dist/m365/flow/commands/owner/owner-ensure.js +1 -1
  22. package/dist/m365/flow/commands/owner/owner-list.js +1 -1
  23. package/dist/m365/flow/commands/owner/owner-remove.js +1 -1
  24. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js +47 -0
  25. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-restore.js +48 -0
  26. package/dist/m365/flow/commands/run/run-cancel.js +1 -1
  27. package/dist/m365/flow/commands/run/run-get.js +1 -1
  28. package/dist/m365/flow/commands/run/run-list.js +1 -1
  29. package/dist/m365/flow/commands/run/run-resubmit.js +2 -2
  30. package/dist/m365/flow/commands.js +2 -0
  31. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0-rc.1.js +25 -0
  32. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  33. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0-rc.1.js +57 -0
  34. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  35. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  36. package/dist/m365/spo/commands/file/file-roleassignment-add.js +17 -54
  37. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +13 -40
  38. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +5 -13
  39. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +5 -13
  40. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  41. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  42. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  43. package/dist/m365/spo/commands/list/list-get.js +17 -4
  44. package/dist/m365/spo/commands/page/page-remove.js +37 -16
  45. package/dist/m365/spo/commands/page/page-section-add.js +185 -34
  46. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  47. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  48. package/dist/m365/spo/commands/site/site-admin-list.js +10 -36
  49. package/dist/m365/spo/commands/site/site-admin-remove.js +194 -0
  50. package/dist/m365/spo/commands/site/site-sharingpermission-set.js +68 -0
  51. package/dist/m365/spo/commands/user/user-get.js +67 -9
  52. package/dist/m365/spo/commands.js +6 -0
  53. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  54. package/dist/m365/spp/commands.js +5 -0
  55. package/dist/m365/teams/MeetingTranscript.js +2 -0
  56. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  57. package/dist/m365/teams/commands.js +1 -0
  58. package/dist/m365/viva/commands/engage/Community.js +2 -0
  59. package/dist/m365/viva/commands/engage/engage-community-list.js +28 -0
  60. package/dist/m365/viva/commands.js +1 -0
  61. package/dist/request.js +46 -61
  62. package/dist/utils/driveUtil.js +51 -0
  63. package/dist/utils/spo.js +73 -7
  64. package/dist/utils/timersUtil.js +12 -0
  65. package/dist/utils/urlUtil.js +8 -0
  66. package/dist/utils/zod.js +1 -1
  67. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  68. package/docs/docs/cmd/external/item/item-add.mdx +3 -3
  69. package/docs/docs/cmd/file/file-move.mdx +79 -0
  70. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  71. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  72. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  73. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  74. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  75. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  76. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  77. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  78. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  79. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  80. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  81. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  82. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  83. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  84. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  85. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  86. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  87. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  88. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  89. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  90. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  91. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  92. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  93. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  94. package/docs/docs/cmd/spo/page/page-remove.mdx +30 -12
  95. package/docs/docs/cmd/spo/page/page-section-add.mdx +57 -2
  96. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  97. package/docs/docs/cmd/spo/site/site-admin-list.mdx +64 -12
  98. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  99. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  100. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  101. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  102. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  103. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  104. package/docs/docs/cmd/spo/site/site-sharingpermission-set.mdx +58 -0
  105. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  106. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  107. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  108. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  109. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  110. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  111. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  112. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  113. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  114. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  115. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  116. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  117. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  118. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  119. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  120. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +81 -0
  121. package/npm-shrinkwrap.json +205 -377
  122. package/package.json +17 -18
@@ -17,6 +17,9 @@ class SpoSiteAdminListCommand extends SpoCommand {
17
17
  get description() {
18
18
  return 'Lists all administrators of a specific SharePoint site';
19
19
  }
20
+ defaultProperties() {
21
+ return ['Id', 'LoginName', 'Title', 'PrincipalTypeString'];
22
+ }
20
23
  constructor() {
21
24
  super();
22
25
  _SpoSiteAdminListCommand_instances.add(this);
@@ -46,20 +49,16 @@ class SpoSiteAdminListCommand extends SpoCommand {
46
49
  const requestOptions = {
47
50
  url: `${adminUrl}/_api/SPO.Tenant/GetSiteAdministrators?siteId='${siteId}'`,
48
51
  headers: {
49
- accept: 'application/json;odata=nometadata',
50
- 'content-type': 'application/json;charset=utf-8'
51
- }
52
+ accept: 'application/json;odata=nometadata'
53
+ },
54
+ responseType: 'json'
52
55
  };
53
56
  const response = await request.post(requestOptions);
54
- const responseContent = JSON.parse(response);
55
- const primaryAdminLoginName = await this.getPrimaryAdminLoginNameFromAdmin(adminUrl, siteId);
56
- const mappedResult = responseContent.value.map((u) => ({
57
- Id: null,
57
+ const primaryAdminLoginName = await spo.getPrimaryAdminLoginNameAsAdmin(adminUrl, siteId, logger, this.verbose);
58
+ const mappedResult = response.value.map((u) => ({
58
59
  Email: u.email,
59
60
  LoginName: u.loginName,
60
61
  Title: u.name,
61
- PrincipalType: null,
62
- PrincipalTypeString: null,
63
62
  IsPrimaryAdmin: u.loginName === primaryAdminLoginName
64
63
  }));
65
64
  await logger.log(mappedResult);
@@ -72,32 +71,19 @@ class SpoSiteAdminListCommand extends SpoCommand {
72
71
  }
73
72
  return match[1];
74
73
  }
75
- async getPrimaryAdminLoginNameFromAdmin(adminUrl, siteId) {
76
- const requestOptions = {
77
- url: `${adminUrl}/_api/SPO.Tenant/sites('${siteId}')?$select=OwnerLoginName`,
78
- headers: {
79
- accept: 'application/json;odata=nometadata',
80
- 'content-type': 'application/json;charset=utf-8'
81
- }
82
- };
83
- const response = await request.get(requestOptions);
84
- const responseContent = JSON.parse(response);
85
- return responseContent.OwnerLoginName;
86
- }
87
74
  async callAction(logger, args) {
88
75
  if (this.verbose) {
89
76
  await logger.logToStderr('Retrieving site administrators...');
90
77
  }
91
78
  const requestOptions = {
92
79
  url: `${args.options.siteUrl}/_api/web/siteusers?$filter=IsSiteAdmin eq true`,
93
- method: 'GET',
94
80
  headers: {
95
81
  'accept': 'application/json;odata=nometadata'
96
82
  },
97
83
  responseType: 'json'
98
84
  };
99
85
  const responseContent = await request.get(requestOptions);
100
- const primaryOwnerLogin = await this.getPrimaryOwnerLoginFromSite(args.options.siteUrl);
86
+ const primaryOwnerLogin = await spo.getPrimaryOwnerLoginFromSite(args.options.siteUrl, logger, this.verbose);
101
87
  const mappedResult = responseContent.value.map((u) => ({
102
88
  Id: u.Id,
103
89
  LoginName: u.LoginName,
@@ -109,23 +95,10 @@ class SpoSiteAdminListCommand extends SpoCommand {
109
95
  }));
110
96
  await logger.log(mappedResult);
111
97
  }
112
- async getPrimaryOwnerLoginFromSite(siteUrl) {
113
- const requestOptions = {
114
- url: `${siteUrl}/_api/site/owner`,
115
- method: 'GET',
116
- headers: {
117
- 'accept': 'application/json;odata=nometadata'
118
- },
119
- responseType: 'json'
120
- };
121
- const responseContent = await request.get(requestOptions);
122
- return responseContent?.LoginName ?? null;
123
- }
124
98
  }
125
99
  _SpoSiteAdminListCommand_instances = new WeakSet(), _SpoSiteAdminListCommand_initTelemetry = function _SpoSiteAdminListCommand_initTelemetry() {
126
100
  this.telemetry.push((args) => {
127
101
  Object.assign(this.telemetryProperties, {
128
- siteUrl: typeof args.options.siteUrl !== 'undefined',
129
102
  asAdmin: !!args.options.asAdmin
130
103
  });
131
104
  });
@@ -139,6 +112,7 @@ _SpoSiteAdminListCommand_instances = new WeakSet(), _SpoSiteAdminListCommand_ini
139
112
  this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.siteUrl));
140
113
  }, _SpoSiteAdminListCommand_initTypes = function _SpoSiteAdminListCommand_initTypes() {
141
114
  this.types.string.push('siteUrl');
115
+ this.types.boolean.push('asAdmin');
142
116
  };
143
117
  export default new SpoSiteAdminListCommand();
144
118
  //# sourceMappingURL=site-admin-list.js.map
@@ -0,0 +1,194 @@
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
+ responseType: 'json'
82
+ };
83
+ const response = await request.post(requestOptions);
84
+ return response.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
+ responseType: 'json'
121
+ };
122
+ await request.post(requestOptions);
123
+ }
124
+ async callAction(logger, args, loginNameToRemove) {
125
+ if (this.verbose) {
126
+ await logger.logToStderr('Removing site administrator...');
127
+ }
128
+ const primaryOwnerLogin = await spo.getPrimaryOwnerLoginFromSite(args.options.siteUrl, logger, this.verbose);
129
+ if (loginNameToRemove === primaryOwnerLogin) {
130
+ throw 'You cannot remove the primary site collection administrator.';
131
+ }
132
+ const requestOptions = {
133
+ url: `${args.options.siteUrl}/_api/web/siteusers('${formatting.encodeQueryParameter(loginNameToRemove)}')`,
134
+ headers: {
135
+ 'accept': 'application/json',
136
+ 'X-Http-Method': 'MERGE',
137
+ 'If-Match': '*'
138
+ },
139
+ data: { IsSiteAdmin: false },
140
+ responseType: 'json'
141
+ };
142
+ await request.post(requestOptions);
143
+ }
144
+ }
145
+ _SpoSiteAdminRemoveCommand_instances = new WeakSet(), _SpoSiteAdminRemoveCommand_initTelemetry = function _SpoSiteAdminRemoveCommand_initTelemetry() {
146
+ this.telemetry.push((args) => {
147
+ Object.assign(this.telemetryProperties, {
148
+ userId: typeof args.options.userId !== 'undefined',
149
+ userName: typeof args.options.userName !== 'undefined',
150
+ groupId: typeof args.options.groupId !== 'undefined',
151
+ groupName: typeof args.options.groupName !== 'undefined',
152
+ force: !!args.options.force,
153
+ asAdmin: !!args.options.asAdmin
154
+ });
155
+ });
156
+ }, _SpoSiteAdminRemoveCommand_initOptions = function _SpoSiteAdminRemoveCommand_initOptions() {
157
+ this.options.unshift({
158
+ option: '-u, --siteUrl <siteUrl>'
159
+ }, {
160
+ option: '--userId [userId]'
161
+ }, {
162
+ option: '--userName [userName]'
163
+ }, {
164
+ option: '--groupId [groupId]'
165
+ }, {
166
+ option: '--groupName [groupName]'
167
+ }, {
168
+ option: '--asAdmin'
169
+ }, {
170
+ option: '-f, --force'
171
+ });
172
+ }, _SpoSiteAdminRemoveCommand_initValidators = function _SpoSiteAdminRemoveCommand_initValidators() {
173
+ this.validators.push(async (args) => {
174
+ if (args.options.userId &&
175
+ !validation.isValidGuid(args.options.userId)) {
176
+ return `${args.options.userId} is not a valid GUID`;
177
+ }
178
+ if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
179
+ return `${args.options.userName} is not a valid userName`;
180
+ }
181
+ if (args.options.groupId &&
182
+ !validation.isValidGuid(args.options.groupId)) {
183
+ return `${args.options.groupId} is not a valid GUID`;
184
+ }
185
+ return validation.isValidSharePointUrl(args.options.siteUrl);
186
+ });
187
+ }, _SpoSiteAdminRemoveCommand_initOptionSets = function _SpoSiteAdminRemoveCommand_initOptionSets() {
188
+ this.optionSets.push({ options: ['userId', 'userName', 'groupId', 'groupName'] });
189
+ }, _SpoSiteAdminRemoveCommand_initTypes = function _SpoSiteAdminRemoveCommand_initTypes() {
190
+ this.types.string.push('siteUrl', 'userId', 'userName', 'groupId', 'groupName');
191
+ this.types.boolean.push('force', 'asAdmin');
192
+ };
193
+ export default new SpoSiteAdminRemoveCommand();
194
+ //# sourceMappingURL=site-admin-remove.js.map
@@ -0,0 +1,68 @@
1
+ import SpoCommand from '../../../base/SpoCommand.js';
2
+ import { globalOptionsZod } from '../../../../Command.js';
3
+ import { z } from 'zod';
4
+ import { zod } from '../../../../utils/zod.js';
5
+ import commands from '../../commands.js';
6
+ import { validation } from '../../../../utils/validation.js';
7
+ import request from '../../../../request.js';
8
+ const options = globalOptionsZod
9
+ .extend({
10
+ siteUrl: zod.alias('u', z.string()
11
+ .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
12
+ message: `'${url}' is not a valid SharePoint Online site URL.`
13
+ }))),
14
+ capability: z.enum(['full', 'limited', 'ownersOnly'])
15
+ })
16
+ .strict();
17
+ class SpoSiteSharingPermissionSetCommand extends SpoCommand {
18
+ get name() {
19
+ return commands.SITE_SHARINGPERMISSION_SET;
20
+ }
21
+ get description() {
22
+ return 'Controls how a site and its components can be shared';
23
+ }
24
+ get schema() {
25
+ return options;
26
+ }
27
+ async commandAction(logger, args) {
28
+ try {
29
+ if (this.verbose) {
30
+ await logger.logToStderr(`Updating sharing permissions for site '${args.options.siteUrl}'...`);
31
+ }
32
+ const { capability } = args.options;
33
+ if (this.verbose) {
34
+ await logger.logToStderr(`Updating site sharing permissions...`);
35
+ }
36
+ const requestOptionsWeb = {
37
+ url: `${args.options.siteUrl}/_api/Web`,
38
+ headers: {
39
+ accept: 'application/json;odata=nometadata'
40
+ },
41
+ responseType: 'json',
42
+ data: {
43
+ MembersCanShare: capability === 'full' || capability === 'limited'
44
+ }
45
+ };
46
+ await request.patch(requestOptionsWeb);
47
+ if (this.verbose) {
48
+ await logger.logToStderr(`Updating associated member group sharing permissions...`);
49
+ }
50
+ const requestOptionsMemberGroup = {
51
+ url: `${args.options.siteUrl}/_api/Web/AssociatedMemberGroup`,
52
+ headers: {
53
+ accept: 'application/json;odata=nometadata'
54
+ },
55
+ responseType: 'json',
56
+ data: {
57
+ AllowMembersEditMembership: capability === 'full'
58
+ }
59
+ };
60
+ await request.patch(requestOptionsMemberGroup);
61
+ }
62
+ catch (err) {
63
+ this.handleRejectedODataJsonPromise(err);
64
+ }
65
+ }
66
+ }
67
+ export default new SpoSiteSharingPermissionSetCommand();
68
+ //# sourceMappingURL=site-sharingpermission-set.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();
@@ -100,8 +100,11 @@ export default {
100
100
  FOLDER_ROLEASSIGNMENT_ADD: `${prefix} folder roleassignment add`,
101
101
  FOLDER_ROLEINHERITANCE_BREAK: `${prefix} folder roleinheritance break`,
102
102
  FOLDER_ROLEINHERITANCE_RESET: `${prefix} folder roleinheritance reset`,
103
+ FOLDER_SHARINGLINK_ADD: `${prefix} folder sharinglink add`,
104
+ FOLDER_SHARINGLINK_CLEAR: `${prefix} folder sharinglink clear`,
103
105
  FOLDER_SHARINGLINK_GET: `${prefix} folder sharinglink get`,
104
106
  FOLDER_SHARINGLINK_LIST: `${prefix} folder sharinglink list`,
107
+ FOLDER_SHARINGLINK_REMOVE: `${prefix} folder sharinglink remove`,
105
108
  GET: `${prefix} get`,
106
109
  GROUP_ADD: `${prefix} group add`,
107
110
  GROUP_GET: `${prefix} group get`,
@@ -242,7 +245,9 @@ export default {
242
245
  SERVICEPRINCIPAL_SET: `${prefix} serviceprincipal set`,
243
246
  SET: `${prefix} set`,
244
247
  SITE_ADD: `${prefix} site add`,
248
+ SITE_ADMIN_ADD: `${prefix} site admin add`,
245
249
  SITE_ADMIN_LIST: `${prefix} site admin list`,
250
+ SITE_ADMIN_REMOVE: `${prefix} site admin remove`,
246
251
  SITE_APPCATALOG_ADD: `${prefix} site appcatalog add`,
247
252
  SITE_APPCATALOG_LIST: `${prefix} site appcatalog list`,
248
253
  SITE_APPCATALOG_REMOVE: `${prefix} site appcatalog remove`,
@@ -268,6 +273,7 @@ export default {
268
273
  SITE_REMOVE: `${prefix} site remove`,
269
274
  SITE_RENAME: `${prefix} site rename`,
270
275
  SITE_SET: `${prefix} site set`,
276
+ SITE_SHARINGPERMISSION_SET: `${prefix} site sharingpermission set`,
271
277
  SITE_CHROME_SET: `${prefix} site chrome set`,
272
278
  SITEDESIGN_ADD: `${prefix} sitedesign add`,
273
279
  SITEDESIGN_APPLY: `${prefix} sitedesign apply`,
@@ -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