@pnp/cli-microsoft365 6.8.0-beta.e41be56 → 6.8.0-beta.f473be5

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 (71) hide show
  1. package/.mocharc.json +1 -0
  2. package/dist/m365/planner/commands/roster/roster-plan-list.js +102 -0
  3. package/dist/m365/planner/commands.js +1 -0
  4. package/dist/m365/spo/commands/file/file-checkin.js +8 -3
  5. package/dist/m365/spo/commands/file/file-checkout.js +8 -3
  6. package/dist/m365/spo/commands/file/file-copy.js +4 -4
  7. package/dist/m365/spo/commands/file/file-get.js +3 -1
  8. package/dist/m365/spo/commands/file/file-list.js +2 -2
  9. package/dist/m365/spo/commands/file/file-move.js +6 -7
  10. package/dist/m365/spo/commands/file/file-remove.js +3 -12
  11. package/dist/m365/spo/commands/file/file-rename.js +3 -3
  12. package/dist/m365/spo/commands/file/file-roleassignment-add.js +2 -1
  13. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +3 -3
  14. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +2 -1
  15. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +2 -1
  16. package/dist/m365/spo/commands/file/file-sharinginfo-get.js +4 -2
  17. package/dist/m365/spo/commands/file/file-version-clear.js +3 -1
  18. package/dist/m365/spo/commands/file/file-version-get.js +3 -1
  19. package/dist/m365/spo/commands/file/file-version-remove.js +3 -1
  20. package/dist/m365/spo/commands/file/file-version-restore.js +3 -1
  21. package/dist/m365/spo/commands/folder/folder-copy.js +4 -4
  22. package/dist/m365/spo/commands/folder/folder-get.js +5 -2
  23. package/dist/m365/spo/commands/folder/folder-move.js +3 -2
  24. package/dist/m365/spo/commands/folder/folder-rename.js +5 -2
  25. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-list.js +46 -1
  26. package/dist/m365/spo/commands/tenant/tenant-settings-set.js +4 -0
  27. package/dist/m365/teams/commands/meeting/meeting-transcript-list.js +124 -0
  28. package/dist/m365/teams/commands.js +1 -0
  29. package/dist/utils/spo.js +1 -1
  30. package/docs/docs/cmd/planner/roster/roster-plan-list.md +109 -0
  31. package/docs/docs/cmd/spo/feature/feature-enable.md +2 -2
  32. package/docs/docs/cmd/spo/file/file-add.md +1 -1
  33. package/docs/docs/cmd/spo/file/file-checkin.md +1 -1
  34. package/docs/docs/cmd/spo/file/file-checkout.md +1 -1
  35. package/docs/docs/cmd/spo/file/file-copy.md +1 -1
  36. package/docs/docs/cmd/spo/file/file-get.md +1 -1
  37. package/docs/docs/cmd/spo/file/file-move.md +3 -3
  38. package/docs/docs/cmd/spo/file/file-rename.md +1 -1
  39. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md +3 -3
  40. package/docs/docs/cmd/spo/file/file-retentionlabel-remove.md +2 -2
  41. package/docs/docs/cmd/spo/file/file-roleassignment-add.md +1 -1
  42. package/docs/docs/cmd/spo/file/file-roleassignment-remove.md +1 -1
  43. package/docs/docs/cmd/spo/file/file-roleinheritance-break.md +1 -1
  44. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.md +1 -1
  45. package/docs/docs/cmd/spo/file/file-sharinginfo-get.md +1 -1
  46. package/docs/docs/cmd/spo/file/file-sharinglink-add.md +1 -1
  47. package/docs/docs/cmd/spo/file/file-sharinglink-clear.md +1 -1
  48. package/docs/docs/cmd/spo/file/file-sharinglink-get.md +1 -1
  49. package/docs/docs/cmd/spo/file/file-sharinglink-list.md +1 -1
  50. package/docs/docs/cmd/spo/file/file-sharinglink-remove.md +1 -1
  51. package/docs/docs/cmd/spo/file/file-sharinglink-set.md +1 -1
  52. package/docs/docs/cmd/spo/file/file-version-clear.md +2 -2
  53. package/docs/docs/cmd/spo/file/file-version-get.md +1 -1
  54. package/docs/docs/cmd/spo/file/file-version-list.md +1 -1
  55. package/docs/docs/cmd/spo/file/file-version-remove.md +1 -1
  56. package/docs/docs/cmd/spo/file/file-version-restore.md +1 -1
  57. package/docs/docs/cmd/spo/folder/folder-add.md +9 -3
  58. package/docs/docs/cmd/spo/folder/folder-copy.md +1 -1
  59. package/docs/docs/cmd/spo/folder/folder-get.md +7 -7
  60. package/docs/docs/cmd/spo/folder/folder-list.md +11 -11
  61. package/docs/docs/cmd/spo/folder/folder-move.md +1 -1
  62. package/docs/docs/cmd/spo/folder/folder-remove.md +7 -7
  63. package/docs/docs/cmd/spo/folder/folder-rename.md +11 -5
  64. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.md +3 -3
  65. package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.md +1 -1
  66. package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md +1 -1
  67. package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md +4 -4
  68. package/docs/docs/cmd/spo/tenant/tenant-settings-set.md +57 -54
  69. package/docs/docs/cmd/teams/meeting/meeting-transcript-list.md +96 -0
  70. package/npm-shrinkwrap.json +267 -334
  71. package/package.json +13 -12
@@ -46,8 +46,21 @@ class SpoServicePrincipalPermissionRequestListCommand extends SpoCommand_1.defau
46
46
  throw response.ErrorInfo.ErrorMessage;
47
47
  }
48
48
  else {
49
+ let spoWebAppServicePrincipalPermissionRequestResult = [];
49
50
  const result = json[json.length - 1]._Child_Items_;
50
- logger.log(result.map(r => {
51
+ if (result.length > 0) {
52
+ const spoClientExtensibilityWebApplicationPrincipalId = yield this.getSPOClientExtensibilityWebApplicationPrincipalId();
53
+ if (spoClientExtensibilityWebApplicationPrincipalId !== null) {
54
+ const oAuth2PermissionGrants = yield this.getOAuth2PermissionGrants(spoClientExtensibilityWebApplicationPrincipalId);
55
+ if (oAuth2PermissionGrants) {
56
+ spoWebAppServicePrincipalPermissionRequestResult = result.filter(x => oAuth2PermissionGrants.indexOf(x.Scope) === -1);
57
+ }
58
+ }
59
+ }
60
+ if (spoWebAppServicePrincipalPermissionRequestResult.length === 0) {
61
+ spoWebAppServicePrincipalPermissionRequestResult = result;
62
+ }
63
+ logger.log(spoWebAppServicePrincipalPermissionRequestResult.map(r => {
51
64
  return {
52
65
  Id: r.Id.replace('/Guid(', '').replace(')/', ''),
53
66
  Resource: r.Resource,
@@ -62,6 +75,38 @@ class SpoServicePrincipalPermissionRequestListCommand extends SpoCommand_1.defau
62
75
  }
63
76
  });
64
77
  }
78
+ getOAuth2PermissionGrants(spoClientExtensibilityWebApplicationPrincipalId) {
79
+ return __awaiter(this, void 0, void 0, function* () {
80
+ const requestOptions = {
81
+ url: `https://graph.microsoft.com/v1.0/oAuth2Permissiongrants/?$filter=clientId eq '${spoClientExtensibilityWebApplicationPrincipalId}' and consentType eq 'AllPrincipals'`,
82
+ headers: {
83
+ accept: 'application/json;odata.metadata=none'
84
+ },
85
+ responseType: 'json'
86
+ };
87
+ const response = yield request_1.default.get(requestOptions);
88
+ if (response.value && response.value.length > 0) {
89
+ return response.value[0].scope.split(' ');
90
+ }
91
+ return null;
92
+ });
93
+ }
94
+ getSPOClientExtensibilityWebApplicationPrincipalId() {
95
+ return __awaiter(this, void 0, void 0, function* () {
96
+ const requestOptions = {
97
+ url: `https://graph.microsoft.com/v1.0/servicePrincipals/?$filter=displayName eq 'SharePoint Online Client Extensibility Web Application Principal'`,
98
+ headers: {
99
+ accept: 'application/json;odata.metadata=none'
100
+ },
101
+ responseType: 'json'
102
+ };
103
+ const response = yield request_1.default.get(requestOptions);
104
+ if (response.value && response.value.length > 0) {
105
+ return response.value[0].id;
106
+ }
107
+ return null;
108
+ });
109
+ }
65
110
  }
66
111
  module.exports = new SpoServicePrincipalPermissionRequestListCommand();
67
112
  //# sourceMappingURL=serviceprincipal-permissionrequest-list.js.map
@@ -418,6 +418,9 @@ _SpoTenantSettingsSetCommand_instances = new WeakSet(), _SpoTenantSettingsSetCom
418
418
  }, {
419
419
  option: '--DisableCustomAppAuthentication [DisableCustomAppAuthentication]',
420
420
  autocomplete: ['true', 'false']
421
+ }, {
422
+ option: '--CommentsOnListItemsDisabled [CommentsOnListItemsDisabled]',
423
+ autocomplete: ['true', 'false']
421
424
  }, {
422
425
  option: '--EnableAzureADB2BIntegration [EnableAzureADB2BIntegration]',
423
426
  autocomplete: ['true', 'false']
@@ -504,6 +507,7 @@ SpoTenantSettingsSetCommand.booleanOptions = [
504
507
  'ShowNGSCDialogForSyncOnODB',
505
508
  'SyncPrivacyProfileProperties',
506
509
  'DisableCustomAppAuthentication',
510
+ 'CommentsOnListItemsDisabled',
507
511
  'EnableAzureADB2BIntegration',
508
512
  'SyncAadB2BManagementPolicy'
509
513
  ];
@@ -0,0 +1,124 @@
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 _TeamsMeetingTranscriptListCommand_instances, _TeamsMeetingTranscriptListCommand_initTelemetry, _TeamsMeetingTranscriptListCommand_initOptions, _TeamsMeetingTranscriptListCommand_initValidators, _TeamsMeetingTranscriptListCommand_initOptionSets;
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ const Auth_1 = require("../../../../Auth");
19
+ const GraphCommand_1 = require("../../../base/GraphCommand");
20
+ const commands_1 = require("../../commands");
21
+ const odata_1 = require("../../../../utils/odata");
22
+ const validation_1 = require("../../../../utils/validation");
23
+ const accessToken_1 = require("../../../../utils/accessToken");
24
+ const aadUser_1 = require("../../../../utils/aadUser");
25
+ class TeamsMeetingTranscriptListCommand extends GraphCommand_1.default {
26
+ get name() {
27
+ return commands_1.default.MEETING_TRANSCRIPT_LIST;
28
+ }
29
+ get description() {
30
+ return 'Lists all transcripts for a given meeting';
31
+ }
32
+ defaultProperties() {
33
+ return ['id', 'createdDateTime'];
34
+ }
35
+ constructor() {
36
+ super();
37
+ _TeamsMeetingTranscriptListCommand_instances.add(this);
38
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initTelemetry).call(this);
39
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptions).call(this);
40
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initValidators).call(this);
41
+ __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptionSets).call(this);
42
+ }
43
+ commandAction(logger, args) {
44
+ return __awaiter(this, void 0, void 0, function* () {
45
+ try {
46
+ const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
47
+ if (this.verbose) {
48
+ logger.logToStderr(`Retrieving transcript list for the given meeting...`);
49
+ }
50
+ let requestUrl = `${this.resource}/beta/`;
51
+ if (isAppOnlyAccessToken) {
52
+ if (!args.options.userId && !args.options.userName && !args.options.email) {
53
+ throw `The option 'userId', 'userName' or 'email' is required when retrieving meeting transcripts list using app only permissions`;
54
+ }
55
+ requestUrl += 'users/';
56
+ if (args.options.userId) {
57
+ requestUrl += args.options.userId;
58
+ }
59
+ else if (args.options.userName) {
60
+ requestUrl += args.options.userName;
61
+ }
62
+ else if (args.options.email) {
63
+ if (this.verbose) {
64
+ logger.logToStderr(`Getting user ID for user with email '${args.options.email}'.`);
65
+ }
66
+ const userId = yield aadUser_1.aadUser.getUserIdByEmail(args.options.email);
67
+ requestUrl += userId;
68
+ }
69
+ }
70
+ else {
71
+ if (args.options.userId || args.options.userName || args.options.email) {
72
+ throw `The options 'userId', 'userName' and 'email' cannot be used while retrieving meeting transcripts using delegated permissions`;
73
+ }
74
+ requestUrl += `me`;
75
+ }
76
+ requestUrl += `/onlineMeetings/${args.options.meetingId}/transcripts`;
77
+ const res = yield odata_1.odata.getAllItems(requestUrl);
78
+ logger.log(res);
79
+ }
80
+ catch (err) {
81
+ this.handleRejectedODataJsonPromise(err);
82
+ }
83
+ });
84
+ }
85
+ }
86
+ _TeamsMeetingTranscriptListCommand_instances = new WeakSet(), _TeamsMeetingTranscriptListCommand_initTelemetry = function _TeamsMeetingTranscriptListCommand_initTelemetry() {
87
+ this.telemetry.push((args) => {
88
+ Object.assign(this.telemetryProperties, {
89
+ userId: typeof args.options.userId !== 'undefined',
90
+ userName: typeof args.options.userName !== 'undefined',
91
+ email: typeof args.options.email !== 'undefined'
92
+ });
93
+ });
94
+ }, _TeamsMeetingTranscriptListCommand_initOptions = function _TeamsMeetingTranscriptListCommand_initOptions() {
95
+ this.options.unshift({
96
+ option: '-u, --userId [userId]'
97
+ }, {
98
+ option: '-n, --userName [userName]'
99
+ }, {
100
+ option: '--email [email]'
101
+ }, {
102
+ option: '-m, --meetingId <meetingId>'
103
+ });
104
+ }, _TeamsMeetingTranscriptListCommand_initValidators = function _TeamsMeetingTranscriptListCommand_initValidators() {
105
+ this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
106
+ if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
107
+ return `${args.options.userId} is not a valid Guid`;
108
+ }
109
+ if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
110
+ return `${args.options.userName} is not a valid user principal name (UPN)`;
111
+ }
112
+ if (args.options.email && !validation_1.validation.isValidUserPrincipalName(args.options.email)) {
113
+ return `${args.options.email} is not a valid email`;
114
+ }
115
+ return true;
116
+ }));
117
+ }, _TeamsMeetingTranscriptListCommand_initOptionSets = function _TeamsMeetingTranscriptListCommand_initOptionSets() {
118
+ this.optionSets.push({
119
+ options: ['userId', 'userName', 'email'],
120
+ runsWhen: (args) => args.options.userId || args.options.userName || args.options.email
121
+ });
122
+ };
123
+ module.exports = new TeamsMeetingTranscriptListCommand();
124
+ //# sourceMappingURL=meeting-transcript-list.js.map
@@ -30,6 +30,7 @@ exports.default = {
30
30
  MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
31
31
  MEETING_GET: `${prefix} meeting get`,
32
32
  MEETING_LIST: `${prefix} meeting list`,
33
+ MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
33
34
  MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
34
35
  MEMBERSETTINGS_SET: `${prefix} membersettings set`,
35
36
  MESSAGE_GET: `${prefix} message get`,
package/dist/utils/spo.js CHANGED
@@ -453,7 +453,7 @@ exports.spo = {
453
453
  * Retrieves the SiteId, VroomItemId and VroomDriveId from a specific file.
454
454
  * @param webUrl Web url
455
455
  * @param fileId GUID ID of the file
456
- * @param fileUrl Decoded URL of the file
456
+ * @param fileUrl Decoded site-relative or server-relative URL of the file
457
457
  */
458
458
  getVroomFileDetails(webUrl, fileId, fileUrl) {
459
459
  return __awaiter(this, void 0, void 0, function* () {
@@ -0,0 +1,109 @@
1
+ # planner roster plan list
2
+
3
+ Lists all Microsoft Planner Roster plans for a specific user
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 planner roster plan list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--userId [userId]`
14
+ : User's Azure AD ID. Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
15
+
16
+ `--userName [userName]`
17
+ : User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
18
+
19
+ --8<-- "docs/cmd/_global.md"
20
+
21
+ ## Remarks
22
+
23
+ !!! attention
24
+ This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
25
+
26
+ ## Examples
27
+
28
+ List all Planner plans contained in a Roster where the current logged in user is member of.
29
+
30
+ ```sh
31
+ m365 planner roster plan list
32
+ ```
33
+
34
+ List all Planner plans contained in a Roster where specific user is member of by its UPN.
35
+
36
+ ```sh
37
+ m365 planner roster plan list --userName john.doe@contoso.com
38
+ ```
39
+
40
+ List all Planner plans contained in a Roster where specific user is member of by its Id.
41
+
42
+ ```sh
43
+ m365 planner roster plan list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
44
+ ```
45
+
46
+ ## Response
47
+
48
+ === "JSON"
49
+
50
+ ```json
51
+ [
52
+ {
53
+ "createdDateTime": "2023-04-06T14:41:49.8676617Z",
54
+ "owner": "59f80e08-24b1-41f8-8586-16765fd830d3",
55
+ "title": "My Planner Plan",
56
+ "creationSource": null,
57
+ "id": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
58
+ "createdBy": {
59
+ "user": {
60
+ "displayName": null,
61
+ "id": "59f80e08-24b1-41f8-8586-16765fd830d3"
62
+ },
63
+ "application": {
64
+ "displayName": null,
65
+ "id": "31359c7f-bd7e-475c-86db-fdb8c937548e"
66
+ }
67
+ },
68
+ "container": {
69
+ "containerId": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
70
+ "type": "unknownFutureValue",
71
+ "url": "https://graph.microsoft.com/beta/planner/rosters/_5GY9MJpZU2vb3DC46CP3MkACr8m"
72
+ },
73
+ "contexts": {},
74
+ "sharedWithContainers": []
75
+ }
76
+ ]
77
+ ```
78
+
79
+ === "Text"
80
+
81
+ ```text
82
+ id title createdDateTime owner
83
+ ---------------------------- --------------- ---------------------------- ------------------------------------
84
+ _5GY9MJpZU2vb3DC46CP3MkACr8m My Planner Plan 2023-04-06T14:41:49.8676617Z 59f80e08-24b1-41f8-8586-16765fd830d3
85
+ ```
86
+
87
+ === "CSV"
88
+
89
+ ```csv
90
+ createdDateTime,owner,title,id
91
+ 2023-04-06T14:41:49.8676617Z,59f80e08-24b1-41f8-8586-16765fd830d3,My Planner Plan,_5GY9MJpZU2vb3DC46CP3MkACr8m
92
+ ```
93
+
94
+ === "Markdown"
95
+
96
+ ```md
97
+ # planner roster plan list --userId "59f80e08-24b1-41f8-8586-16765fd830d3"
98
+
99
+ Date: 4/8/2023
100
+
101
+ ## My Planner Plan (_5GY9MJpZU2vb3DC46CP3MkACr8m)
102
+
103
+ Property | Value
104
+ ---------|-------
105
+ createdDateTime | 2023-04-06T14:41:49.8676617Z
106
+ owner | 59f80e08-24b1-41f8-8586-16765fd830d3
107
+ title | My Planner Plan
108
+ id | \_5GY9MJpZU2vb3DC46CP3MkACr8m
109
+ ```
@@ -33,11 +33,11 @@ If the specified url doesn't refer to an existing site collection, you will get
33
33
  Enable site feature
34
34
 
35
35
  ```sh
36
- m365 spo feature enable --url https://contoso.sharepoint.com/sites/sales --featureId 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
36
+ m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
37
37
  ```
38
38
 
39
39
  Enable web feature (with force to overwrite feature with same id)
40
40
 
41
41
  ```sh
42
- m365 spo feature enable --url https://contoso.sharepoint.com/sites/sales --featureId 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
42
+ m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
43
43
  ```
@@ -14,7 +14,7 @@ m365 spo file add [options]
14
14
  : The URL of the site where the file should be uploaded to
15
15
 
16
16
  `-f, --folder <folder>`
17
- : Site-relative or server-relative URL to the folder where the file should be uploaded
17
+ : The server- or site-relative URL to the folder where the file should be uploaded
18
18
 
19
19
  `-p, --path <path>`
20
20
  : Local path to the file to upload
@@ -14,7 +14,7 @@ m365 spo file checkin [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-f, --url [url]`
17
- : The server-relative URL of the file to retrieve. Specify either `url` or `id` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
18
18
 
19
19
  `-i, --id [id]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -14,7 +14,7 @@ m365 spo file checkout [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-f, --url [url]`
17
- : The server-relative URL of the file to retrieve. Specify either `url` or `id` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
18
18
 
19
19
  `-i, --id [id]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -14,7 +14,7 @@ m365 spo file copy [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Server-relative or absolute URL of the file.
17
+ : Site-relative, server-relative or absolute URL of the file.
18
18
 
19
19
  `-t, --targetUrl <targetUrl>`
20
20
  : Server-relative or absolute URL of the location.
@@ -14,7 +14,7 @@ m365 spo file get [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --url [url]`
17
- : The server-relative URL of the file to retrieve. Specify either `url` or `id` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
18
18
 
19
19
  `-i, --id [id]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -14,7 +14,7 @@ m365 spo file move [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the file to move
17
+ : The server- or site-relative URL of the file to move
18
18
 
19
19
  `-t, --targetUrl <targetUrl>`
20
20
  : Server-relative URL where to move the file
@@ -36,7 +36,7 @@ When you move a file using the `spo file move` command, all of the versions are
36
36
  Move file to a document library in another site collection
37
37
 
38
38
  ```sh
39
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
39
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
40
40
  ```
41
41
 
42
42
  Move file to a document library in the same site collection
@@ -54,7 +54,7 @@ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceU
54
54
  Move file to a document library in another site collection. Allow for schema mismatch
55
55
 
56
56
  ```sh
57
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
57
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
58
58
  ```
59
59
 
60
60
 
@@ -14,7 +14,7 @@ m365 spo file rename [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the file to rename
17
+ : The server- or site-relative URL of the file to rename
18
18
 
19
19
  `-t, --targetFileName <targetFileName>`
20
20
  : New file name of the file
@@ -11,10 +11,10 @@ m365 spo file retentionlabel ensure [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site where the retentionlabel from a file to apply is located
14
+ : URL of the site where the retention label from a file to apply is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The site- or server relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
17
+ : The site- or server-relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
@@ -29,7 +29,7 @@ m365 spo file retentionlabel ensure [options]
29
29
 
30
30
  ## Remarks
31
31
 
32
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
32
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retention label from a listitem.
33
33
 
34
34
  The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
35
35
 
@@ -11,10 +11,10 @@ m365 spo file retentionlabel remove [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site where the retentionlabel from a file to remove is located
14
+ : URL of the site where the retention label from a file to remove is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The site- or server relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleassignment add [options]
14
14
  : URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleassignment remove [options]
14
14
  : URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleinheritance break [options]
14
14
  : URL of the site where the file is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file roleinheritance reset [options]
14
14
  : URL of the site where the file is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file sharinginfo get [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-f, --fileUrl [fileUrl]`
17
- : The server-relative URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file sharinglink add [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink clear [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink get [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink list [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink remove [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink set [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,10 +14,10 @@ m365 spo file version clear [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
- : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `--confirm [confirm]`
23
23
  : Don't prompt for confirmation.
@@ -17,7 +17,7 @@ m365 spo file version get [options]
17
17
  : Label of version which will be retrieved
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file version list [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --fileUrl [fileUrl]`
17
- : The site-relative or server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
@@ -17,7 +17,7 @@ m365 spo file version remove [options]
17
17
  : Label of version which will be removed
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -17,7 +17,7 @@ m365 spo file version restore [options]
17
17
  : Label of version which will be restored
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both