@pnp/cli-microsoft365 6.2.0-beta.e162995 → 6.2.0-beta.edaa477

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 (43) hide show
  1. package/.eslintrc.js +6 -0
  2. package/dist/m365/aad/commands/approleassignment/approleassignment-add.js +3 -0
  3. package/dist/m365/onenote/commands/page/page-list.js +137 -0
  4. package/dist/m365/onenote/commands.js +2 -1
  5. package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-list.js +68 -0
  6. package/dist/m365/pp/commands.js +1 -0
  7. package/dist/m365/purview/commands/retentionlabel/retentionlabel-add.js +143 -0
  8. package/dist/m365/purview/commands.js +1 -0
  9. package/dist/m365/spo/commands/file/GraphFileDetails.js +3 -0
  10. package/dist/m365/spo/commands/file/file-sharinginfo-get.js +12 -12
  11. package/dist/m365/spo/commands/file/file-sharinglink-get.js +116 -0
  12. package/dist/m365/spo/commands/file/file-sharinglink-list.js +133 -0
  13. package/dist/m365/spo/commands/file/file-sharinglink-remove.js +135 -0
  14. package/dist/m365/spo/commands/group/group-member-add.js +33 -6
  15. package/dist/m365/spo/commands/group/group-member-remove.js +78 -33
  16. package/dist/m365/spo/commands/list/list-retentionlabel-ensure.js +10 -2
  17. package/dist/m365/spo/commands/listitem/ListItemRetentionLabel.js +3 -0
  18. package/dist/m365/spo/commands/listitem/SiteRetentionLabel.js +3 -0
  19. package/dist/m365/spo/commands/listitem/listitem-retentionlabel-ensure.js +161 -0
  20. package/dist/m365/spo/commands/term/term-list.js +99 -29
  21. package/dist/m365/spo/commands.js +4 -0
  22. package/dist/m365/teams/commands/chat/chat-list.js +29 -7
  23. package/docs/docs/cmd/onenote/page/page-list.md +140 -0
  24. package/docs/docs/cmd/planner/bucket/bucket-add.md +17 -0
  25. package/docs/docs/cmd/planner/bucket/bucket-get.md +17 -0
  26. package/docs/docs/cmd/planner/bucket/bucket-list.md +17 -0
  27. package/docs/docs/cmd/planner/plan/plan-add.md +40 -0
  28. package/docs/docs/cmd/planner/plan/plan-get.md +21 -0
  29. package/docs/docs/cmd/planner/plan/plan-list.md +19 -0
  30. package/docs/docs/cmd/planner/plan/plan-set.md +20 -0
  31. package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-list.md +95 -0
  32. package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.md +128 -0
  33. package/docs/docs/cmd/spo/file/file-sharinglink-get.md +107 -0
  34. package/docs/docs/cmd/spo/file/file-sharinglink-list.md +106 -0
  35. package/docs/docs/cmd/spo/file/file-sharinglink-remove.md +52 -0
  36. package/docs/docs/cmd/spo/group/group-member-add.md +22 -4
  37. package/docs/docs/cmd/spo/group/group-member-remove.md +24 -6
  38. package/docs/docs/cmd/spo/list/list-retentionlabel-ensure.md +8 -5
  39. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.md +58 -0
  40. package/docs/docs/cmd/spo/term/term-list.md +138 -0
  41. package/docs/docs/cmd/teams/chat/chat-list.md +16 -4
  42. package/npm-shrinkwrap.json +182 -202
  43. package/package.json +12 -11
@@ -0,0 +1,161 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
12
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
13
+ 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");
14
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
15
+ };
16
+ var _SpoListItemRetentionLabelEnsureCommand_instances, _SpoListItemRetentionLabelEnsureCommand_initTelemetry, _SpoListItemRetentionLabelEnsureCommand_initOptions, _SpoListItemRetentionLabelEnsureCommand_initValidators, _SpoListItemRetentionLabelEnsureCommand_initOptionSets;
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ const request_1 = require("../../../../request");
19
+ const formatting_1 = require("../../../../utils/formatting");
20
+ const urlUtil_1 = require("../../../../utils/urlUtil");
21
+ const validation_1 = require("../../../../utils/validation");
22
+ const SpoCommand_1 = require("../../../base/SpoCommand");
23
+ const commands_1 = require("../../commands");
24
+ const SpoWebRetentionLabelListCommand = require("../web/web-retentionlabel-list");
25
+ const Cli_1 = require("../../../../cli/Cli");
26
+ class SpoListItemRetentionLabelEnsureCommand extends SpoCommand_1.default {
27
+ get name() {
28
+ return commands_1.default.LISTITEM_RETENTIONLABEL_ENSURE;
29
+ }
30
+ get description() {
31
+ return 'Apply a retention label to a list item';
32
+ }
33
+ constructor() {
34
+ super();
35
+ _SpoListItemRetentionLabelEnsureCommand_instances.add(this);
36
+ __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initTelemetry).call(this);
37
+ __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initOptions).call(this);
38
+ __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initValidators).call(this);
39
+ __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initOptionSets).call(this);
40
+ }
41
+ commandAction(logger, args) {
42
+ return __awaiter(this, void 0, void 0, function* () {
43
+ try {
44
+ const labelInformation = yield this.getLabelInformation(args.options, logger);
45
+ yield this.applyLabel(args.options, labelInformation, logger);
46
+ }
47
+ catch (err) {
48
+ this.handleRejectedODataJsonPromise(err);
49
+ }
50
+ });
51
+ }
52
+ getLabelInformation(options, logger) {
53
+ return __awaiter(this, void 0, void 0, function* () {
54
+ const cmdOptions = {
55
+ webUrl: options.webUrl,
56
+ output: 'json',
57
+ debug: options.debug,
58
+ verbose: options.verbose
59
+ };
60
+ const output = yield Cli_1.Cli.executeCommandWithOutput(SpoWebRetentionLabelListCommand, { options: Object.assign(Object.assign({}, cmdOptions), { _: [] }) });
61
+ if (this.verbose) {
62
+ logger.logToStderr(output.stderr);
63
+ }
64
+ const labels = JSON.parse(output.stdout);
65
+ const label = labels.find(l => l.TagName === options.name || l.TagId === options.id);
66
+ if (this.verbose && label !== undefined) {
67
+ logger.logToStderr(`Retention label found in the list of available labels: '${label.TagName}' / '${label.TagId}'...`);
68
+ }
69
+ if (label === undefined) {
70
+ throw new Error(`The specified retention label does not exist`);
71
+ }
72
+ return {
73
+ complianceTag: label.TagName,
74
+ isTagPolicyHold: label.BlockDelete,
75
+ isTagPolicyRecord: label.BlockEdit,
76
+ isEventBasedTag: label.IsEventTag,
77
+ isTagSuperLock: label.SuperLock,
78
+ isUnlockedAsDefault: label.UnlockedAsDefault
79
+ };
80
+ });
81
+ }
82
+ applyLabel(options, labelInformation, logger) {
83
+ return __awaiter(this, void 0, void 0, function* () {
84
+ if (this.verbose) {
85
+ logger.logToStderr(`Applying retention label to item in list '${options.listId || options.listTitle || options.listUrl}' in site at ${options.webUrl}...`);
86
+ }
87
+ let requestUrl = `${options.webUrl}/_api/web`;
88
+ if (options.listId) {
89
+ requestUrl += `/lists(guid'${formatting_1.formatting.encodeQueryParameter(options.listId)}')/items(${options.listItemId})/SetComplianceTag()`;
90
+ }
91
+ else if (options.listTitle) {
92
+ requestUrl += `/lists/getByTitle('${formatting_1.formatting.encodeQueryParameter(options.listTitle)}')/items(${options.listItemId})/SetComplianceTag()`;
93
+ }
94
+ else if (options.listUrl) {
95
+ const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
96
+ requestUrl += `/GetList(@listUrl)/items(${options.listItemId})/SetComplianceTag()?@listUrl='${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}'`;
97
+ }
98
+ const requestOptions = {
99
+ url: requestUrl,
100
+ headers: {
101
+ 'accept': 'application/json;odata=nometadata'
102
+ },
103
+ data: labelInformation,
104
+ responseType: 'json'
105
+ };
106
+ yield request_1.default.post(requestOptions);
107
+ });
108
+ }
109
+ }
110
+ _SpoListItemRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoListItemRetentionLabelEnsureCommand_initTelemetry = function _SpoListItemRetentionLabelEnsureCommand_initTelemetry() {
111
+ this.telemetry.push((args) => {
112
+ Object.assign(this.telemetryProperties, {
113
+ listId: typeof args.options.listId !== 'undefined',
114
+ listTitle: typeof args.options.listTitle !== 'undefined',
115
+ listUrl: typeof args.options.listUrl !== 'undefined',
116
+ name: typeof args.options.name !== 'undefined',
117
+ id: typeof args.options.id !== 'undefined'
118
+ });
119
+ });
120
+ }, _SpoListItemRetentionLabelEnsureCommand_initOptions = function _SpoListItemRetentionLabelEnsureCommand_initOptions() {
121
+ this.options.unshift({
122
+ option: '-u, --webUrl <webUrl>'
123
+ }, {
124
+ option: '--listItemId <listItemId>'
125
+ }, {
126
+ option: '--listId [listId]'
127
+ }, {
128
+ option: '--listTitle [listTitle]'
129
+ }, {
130
+ option: '--listUrl [listUrl]'
131
+ }, {
132
+ option: '-n, --name [name]'
133
+ }, {
134
+ option: '-i, --id [id]'
135
+ });
136
+ }, _SpoListItemRetentionLabelEnsureCommand_initValidators = function _SpoListItemRetentionLabelEnsureCommand_initValidators() {
137
+ this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
138
+ const id = parseInt(args.options.listItemId);
139
+ if (isNaN(id)) {
140
+ return `${args.options.listItemId} is not a valid list item ID`;
141
+ }
142
+ const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
143
+ if (isValidSharePointUrl !== true) {
144
+ return isValidSharePointUrl;
145
+ }
146
+ if (args.options.listId &&
147
+ !validation_1.validation.isValidGuid(args.options.listId)) {
148
+ return `${args.options.listId} is not a valid GUID`;
149
+ }
150
+ if (args.options.id &&
151
+ !validation_1.validation.isValidGuid(args.options.id)) {
152
+ return `${args.options.id} is not a valid GUID`;
153
+ }
154
+ return true;
155
+ }));
156
+ }, _SpoListItemRetentionLabelEnsureCommand_initOptionSets = function _SpoListItemRetentionLabelEnsureCommand_initOptionSets() {
157
+ this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] });
158
+ this.optionSets.push({ options: ['name', 'id'] });
159
+ };
160
+ module.exports = new SpoListItemRetentionLabelEnsureCommand();
161
+ //# sourceMappingURL=listitem-retentionlabel-ensure.js.map
@@ -30,7 +30,7 @@ class SpoTermListCommand extends SpoCommand_1.default {
30
30
  return 'Lists taxonomy terms from the given term set';
31
31
  }
32
32
  defaultProperties() {
33
- return ['Id', 'Name'];
33
+ return ['Id', 'Name', 'ParentTermId'];
34
34
  }
35
35
  constructor() {
36
36
  super();
@@ -50,27 +50,47 @@ class SpoTermListCommand extends SpoCommand_1.default {
50
50
  }
51
51
  const termGroupQuery = args.options.termGroupId ? `<Method Id="77" ParentId="75" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termGroupId}}</Parameter></Parameters></Method>` : `<Method Id="77" ParentId="75" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termGroupName)}</Parameter></Parameters></Method>`;
52
52
  const termSetQuery = args.options.termSetId ? `<Method Id="82" ParentId="80" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termSetId}}</Parameter></Parameters></Method>` : `<Method Id="82" ParentId="80" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termSetName)}</Parameter></Parameters></Method>`;
53
- const requestOptions = {
54
- url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
55
- headers: {
56
- 'X-RequestDigest': res.FormDigestValue
57
- },
58
- data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="70" ObjectPathId="69" /><ObjectIdentityQuery Id="71" ObjectPathId="69" /><ObjectPath Id="73" ObjectPathId="72" /><ObjectIdentityQuery Id="74" ObjectPathId="72" /><ObjectPath Id="76" ObjectPathId="75" /><ObjectPath Id="78" ObjectPathId="77" /><ObjectIdentityQuery Id="79" ObjectPathId="77" /><ObjectPath Id="81" ObjectPathId="80" /><ObjectPath Id="83" ObjectPathId="82" /><ObjectIdentityQuery Id="84" ObjectPathId="82" /><ObjectPath Id="86" ObjectPathId="85" /><Query Id="87" ObjectPathId="85"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="Name" ScalarProperty="true" /><Property Name="Id" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><StaticMethod Id="69" Name="GetTaxonomySession" TypeId="{981cbc68-9edc-4f8d-872f-71146fcbb84f}" /><Method Id="72" ParentId="69" Name="GetDefaultSiteCollectionTermStore" /><Property Id="75" ParentId="72" Name="Groups" />${termGroupQuery}<Property Id="80" ParentId="77" Name="TermSets" />${termSetQuery}<Property Id="85" ParentId="82" Name="Terms" /></ObjectPaths></Request>`
59
- };
60
- const processQuery = yield request_1.default.post(requestOptions);
61
- const json = JSON.parse(processQuery);
62
- const response = json[0];
63
- if (response.ErrorInfo) {
64
- throw response.ErrorInfo.ErrorMessage;
65
- }
66
- const result = json[json.length - 1];
53
+ const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="70" ObjectPathId="69" /><ObjectIdentityQuery Id="71" ObjectPathId="69" /><ObjectPath Id="73" ObjectPathId="72" /><ObjectIdentityQuery Id="74" ObjectPathId="72" /><ObjectPath Id="76" ObjectPathId="75" /><ObjectPath Id="78" ObjectPathId="77" /><ObjectIdentityQuery Id="79" ObjectPathId="77" /><ObjectPath Id="81" ObjectPathId="80" /><ObjectPath Id="83" ObjectPathId="82" /><ObjectIdentityQuery Id="84" ObjectPathId="82" /><ObjectPath Id="86" ObjectPathId="85" /><Query Id="87" ObjectPathId="85"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="Name" ScalarProperty="true" /><Property Name="Id" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><StaticMethod Id="69" Name="GetTaxonomySession" TypeId="{981cbc68-9edc-4f8d-872f-71146fcbb84f}" /><Method Id="72" ParentId="69" Name="GetDefaultSiteCollectionTermStore" /><Property Id="75" ParentId="72" Name="Groups" />${termGroupQuery}<Property Id="80" ParentId="77" Name="TermSets" />${termSetQuery}<Property Id="85" ParentId="82" Name="Terms" /></ObjectPaths></Request>`;
54
+ const result = yield this.executeCsomCall(data, spoAdminUrl, res);
55
+ const terms = [];
67
56
  if (result._Child_Items_ && result._Child_Items_.length > 0) {
68
- result._Child_Items_.forEach(t => {
69
- t.CreatedDate = new Date(Number(t.CreatedDate.replace('/Date(', '').replace(')/', ''))).toISOString();
70
- t.Id = t.Id.replace('/Guid(', '').replace(')/', '');
71
- t.LastModifiedDate = new Date(Number(t.LastModifiedDate.replace('/Date(', '').replace(')/', ''))).toISOString();
57
+ for (const term of result._Child_Items_) {
58
+ this.setTermDetails(term);
59
+ terms.push(term);
60
+ if (args.options.includeChildTerms && term.TermsCount > 0) {
61
+ yield this.getChildTerms(spoAdminUrl, res, term);
62
+ }
63
+ }
64
+ }
65
+ if (!args.options.output || args.options.output === 'json') {
66
+ logger.log(terms);
67
+ }
68
+ else if (!args.options.includeChildTerms) {
69
+ // Converted to text friendly output
70
+ logger.log(terms.map(i => {
71
+ return {
72
+ Id: i.Id,
73
+ Name: i.Name
74
+ };
75
+ }));
76
+ }
77
+ else {
78
+ // Converted to text friendly output
79
+ const friendlyOutput = [];
80
+ terms.forEach(term => {
81
+ term.ParentTermId = '';
82
+ friendlyOutput.push(term);
83
+ if (term.Children && term.Children.length > 0) {
84
+ this.getFriendlyChildTerms(term, friendlyOutput);
85
+ }
72
86
  });
73
- logger.log(result._Child_Items_);
87
+ logger.log(friendlyOutput.map(i => {
88
+ return {
89
+ Id: i.Id,
90
+ Name: i.Name,
91
+ ParentTermId: i.ParentTermId
92
+ };
93
+ }));
74
94
  }
75
95
  }
76
96
  catch (err) {
@@ -78,6 +98,57 @@ class SpoTermListCommand extends SpoCommand_1.default {
78
98
  }
79
99
  });
80
100
  }
101
+ getFriendlyChildTerms(term, friendlyOutput) {
102
+ term.Children.forEach(childTerm => {
103
+ childTerm.ParentTermId = term.Id;
104
+ friendlyOutput.push(childTerm);
105
+ if (childTerm.Children && childTerm.Children.length > 0) {
106
+ this.getFriendlyChildTerms(childTerm, friendlyOutput);
107
+ }
108
+ });
109
+ }
110
+ getChildTerms(spoAdminUrl, res, parentTerm) {
111
+ return __awaiter(this, void 0, void 0, function* () {
112
+ parentTerm.Children = [];
113
+ const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="20" ObjectPathId="19" /><Query Id="21" ObjectPathId="19"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="CustomSortOrder" ScalarProperty="true" /><Property Name="CustomProperties" ScalarProperty="true" /><Property Name="LocalCustomProperties" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><Property Id="19" ParentId="16" Name="Terms" /><Identity Id="16" Name="${parentTerm._ObjectIdentity_}" /></ObjectPaths></Request>`;
114
+ const result = yield this.executeCsomCall(data, spoAdminUrl, res);
115
+ if (result._Child_Items_ && result._Child_Items_.length > 0) {
116
+ for (const term of result._Child_Items_) {
117
+ this.setTermDetails(term);
118
+ parentTerm.Children.push(term);
119
+ if (term.TermsCount > 0) {
120
+ yield this.getChildTerms(spoAdminUrl, res, term);
121
+ }
122
+ }
123
+ }
124
+ });
125
+ }
126
+ setTermDetails(term) {
127
+ term.CreatedDate = this.parseTermDateToIsoString(term.CreatedDate);
128
+ term.Id = term.Id.replace('/Guid(', '').replace(')/', '');
129
+ term.LastModifiedDate = this.parseTermDateToIsoString(term.LastModifiedDate);
130
+ }
131
+ parseTermDateToIsoString(dateAsString) {
132
+ return new Date(Number(dateAsString.replace('/Date(', '').replace(')/', ''))).toISOString();
133
+ }
134
+ executeCsomCall(data, spoAdminUrl, res) {
135
+ return __awaiter(this, void 0, void 0, function* () {
136
+ const requestOptions = {
137
+ url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
138
+ headers: {
139
+ 'X-RequestDigest': res.FormDigestValue
140
+ },
141
+ data: data
142
+ };
143
+ const processQuery = yield request_1.default.post(requestOptions);
144
+ const json = JSON.parse(processQuery);
145
+ const response = json[0];
146
+ if (response.ErrorInfo) {
147
+ throw response.ErrorInfo.ErrorMessage;
148
+ }
149
+ return json[json.length - 1];
150
+ });
151
+ }
81
152
  }
82
153
  _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry = function _SpoTermListCommand_initTelemetry() {
83
154
  this.telemetry.push((args) => {
@@ -85,7 +156,8 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
85
156
  termGroupId: typeof args.options.termGroupId !== 'undefined',
86
157
  termGroupName: typeof args.options.termGroupName !== 'undefined',
87
158
  termSetId: typeof args.options.termSetId !== 'undefined',
88
- termSetName: typeof args.options.termSetName !== 'undefined'
159
+ termSetName: typeof args.options.termSetName !== 'undefined',
160
+ includeChildTerms: !!args.options.includeChildTerms
89
161
  });
90
162
  });
91
163
  }, _SpoTermListCommand_initOptions = function _SpoTermListCommand_initOptions() {
@@ -97,18 +169,16 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
97
169
  option: '--termSetId [termSetId]'
98
170
  }, {
99
171
  option: '--termSetName [termSetName]'
172
+ }, {
173
+ option: '--includeChildTerms'
100
174
  });
101
175
  }, _SpoTermListCommand_initValidators = function _SpoTermListCommand_initValidators() {
102
176
  this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
103
- if (args.options.termGroupId) {
104
- if (!validation_1.validation.isValidGuid(args.options.termGroupId)) {
105
- return `${args.options.termGroupId} is not a valid GUID`;
106
- }
177
+ if (args.options.termGroupId && !validation_1.validation.isValidGuid(args.options.termGroupId)) {
178
+ return `${args.options.termGroupId} is not a valid GUID`;
107
179
  }
108
- if (args.options.termSetId) {
109
- if (!validation_1.validation.isValidGuid(args.options.termSetId)) {
110
- return `${args.options.termSetId} is not a valid GUID`;
111
- }
180
+ if (args.options.termSetId && !validation_1.validation.isValidGuid(args.options.termSetId)) {
181
+ return `${args.options.termSetId} is not a valid GUID`;
112
182
  }
113
183
  return true;
114
184
  }));
@@ -62,6 +62,9 @@ exports.default = {
62
62
  FILE_ROLEINHERITANCE_BREAK: `${prefix} file roleinheritance break`,
63
63
  FILE_ROLEINHERITANCE_RESET: `${prefix} file roleinheritance reset`,
64
64
  FILE_SHARINGINFO_GET: `${prefix} file sharinginfo get`,
65
+ FILE_SHARINGLINK_GET: `${prefix} file sharinglink get`,
66
+ FILE_SHARINGLINK_LIST: `${prefix} file sharinglink list`,
67
+ FILE_SHARINGLINK_REMOVE: `${prefix} file sharinglink remove`,
65
68
  FILE_VERSION_CLEAR: `${prefix} file version clear`,
66
69
  FILE_VERSION_GET: `${prefix} file version get`,
67
70
  FILE_VERSION_LIST: `${prefix} file version list`,
@@ -147,6 +150,7 @@ exports.default = {
147
150
  LISTITEM_RECORD_UNDECLARE: `${prefix} listitem record undeclare`,
148
151
  LISTITEM_RECORD_UNLOCK: `${prefix} listitem record unlock`,
149
152
  LISTITEM_REMOVE: `${prefix} listitem remove`,
153
+ LISTITEM_RETENTIONLABEL_ENSURE: `${prefix} listitem retentionlabel ensure`,
150
154
  LISTITEM_RETENTIONLABEL_REMOVE: `${prefix} listitem retentionlabel remove`,
151
155
  LISTITEM_ROLEASSIGNMENT_ADD: `${prefix} listitem roleassignment add`,
152
156
  LISTITEM_ROLEASSIGNMENT_REMOVE: `${prefix} listitem roleassignment remove`,
@@ -15,9 +15,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
15
15
  };
16
16
  var _TeamsChatListCommand_instances, _TeamsChatListCommand_initTelemetry, _TeamsChatListCommand_initOptions, _TeamsChatListCommand_initValidators;
17
17
  Object.defineProperty(exports, "__esModule", { value: true });
18
+ const Auth_1 = require("../../../../Auth");
19
+ const accessToken_1 = require("../../../../utils/accessToken");
18
20
  const odata_1 = require("../../../../utils/odata");
19
21
  const GraphCommand_1 = require("../../../base/GraphCommand");
20
22
  const commands_1 = require("../../commands");
23
+ const validation_1 = require("../../../../utils/validation");
21
24
  class TeamsChatListCommand extends GraphCommand_1.default {
22
25
  get name() {
23
26
  return commands_1.default.CHAT_LIST;
@@ -31,16 +34,26 @@ class TeamsChatListCommand extends GraphCommand_1.default {
31
34
  constructor() {
32
35
  super();
33
36
  _TeamsChatListCommand_instances.add(this);
37
+ this.supportedTypes = ['oneOnOne', 'group', 'meeting'];
34
38
  __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initTelemetry).call(this);
35
39
  __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initOptions).call(this);
36
40
  __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initValidators).call(this);
37
41
  }
38
42
  commandAction(logger, args) {
39
43
  return __awaiter(this, void 0, void 0, function* () {
40
- const filter = args.options.type !== undefined ? `?$filter=chatType eq '${args.options.type}'` : '';
41
- const endpoint = `${this.resource}/v1.0/chats${filter}`;
44
+ const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
45
+ if (isAppOnlyAuth && !args.options.userId && !args.options.userName) {
46
+ throw `The option 'userId' or 'userName' is required when obtaining chats using app only permissions`;
47
+ }
48
+ else if (!isAppOnlyAuth && (args.options.userId || args.options.userName)) {
49
+ throw `The options 'userId' or 'userName' cannot be used when obtaining chats using delegated permissions`;
50
+ }
51
+ let requestUrl = `${this.resource}/v1.0/${!isAppOnlyAuth ? 'me' : `users/${args.options.userId || args.options.userName}`}/chats`;
52
+ if (args.options.type) {
53
+ requestUrl += `?$filter=chatType eq '${args.options.type}'`;
54
+ }
42
55
  try {
43
- const items = yield odata_1.odata.getAllItems(endpoint);
56
+ const items = yield odata_1.odata.getAllItems(requestUrl);
44
57
  logger.log(items);
45
58
  }
46
59
  catch (err) {
@@ -58,13 +71,22 @@ _TeamsChatListCommand_instances = new WeakSet(), _TeamsChatListCommand_initTelem
58
71
  }, _TeamsChatListCommand_initOptions = function _TeamsChatListCommand_initOptions() {
59
72
  this.options.unshift({
60
73
  option: '-t, --type [type]',
61
- autocomplete: ['oneOnOne', 'group', 'meeting']
74
+ autocomplete: this.supportedTypes
75
+ }, {
76
+ option: '--userId [userId]'
77
+ }, {
78
+ option: '--userName [userName]'
62
79
  });
63
80
  }, _TeamsChatListCommand_initValidators = function _TeamsChatListCommand_initValidators() {
64
81
  this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
65
- const supportedTypes = ['oneOnOne', 'group', 'meeting'];
66
- if (args.options.type !== undefined && supportedTypes.indexOf(args.options.type) === -1) {
67
- return `${args.options.type} is not a valid chatType. Accepted values are ${supportedTypes.join(', ')}`;
82
+ if (args.options.type !== undefined && this.supportedTypes.indexOf(args.options.type) === -1) {
83
+ return `${args.options.type} is not a valid chatType. Accepted values are ${this.supportedTypes.join(', ')}`;
84
+ }
85
+ if (args.options.userId && args.options.userName) {
86
+ return `You can only specify either 'userId' or 'userName'`;
87
+ }
88
+ if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
89
+ return `${args.options.userId} is not a valid GUID`;
68
90
  }
69
91
  return true;
70
92
  }));
@@ -0,0 +1,140 @@
1
+ # onenote page list
2
+
3
+ Retrieve a list of OneNote pages.
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 onenote page list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--userId [userId]`
14
+ : Id of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
15
+
16
+ `--userName [userName]`
17
+ : Name of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
18
+
19
+ `--groupId [groupId]`
20
+ : Id of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
21
+
22
+ `--groupName [groupName]`
23
+ : Name of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
24
+
25
+ `-u, --webUrl [webUrl]`
26
+ : URL of the SharePoint site. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
27
+
28
+ --8<-- "docs/cmd/_global.md"
29
+
30
+ ## Remarks
31
+
32
+ When we don't specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, the OneNote pages will be retrieved of the currently logged in user.
33
+
34
+ ## Examples
35
+
36
+ List Microsoft OneNote pages for the currently logged in user
37
+
38
+ ```sh
39
+ m365 onenote page list
40
+ ```
41
+
42
+ List Microsoft OneNote pages in a specific group specified by id
43
+
44
+ ```sh
45
+ m365 onenote page list --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
46
+ ```
47
+
48
+ List Microsoft OneNote pages in a specific group specified by name
49
+
50
+ ```sh
51
+ m365 onenote page list --groupName "MyGroup"
52
+ ```
53
+
54
+ List Microsoft OneNote pages for a specific user specified by name
55
+
56
+ ```sh
57
+ m365 onenote page list --userName user1@contoso.onmicrosoft.com
58
+ ```
59
+
60
+ List Microsoft OneNote pages for a specific user specified by id
61
+
62
+ ```sh
63
+ m365 onenote page list --userId 2609af39-7775-4f94-a3dc-0dd67657e900
64
+ ```
65
+
66
+ List Microsoft OneNote pages for a specific site
67
+
68
+ ```sh
69
+ m365 onenote page list --webUrl https://contoso.sharepoint.com/sites/testsite
70
+ ```
71
+
72
+ ## Response
73
+
74
+ === "JSON"
75
+
76
+ ```json
77
+ [
78
+ {
79
+ "id": "1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
80
+ "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
81
+ "createdDateTime": "2023-01-07T10:57:15Z",
82
+ "title": "Page B",
83
+ "createdByAppId": "",
84
+ "contentUrl": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content",
85
+ "lastModifiedDateTime": "2023-01-07T10:57:17Z",
86
+ "links": {
87
+ "oneNoteClientUrl": {
88
+ "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B&section-id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end"
89
+ },
90
+ "oneNoteWebUrl": {
91
+ "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"
92
+ }
93
+ },
94
+ "parentSection": {
95
+ "id": "1-3eb21088-b613-4698-98df-92a7d34e0678",
96
+ "displayName": "Test",
97
+ "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"
98
+ }
99
+ }
100
+ ]
101
+ ```
102
+
103
+ === "Text"
104
+
105
+ ```text
106
+ createdDateTime title id
107
+ -------------------- ------ --------------------------------------------------------------------------
108
+ 2023-01-07T10:57:15Z Page B 1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
109
+ ```
110
+
111
+ === "CSV"
112
+
113
+ ```csv
114
+ createdDateTime,title,id
115
+ 2023-01-07T10:57:15Z,Page B,1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
116
+ ```
117
+
118
+ === "Markdown"
119
+
120
+ ```md
121
+ # onenote page list --userName "mathijs@mathijsdev2.onmicrosoft.com"
122
+
123
+ Date: 07/01/2023
124
+
125
+ ## Page A (1-a26aaec43ed348bd82edf4eb44e73d6c!14-3eb21088-b613-4698-98df-92a7d34e0678)
126
+
127
+ ## Page B (1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678)
128
+
129
+ Property | Value
130
+ ---------|-------
131
+ id | 1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
132
+ self | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
133
+ createdDateTime | 2023-01-07T10:57:15Z
134
+ title | Page B
135
+ createdByAppId |
136
+ contentUrl | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content
137
+ lastModifiedDateTime | 2023-01-07T10:57:17Z
138
+ links | { "oneNoteClientUrl": { "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B& -id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end" }, "oneNoteWebUrl": { "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"}}
139
+ parentSection | {"id":"1-3eb21088-b613-4698-98df-92a7d34e0678","displayName":"Test","self":"https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"}
140
+ ```
@@ -72,3 +72,20 @@ m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan"
72
72
  id,name,planId,orderHint
73
73
  ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
74
74
  ```
75
+
76
+ === "Markdown"
77
+
78
+ ```md
79
+ # planner bucket add --name "My Planner Bucket" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
80
+
81
+ Date: 27/12/2022
82
+
83
+ ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
84
+
85
+ Property | Value
86
+ ---------|-------
87
+ name | My Planner Bucket
88
+ planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
89
+ orderHint | 8585363889524958496
90
+ id | ttEB_Uj690STdR3GC1MIDZgANq1U
91
+ ```
@@ -84,3 +84,20 @@ m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerG
84
84
  id,name,planId,orderHint
85
85
  ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
86
86
  ```
87
+
88
+ === "Markdown"
89
+
90
+ ```md
91
+ # planner bucket get --id "ttEB_Uj690STdR3GC1MIDZgANq1U"
92
+
93
+ Date: 27/12/2022
94
+
95
+ ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
96
+
97
+ Property | Value
98
+ ---------|-------
99
+ name | My Planner Bucket
100
+ planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
101
+ orderHint | 8585363889524958496
102
+ id | ttEB_Uj690STdR3GC1MIDZgANq1U
103
+ ```
@@ -67,3 +67,20 @@ m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
67
67
  id,name,planId,orderHint
68
68
  ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
69
69
  ```
70
+
71
+ === "Markdown"
72
+
73
+ ```md
74
+ # planner bucket list --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
75
+
76
+ Date: 27/12/2022
77
+
78
+ ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
79
+
80
+ Property | Value
81
+ ---------|-------
82
+ name | My Planner Bucket
83
+ planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
84
+ orderHint | 8585363889524958496
85
+ id | ttEB_Uj690STdR3GC1MIDZgANq1U
86
+ ```