@pnp/cli-microsoft365 12.0.0-beta.d654135 → 12.0.0-beta.e3af9f8
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.
- package/.devproxy/generate-openapi-spec.json +1 -1
- package/allCommands.json +1 -1
- package/allCommandsFull.json +1 -1
- package/dist/Auth.js +19 -2
- package/dist/cli/cli.js +3 -0
- package/dist/googleAnalytics.js +96 -0
- package/dist/m365/cli/commands/cli-consent.js +9 -2
- package/dist/m365/entra/commands/m365group/m365group-add.js +52 -97
- package/dist/m365/entra/commands/m365group/m365group-conversation-list.js +20 -33
- package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +20 -39
- package/dist/m365/entra/commands/m365group/m365group-get.js +20 -41
- package/dist/m365/entra/commands/m365group/m365group-list.js +11 -31
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-clear.js +8 -22
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +9 -25
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-remove.js +21 -43
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-restore.js +21 -41
- package/dist/m365/entra/commands/m365group/m365group-remove.js +25 -46
- package/dist/m365/entra/commands/m365group/m365group-renew.js +19 -32
- package/dist/m365/entra/commands/m365group/m365group-set.js +86 -141
- package/dist/m365/entra/commands/m365group/m365group-teamify.js +20 -43
- package/dist/m365/entra/commands/m365group/m365group-user-add.js +44 -77
- package/dist/m365/entra/commands/m365group/m365group-user-list.js +28 -55
- package/dist/m365/entra/commands/m365group/m365group-user-remove.js +37 -74
- package/dist/m365/entra/commands/m365group/m365group-user-set.js +45 -77
- package/dist/m365/spe/commands/container/container-permission-remove.js +94 -0
- package/dist/m365/spe/commands.js +1 -0
- package/dist/m365/spfx/commands/SpfxCompatibilityMatrix.js +15 -0
- package/dist/m365/spfx/commands/project/project-doctor/doctor-1.24.0.js +19 -0
- package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
- package/dist/m365/spfx/commands/project/project-upgrade/rules/FN012021_TSC_excludeDirectories.js +43 -0
- package/dist/m365/spfx/commands/project/project-upgrade/rules/FN027002_OVERRIDES_qs.js +33 -0
- package/dist/m365/spfx/commands/project/project-upgrade/rules/FN027003_OVERRIDES_uuid.js +33 -0
- package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.24.0.js +77 -0
- package/dist/m365/spfx/commands/project/project-upgrade.js +2 -1
- package/dist/m365/spo/commands/app/app-add.js +35 -56
- package/dist/m365/spo/commands/app/app-deploy.js +41 -59
- package/dist/m365/spo/commands/app/app-get.js +40 -56
- package/dist/m365/spo/commands/app/app-install.js +20 -41
- package/dist/m365/spo/commands/app/app-instance-list.js +12 -24
- package/dist/m365/spo/commands/app/app-list.js +26 -44
- package/dist/m365/spo/commands/app/app-remove.js +32 -52
- package/dist/m365/spo/commands/app/app-retract.js +32 -51
- package/dist/m365/spo/commands/app/app-teamspackage-download.js +35 -54
- package/dist/m365/spo/commands/app/app-uninstall.js +21 -44
- package/dist/m365/spo/commands/app/app-upgrade.js +20 -41
- package/dist/m365/spo/commands/commandset/commandset-add.js +17 -59
- package/dist/m365/spo/commands/commandset/commandset-get.js +24 -62
- package/dist/m365/spo/commands/commandset/commandset-list.js +11 -34
- package/dist/m365/spo/commands/commandset/commandset-remove.js +21 -54
- package/dist/m365/spo/commands/commandset/commandset-set.js +30 -83
- package/dist/m365/spo/commands/feature/feature-disable.js +20 -50
- package/dist/m365/spo/commands/feature/feature-enable.js +22 -50
- package/dist/m365/spo/commands/feature/feature-list.js +11 -36
- package/dist/m365/spo/commands/field/field-add.js +33 -62
- package/dist/m365/spo/commands/field/field-get.js +30 -57
- package/dist/m365/spo/commands/field/field-list.js +21 -46
- package/dist/m365/spo/commands/field/field-remove.js +32 -63
- package/dist/m365/spo/commands/field/field-set.js +34 -66
- package/dist/m365/spo/commands/file/file-get.js +4 -3
- package/dist/m365/spo/commands/folder/folder-unarchive.js +90 -0
- package/dist/m365/spo/commands/hubsite/hubsite-connect.js +38 -63
- package/dist/m365/spo/commands/hubsite/hubsite-data-get.js +11 -27
- package/dist/m365/spo/commands/hubsite/hubsite-disconnect.js +25 -47
- package/dist/m365/spo/commands/hubsite/hubsite-get.js +25 -37
- package/dist/m365/spo/commands/hubsite/hubsite-list.js +12 -24
- package/dist/m365/spo/commands/hubsite/hubsite-register.js +10 -18
- package/dist/m365/spo/commands/hubsite/hubsite-rights-grant.js +14 -32
- package/dist/m365/spo/commands/hubsite/hubsite-rights-revoke.js +12 -29
- package/dist/m365/spo/commands/hubsite/hubsite-set.js +19 -46
- package/dist/m365/spo/commands/hubsite/hubsite-unregister.js +11 -27
- package/dist/m365/spo/commands/listitem/listitem-add.js +27 -55
- package/dist/m365/spo/commands/listitem/listitem-attachment-add.js +30 -58
- package/dist/m365/spo/commands/listitem/listitem-attachment-get.js +27 -52
- package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +26 -50
- package/dist/m365/spo/commands/listitem/listitem-attachment-remove.js +28 -55
- package/dist/m365/spo/commands/listitem/listitem-attachment-set.js +30 -57
- package/dist/m365/spo/commands/listitem/listitem-batch-add.js +36 -58
- package/dist/m365/spo/commands/listitem/listitem-batch-remove.js +68 -92
- package/dist/m365/spo/commands/listitem/listitem-batch-set.js +37 -57
- package/dist/m365/spo/commands/listitem/listitem-get.js +45 -79
- package/dist/m365/spo/commands/listitem/listitem-isrecord.js +31 -55
- package/dist/m365/spo/commands/listitem/listitem-list.js +47 -81
- package/dist/m365/spo/commands/listitem/listitem-record-declare.js +37 -60
- package/dist/m365/spo/commands/listitem/listitem-record-lock.js +30 -52
- package/dist/m365/spo/commands/listitem/listitem-record-undeclare.js +31 -52
- package/dist/m365/spo/commands/listitem/listitem-record-unlock.js +30 -52
- package/dist/m365/spo/commands/listitem/listitem-remove.js +33 -61
- package/dist/m365/spo/commands/listitem/listitem-retentionlabel-ensure.js +46 -67
- package/dist/m365/spo/commands/listitem/listitem-retentionlabel-remove.js +33 -56
- package/dist/m365/spo/commands/listitem/listitem-roleassignment-add.js +55 -98
- package/dist/m365/spo/commands/listitem/listitem-roleassignment-remove.js +48 -74
- package/dist/m365/spo/commands/listitem/listitem-roleinheritance-break.js +33 -56
- package/dist/m365/spo/commands/listitem/listitem-roleinheritance-reset.js +31 -53
- package/dist/m365/spo/commands/listitem/listitem-set.js +33 -58
- package/dist/m365/spo/commands/navigation/navigation-node-add.js +74 -120
- package/dist/m365/spo/commands/navigation/navigation-node-get.js +4 -13
- package/dist/m365/spo/commands/navigation/navigation-node-set.js +53 -114
- package/dist/m365/spo/commands/page/page-unpublish.js +53 -0
- package/dist/m365/spo/commands/sitescript/sitescript-add.js +22 -37
- package/dist/m365/spo/commands/sitescript/sitescript-get.js +9 -26
- package/dist/m365/spo/commands/sitescript/sitescript-list.js +5 -0
- package/dist/m365/spo/commands/sitescript/sitescript-remove.js +9 -33
- package/dist/m365/spo/commands/sitescript/sitescript-set.js +29 -56
- package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-add.js +8 -1
- package/dist/m365/spo/commands/tenant/tenant-commandset-add.js +8 -1
- package/dist/m365/spo/commands.js +3 -1
- package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +5 -0
- package/dist/m365/spp/commands/model/model-get.js +25 -45
- package/dist/m365/spp/commands/model/model-list.js +12 -23
- package/dist/m365/spp/commands/model/model-remove.js +25 -45
- package/dist/m365/teams/commands/channel/channel-add.js +46 -57
- package/dist/m365/teams/commands/channel/channel-get.js +41 -48
- package/dist/m365/teams/commands/channel/channel-list.js +28 -42
- package/dist/m365/teams/commands/channel/channel-member-add.js +53 -54
- package/dist/m365/teams/commands/channel/channel-member-list.js +47 -55
- package/dist/m365/teams/commands/channel/channel-member-remove.js +62 -62
- package/dist/m365/teams/commands/channel/channel-member-set.js +61 -65
- package/dist/m365/teams/commands/channel/channel-remove.js +47 -49
- package/dist/m365/teams/commands/channel/channel-set.js +47 -54
- package/dist/m365/teams/commands/chat/chat-get.js +30 -45
- package/dist/m365/teams/commands/chat/chat-list.js +22 -42
- package/dist/m365/teams/commands/chat/chat-member-add.js +43 -64
- package/dist/m365/teams/commands/chat/chat-member-list.js +10 -23
- package/dist/m365/teams/commands/chat/chat-member-remove.js +28 -50
- package/dist/m365/teams/commands/chat/chat-message-send.js +32 -55
- package/dist/m365/teams/commands/meeting/meeting-add.js +57 -68
- package/dist/m365/teams/commands/meeting/meeting-attendancereport-get.js +33 -58
- package/dist/m365/teams/commands/meeting/meeting-attendancereport-list.js +14 -38
- package/dist/m365/teams/commands/meeting/meeting-get.js +14 -38
- package/dist/m365/teams/commands/meeting/meeting-list.js +34 -59
- package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +34 -58
- package/dist/m365/teams/commands/meeting/meeting-transcript-list.js +29 -50
- package/dist/m365/teams/commands/message/message-get.js +19 -30
- package/dist/m365/teams/commands/message/message-list.js +26 -43
- package/dist/m365/teams/commands/message/message-remove.js +43 -58
- package/dist/m365/teams/commands/message/message-reply-list.js +19 -30
- package/dist/m365/teams/commands/message/message-restore.js +40 -50
- package/dist/m365/teams/commands/message/message-send.js +19 -30
- package/dist/m365/teams/commands/report/report-deviceusagedistributionusercounts.js +10 -0
- package/dist/m365/teams/commands/report/report-deviceusageusercounts.js +10 -0
- package/dist/m365/teams/commands/report/report-deviceusageuserdetail.js +22 -0
- package/dist/m365/teams/commands/report/report-directroutingcalls.js +19 -39
- package/dist/m365/teams/commands/report/report-pstncalls.js +19 -39
- package/dist/m365/teams/commands/report/report-useractivitycounts.js +10 -0
- package/dist/m365/teams/commands/report/report-useractivityusercounts.js +10 -0
- package/dist/m365/teams/commands/report/report-useractivityuserdetail.js +22 -0
- package/dist/m365/teams/commands/tab/tab-add.js +23 -49
- package/dist/m365/teams/commands/tab/tab-get.js +55 -56
- package/dist/m365/teams/commands/tab/tab-list.js +17 -28
- package/dist/m365/teams/commands/tab/tab-remove.js +23 -42
- package/dist/m365/teams/commands/team/team-add.js +76 -114
- package/dist/m365/teams/commands/team/team-app-list.js +23 -36
- package/dist/m365/teams/commands/team/team-archive.js +24 -39
- package/dist/m365/teams/commands/team/team-clone.js +28 -62
- package/dist/m365/teams/commands/team/team-get.js +23 -36
- package/dist/m365/teams/commands/team/team-list.js +43 -57
- package/dist/m365/teams/commands/team/team-remove.js +24 -37
- package/dist/m365/teams/commands/team/team-set.js +23 -52
- package/dist/m365/teams/commands/team/team-unarchive.js +23 -28
- package/dist/m365/teams/commands/user/user-app-add.js +40 -49
- package/dist/m365/teams/commands/user/user-app-list.js +26 -39
- package/dist/m365/teams/commands/user/user-app-remove.js +37 -49
- package/dist/m365/teams/commands/user/user-app-upgrade.js +36 -52
- package/dist/m365/teams/commands/user/user-list.js +17 -39
- package/dist/m365/tenant/commands/report/report-activeusercounts.js +2 -1
- package/dist/m365/tenant/commands/report/report-activeuserdetail.js +2 -1
- package/dist/m365/tenant/commands/report/report-office365activationcounts.js +9 -0
- package/dist/m365/tenant/commands/report/report-office365activationsusercounts.js +9 -0
- package/dist/m365/tenant/commands/report/report-office365activationsuserdetail.js +9 -0
- package/dist/m365/tenant/commands/report/report-servicesusercounts.js +2 -1
- package/dist/m365/tenant/commands/report/report-settings-get.js +5 -0
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-get.js +9 -20
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-list.js +8 -20
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-healthissue-get.js +8 -15
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-healthissue-list.js +8 -15
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-message-get.js +12 -26
- package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-message-list.js +8 -22
- package/dist/m365/util/commands/accesstoken/accesstoken-get.js +10 -28
- package/dist/telemetry.js +7 -11
- package/dist/utils/spo.js +40 -3
- package/dist/utils/urlUtil.js +2 -2
- package/dist/utils/zod.js +4 -4
- package/docs/docs/cmd/login.mdx +15 -2
- package/docs/docs/cmd/spe/container/container-permission-remove.mdx +78 -0
- package/docs/docs/cmd/spfx/project/project-upgrade.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-archive.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-checkin.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-checkout-undo.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-checkout.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-copy.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-get.mdx +6 -6
- package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-retentionlabel-remove.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +3 -3
- package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-sharinginfo-get.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-sharinglink-add.mdx +22 -1
- package/docs/docs/cmd/spo/file/file-sharinglink-clear.mdx +24 -1
- package/docs/docs/cmd/spo/file/file-sharinglink-get.mdx +22 -1
- package/docs/docs/cmd/spo/file/file-sharinglink-list.mdx +22 -1
- package/docs/docs/cmd/spo/file/file-sharinglink-remove.mdx +24 -1
- package/docs/docs/cmd/spo/file/file-sharinglink-set.mdx +22 -1
- package/docs/docs/cmd/spo/file/file-unarchive.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-clear.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-get.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-keep.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-list.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-remove.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-version-restore.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-archive.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-copy.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-get.mdx +2 -2
- package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +22 -1
- package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +23 -0
- package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +21 -0
- package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +22 -1
- package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +24 -1
- package/docs/docs/cmd/spo/folder/folder-sharinglink-set.mdx +21 -0
- package/docs/docs/cmd/spo/folder/folder-unarchive.mdx +76 -0
- package/docs/docs/cmd/spo/listitem/listitem-get.mdx +0 -6
- package/docs/docs/cmd/spo/navigation/navigation-node-add.mdx +45 -30
- package/docs/docs/cmd/spo/navigation/navigation-node-get.mdx +64 -42
- package/docs/docs/cmd/spo/navigation/navigation-node-set.mdx +10 -8
- package/docs/docs/cmd/spo/page/page-unpublish.mdx +63 -0
- package/docs/docs/cmd/spp/model/model-get.mdx +1 -1
- package/docs/docs/cmd/spp/model/model-remove.mdx +1 -1
- package/docs/docs/cmd/teams/tab/tab-add.mdx +19 -0
- package/docs/docs/cmd/teams/tab/tab-get.mdx +19 -0
- package/docs/docs/cmd/teams/tab/tab-list.mdx +19 -0
- package/docs/docs/cmd/teams/tab/tab-remove.mdx +21 -0
- package/docs/docs/cmd/viva/engage/engage-message-add.mdx +17 -0
- package/docs/docs/cmd/viva/engage/engage-message-get.mdx +17 -0
- package/docs/docs/cmd/viva/engage/engage-message-list.mdx +17 -0
- package/docs/docs/cmd/viva/engage/engage-message-remove.mdx +19 -0
- package/npm-shrinkwrap.json +324 -3116
- package/package.json +18 -35
- package/dist/appInsights.js +0 -43
|
@@ -1,12 +1,16 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
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 _TenantServiceAnnouncementMessageGetCommand_instances, _TenantServiceAnnouncementMessageGetCommand_initOptions, _TenantServiceAnnouncementMessageGetCommand_initValidators;
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { globalOptionsZod } from '../../../../Command.js';
|
|
7
3
|
import request from '../../../../request.js';
|
|
8
4
|
import GraphCommand from '../../../base/GraphCommand.js';
|
|
9
5
|
import commands from '../../commands.js';
|
|
6
|
+
export const options = z.strictObject({
|
|
7
|
+
...globalOptionsZod.shape,
|
|
8
|
+
id: z.string()
|
|
9
|
+
.refine(val => (/MC\d{6}/).test(val), {
|
|
10
|
+
message: 'The value is not a valid message ID'
|
|
11
|
+
})
|
|
12
|
+
.alias('i')
|
|
13
|
+
});
|
|
10
14
|
class TenantServiceAnnouncementMessageGetCommand extends GraphCommand {
|
|
11
15
|
get name() {
|
|
12
16
|
return commands.SERVICEANNOUNCEMENT_MESSAGE_GET;
|
|
@@ -14,11 +18,8 @@ class TenantServiceAnnouncementMessageGetCommand extends GraphCommand {
|
|
|
14
18
|
get description() {
|
|
15
19
|
return 'Retrieves a specified service update message for the tenant';
|
|
16
20
|
}
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
_TenantServiceAnnouncementMessageGetCommand_instances.add(this);
|
|
20
|
-
__classPrivateFieldGet(this, _TenantServiceAnnouncementMessageGetCommand_instances, "m", _TenantServiceAnnouncementMessageGetCommand_initOptions).call(this);
|
|
21
|
-
__classPrivateFieldGet(this, _TenantServiceAnnouncementMessageGetCommand_instances, "m", _TenantServiceAnnouncementMessageGetCommand_initValidators).call(this);
|
|
21
|
+
get schema() {
|
|
22
|
+
return options;
|
|
22
23
|
}
|
|
23
24
|
async commandAction(logger, args) {
|
|
24
25
|
if (this.verbose) {
|
|
@@ -39,21 +40,6 @@ class TenantServiceAnnouncementMessageGetCommand extends GraphCommand {
|
|
|
39
40
|
this.handleRejectedODataJsonPromise(err);
|
|
40
41
|
}
|
|
41
42
|
}
|
|
42
|
-
isValidId(id) {
|
|
43
|
-
return (/MC\d{6}/).test(id);
|
|
44
|
-
}
|
|
45
43
|
}
|
|
46
|
-
_TenantServiceAnnouncementMessageGetCommand_instances = new WeakSet(), _TenantServiceAnnouncementMessageGetCommand_initOptions = function _TenantServiceAnnouncementMessageGetCommand_initOptions() {
|
|
47
|
-
this.options.unshift({
|
|
48
|
-
option: '-i, --id <id>'
|
|
49
|
-
});
|
|
50
|
-
}, _TenantServiceAnnouncementMessageGetCommand_initValidators = function _TenantServiceAnnouncementMessageGetCommand_initValidators() {
|
|
51
|
-
this.validators.push(async (args) => {
|
|
52
|
-
if (!this.isValidId(args.options.id)) {
|
|
53
|
-
return `${args.options.id} is not a valid message ID`;
|
|
54
|
-
}
|
|
55
|
-
return true;
|
|
56
|
-
});
|
|
57
|
-
};
|
|
58
44
|
export default new TenantServiceAnnouncementMessageGetCommand();
|
|
59
45
|
//# sourceMappingURL=serviceannouncement-message-get.js.map
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
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 _TenantServiceAnnouncementMessageListCommand_instances, _TenantServiceAnnouncementMessageListCommand_initTelemetry, _TenantServiceAnnouncementMessageListCommand_initOptions;
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { globalOptionsZod } from '../../../../Command.js';
|
|
7
3
|
import { formatting } from '../../../../utils/formatting.js';
|
|
8
4
|
import { odata } from '../../../../utils/odata.js';
|
|
9
5
|
import GraphCommand from '../../../base/GraphCommand.js';
|
|
10
6
|
import commands from '../../commands.js';
|
|
7
|
+
export const options = z.strictObject({
|
|
8
|
+
...globalOptionsZod.shape,
|
|
9
|
+
service: z.string().optional().alias('s')
|
|
10
|
+
});
|
|
11
11
|
class TenantServiceAnnouncementMessageListCommand extends GraphCommand {
|
|
12
12
|
get name() {
|
|
13
13
|
return commands.SERVICEANNOUNCEMENT_MESSAGE_LIST;
|
|
@@ -18,11 +18,8 @@ class TenantServiceAnnouncementMessageListCommand extends GraphCommand {
|
|
|
18
18
|
defaultProperties() {
|
|
19
19
|
return ['id', 'title'];
|
|
20
20
|
}
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
_TenantServiceAnnouncementMessageListCommand_instances.add(this);
|
|
24
|
-
__classPrivateFieldGet(this, _TenantServiceAnnouncementMessageListCommand_instances, "m", _TenantServiceAnnouncementMessageListCommand_initTelemetry).call(this);
|
|
25
|
-
__classPrivateFieldGet(this, _TenantServiceAnnouncementMessageListCommand_instances, "m", _TenantServiceAnnouncementMessageListCommand_initOptions).call(this);
|
|
21
|
+
get schema() {
|
|
22
|
+
return options;
|
|
26
23
|
}
|
|
27
24
|
async commandAction(logger, args) {
|
|
28
25
|
let endpoint = `${this.resource}/v1.0/admin/serviceAnnouncement/messages`;
|
|
@@ -38,16 +35,5 @@ class TenantServiceAnnouncementMessageListCommand extends GraphCommand {
|
|
|
38
35
|
}
|
|
39
36
|
}
|
|
40
37
|
}
|
|
41
|
-
_TenantServiceAnnouncementMessageListCommand_instances = new WeakSet(), _TenantServiceAnnouncementMessageListCommand_initTelemetry = function _TenantServiceAnnouncementMessageListCommand_initTelemetry() {
|
|
42
|
-
this.telemetry.push((args) => {
|
|
43
|
-
Object.assign(this.telemetryProperties, {
|
|
44
|
-
service: typeof args.options.service !== 'undefined'
|
|
45
|
-
});
|
|
46
|
-
});
|
|
47
|
-
}, _TenantServiceAnnouncementMessageListCommand_initOptions = function _TenantServiceAnnouncementMessageListCommand_initOptions() {
|
|
48
|
-
this.options.unshift({
|
|
49
|
-
option: '-s, --service [service]'
|
|
50
|
-
});
|
|
51
|
-
};
|
|
52
38
|
export default new TenantServiceAnnouncementMessageListCommand();
|
|
53
39
|
//# sourceMappingURL=serviceannouncement-message-list.js.map
|
|
@@ -1,13 +1,14 @@
|
|
|
1
|
-
|
|
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 _UtilAccessTokenGetCommand_instances, _UtilAccessTokenGetCommand_initTelemetry, _UtilAccessTokenGetCommand_initOptions;
|
|
1
|
+
import { z } from 'zod';
|
|
7
2
|
import auth, { Auth } from '../../../../Auth.js';
|
|
8
|
-
import Command from '../../../../Command.js';
|
|
3
|
+
import Command, { globalOptionsZod } from '../../../../Command.js';
|
|
9
4
|
import commands from '../../commands.js';
|
|
10
5
|
import { accessToken } from '../../../../utils/accessToken.js';
|
|
6
|
+
export const options = z.strictObject({
|
|
7
|
+
...globalOptionsZod.shape,
|
|
8
|
+
resource: z.string().alias('r'),
|
|
9
|
+
new: z.boolean().optional(),
|
|
10
|
+
decoded: z.boolean().optional()
|
|
11
|
+
});
|
|
11
12
|
class UtilAccessTokenGetCommand extends Command {
|
|
12
13
|
get name() {
|
|
13
14
|
return commands.ACCESSTOKEN_GET;
|
|
@@ -15,11 +16,8 @@ class UtilAccessTokenGetCommand extends Command {
|
|
|
15
16
|
get description() {
|
|
16
17
|
return 'Gets access token for the specified resource';
|
|
17
18
|
}
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
_UtilAccessTokenGetCommand_instances.add(this);
|
|
21
|
-
__classPrivateFieldGet(this, _UtilAccessTokenGetCommand_instances, "m", _UtilAccessTokenGetCommand_initTelemetry).call(this);
|
|
22
|
-
__classPrivateFieldGet(this, _UtilAccessTokenGetCommand_instances, "m", _UtilAccessTokenGetCommand_initOptions).call(this);
|
|
19
|
+
get schema() {
|
|
20
|
+
return options;
|
|
23
21
|
}
|
|
24
22
|
async commandAction(logger, args) {
|
|
25
23
|
let resource = args.options.resource;
|
|
@@ -49,21 +47,5 @@ class UtilAccessTokenGetCommand extends Command {
|
|
|
49
47
|
}
|
|
50
48
|
}
|
|
51
49
|
}
|
|
52
|
-
_UtilAccessTokenGetCommand_instances = new WeakSet(), _UtilAccessTokenGetCommand_initTelemetry = function _UtilAccessTokenGetCommand_initTelemetry() {
|
|
53
|
-
this.telemetry.push((args) => {
|
|
54
|
-
Object.assign(this.telemetryProperties, {
|
|
55
|
-
new: args.options.new,
|
|
56
|
-
decoded: args.options.decoded
|
|
57
|
-
});
|
|
58
|
-
});
|
|
59
|
-
}, _UtilAccessTokenGetCommand_initOptions = function _UtilAccessTokenGetCommand_initOptions() {
|
|
60
|
-
this.options.unshift({
|
|
61
|
-
option: '-r, --resource <resource>'
|
|
62
|
-
}, {
|
|
63
|
-
option: '--new'
|
|
64
|
-
}, {
|
|
65
|
-
option: '--decoded'
|
|
66
|
-
});
|
|
67
|
-
};
|
|
68
50
|
export default new UtilAccessTokenGetCommand();
|
|
69
51
|
//# sourceMappingURL=accesstoken-get.js.map
|
package/dist/telemetry.js
CHANGED
|
@@ -1,25 +1,21 @@
|
|
|
1
|
-
import appInsights from './appInsights.js';
|
|
2
1
|
import { cli } from './cli/cli.js';
|
|
2
|
+
import { googleAnalytics } from './googleAnalytics.js';
|
|
3
3
|
import { settingsNames } from './settingsNames.js';
|
|
4
4
|
import { pid } from './utils/pid.js';
|
|
5
5
|
import { session } from './utils/session.js';
|
|
6
6
|
async function trackTelemetry(object) {
|
|
7
7
|
try {
|
|
8
8
|
const { commandName, properties, exception } = object;
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
const context = {
|
|
10
|
+
shell: pid.getProcessName(process.ppid) || '',
|
|
11
|
+
sessionId: session.getId(process.ppid)
|
|
12
|
+
};
|
|
11
13
|
if (exception) {
|
|
12
|
-
|
|
13
|
-
exception
|
|
14
|
-
});
|
|
14
|
+
await googleAnalytics.trackException(exception, context);
|
|
15
15
|
}
|
|
16
16
|
else {
|
|
17
|
-
|
|
18
|
-
name: commandName,
|
|
19
|
-
properties
|
|
20
|
-
});
|
|
17
|
+
await googleAnalytics.trackEvent(commandName, properties, context);
|
|
21
18
|
}
|
|
22
|
-
await appInsights.flush();
|
|
23
19
|
}
|
|
24
20
|
catch {
|
|
25
21
|
// Do nothing
|
package/dist/utils/spo.js
CHANGED
|
@@ -576,6 +576,45 @@ export const spo = {
|
|
|
576
576
|
return request.post(requestOptions);
|
|
577
577
|
},
|
|
578
578
|
/**
|
|
579
|
+
* Retrieves the navigation node with the specified key.
|
|
580
|
+
* Returns the node along with the menu state that contains it.
|
|
581
|
+
* @param webUrl Web url
|
|
582
|
+
* @param key Key (ID) of the navigation node
|
|
583
|
+
* @param location Navigation to search. When not specified, searches the quick launch first and then the top navigation
|
|
584
|
+
*/
|
|
585
|
+
async getMenuStateNodeByKey(webUrl, key, location) {
|
|
586
|
+
const locations = location ? [location] : ['QuickLaunch', 'TopNavigationBar'];
|
|
587
|
+
for (const navigationLocation of locations) {
|
|
588
|
+
const menuState = navigationLocation === 'TopNavigationBar'
|
|
589
|
+
? await this.getTopNavigationMenuState(webUrl)
|
|
590
|
+
: await this.getQuickLaunchMenuState(webUrl);
|
|
591
|
+
const node = this.findMenuStateNode(menuState.Nodes, key);
|
|
592
|
+
if (node) {
|
|
593
|
+
return { menuState, node };
|
|
594
|
+
}
|
|
595
|
+
}
|
|
596
|
+
throw location
|
|
597
|
+
? `Navigation node with id '${key}' not found in ${location}.`
|
|
598
|
+
: `Navigation node with id '${key}' not found.`;
|
|
599
|
+
},
|
|
600
|
+
/**
|
|
601
|
+
* Recursively searches the specified menu state nodes for the node with the specified key.
|
|
602
|
+
* @param nodes Menu state nodes to search
|
|
603
|
+
* @param key Key (ID) of the navigation node
|
|
604
|
+
*/
|
|
605
|
+
findMenuStateNode(nodes, key) {
|
|
606
|
+
for (const node of nodes) {
|
|
607
|
+
if (node.Key === key) {
|
|
608
|
+
return node;
|
|
609
|
+
}
|
|
610
|
+
const childNode = this.findMenuStateNode(node.Nodes, key);
|
|
611
|
+
if (childNode) {
|
|
612
|
+
return childNode;
|
|
613
|
+
}
|
|
614
|
+
}
|
|
615
|
+
return undefined;
|
|
616
|
+
},
|
|
617
|
+
/**
|
|
579
618
|
* Retrieves the spo group by name.
|
|
580
619
|
* Returns a group object
|
|
581
620
|
* @param webUrl Web url
|
|
@@ -1250,9 +1289,7 @@ export const spo = {
|
|
|
1250
1289
|
// Neither properties nor contentTypeName provided, no need to proceed
|
|
1251
1290
|
throw 'Either properties or contentTypeName must be provided for systemUpdateListItem.';
|
|
1252
1291
|
}
|
|
1253
|
-
const
|
|
1254
|
-
const serverRelativeSiteMatch = absoluteListUrl.match(new RegExp('/sites/[^/]+'));
|
|
1255
|
-
const webUrl = `${parsedUrl.protocol}//${parsedUrl.host}${serverRelativeSiteMatch ?? ''}`;
|
|
1292
|
+
const webUrl = absoluteListUrl.substring(0, absoluteListUrl.indexOf('/_api/'));
|
|
1256
1293
|
if (verbose && logger) {
|
|
1257
1294
|
await logger.logToStderr(`Getting list id...`);
|
|
1258
1295
|
}
|
package/dist/utils/urlUtil.js
CHANGED
|
@@ -165,8 +165,8 @@ export const urlUtil = {
|
|
|
165
165
|
*/
|
|
166
166
|
getTargetSiteAbsoluteUrl(webUrl, url) {
|
|
167
167
|
const fullUrl = url.startsWith('https://') ? url : urlUtil.getAbsoluteUrl(webUrl, url);
|
|
168
|
-
// Pattern to match SharePoint URLs
|
|
169
|
-
const urlPattern =
|
|
168
|
+
// Pattern to match SharePoint site collection URLs on any of the supported managed paths
|
|
169
|
+
const urlPattern = /^https:\/\/[\w-]+\.sharepoint\.com\/(teams|sites|personal)\/[^/?#]+/i;
|
|
170
170
|
const match = fullUrl.match(urlPattern);
|
|
171
171
|
if (match) {
|
|
172
172
|
// If a match is found, return the matched URL
|
package/dist/utils/zod.js
CHANGED
|
@@ -110,14 +110,14 @@ export const zod = {
|
|
|
110
110
|
});
|
|
111
111
|
return options;
|
|
112
112
|
},
|
|
113
|
-
coercedEnum: (e) => z.preprocess(val => {
|
|
114
|
-
const target = String(val)
|
|
113
|
+
coercedEnum: (e) => z.string().pipe(z.preprocess(val => {
|
|
114
|
+
const target = String(val).toLowerCase();
|
|
115
115
|
for (const k of Object.values(e)) {
|
|
116
|
-
if (String(k)
|
|
116
|
+
if (String(k).toLowerCase() === target) {
|
|
117
117
|
return k;
|
|
118
118
|
}
|
|
119
119
|
}
|
|
120
120
|
return null;
|
|
121
|
-
}, z.enum(e))
|
|
121
|
+
}, z.enum(e)))
|
|
122
122
|
};
|
|
123
123
|
//# sourceMappingURL=zod.js.map
|
package/docs/docs/cmd/login.mdx
CHANGED
|
@@ -78,7 +78,20 @@ When logging in to Microsoft 365 using the user name and password, next to the a
|
|
|
78
78
|
|
|
79
79
|
When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.mdx) command.
|
|
80
80
|
|
|
81
|
-
Federated Identity is currently supported in GitHub Actions. To use this you need to set `authType` to `federatedIdentity` and specify `appId` and `tenant` to the values of the app registration you've configured a federated credential on.
|
|
81
|
+
Federated Identity is currently supported in GitHub Actions, Azure DevOps and GitLab CI/CD. To use this you need to set `authType` to `federatedIdentity` and specify `appId` and `tenant` to the values of the app registration you've configured a federated credential on.
|
|
82
|
+
|
|
83
|
+
To use Federated Identity in GitLab CI/CD, the job must request an ID token named `GITLAB_OIDC_TOKEN` with audience `api://AzureADTokenExchange`, for example:
|
|
84
|
+
|
|
85
|
+
```yaml
|
|
86
|
+
job:
|
|
87
|
+
id_tokens:
|
|
88
|
+
GITLAB_OIDC_TOKEN:
|
|
89
|
+
aud: "api://AzureADTokenExchange"
|
|
90
|
+
script:
|
|
91
|
+
- m365 login --authType federatedIdentity --appId eb96cfd0-abfa-4477-8d1d-c6dfde3efb19 --tenant 9a1a1bbd-e158-4cf5-967d-a53b8e85c628
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
The corresponding federated credential on the Microsoft Entra app registration must have issuer `https://gitlab.com` (or your self-managed GitLab instance URL) and a subject matching the GitLab OIDC claim for the job, for example `project_path:<group>/<project>:ref_type:branch:ref:<branch>`.
|
|
82
95
|
|
|
83
96
|
To log in to Microsoft 365 using a certificate or secret, you will typically [create a custom Microsoft Entra application](../user-guide/using-own-identity.mdx). To use this application with the CLI for Microsoft 365, you will set the `CLIMICROSOFT365_ENTRAAPPID` environment variable to the application's ID and the `CLIMICROSOFT365_TENANT` environment variable to the ID of the Microsoft Entra tenant, where you created the Microsoft Entra application. Also, please make sure to read about [the caveats when using the certificate login option](../user-guide/cli-certificate-caveats.mdx).
|
|
84
97
|
|
|
@@ -202,7 +215,7 @@ Log in to Microsoft 365 using a user-assigned managed identity with `clientId` s
|
|
|
202
215
|
m365 login --authType identity --userName ac9fbed5-804c-4362-a369-21a4ec51109e
|
|
203
216
|
```
|
|
204
217
|
|
|
205
|
-
Log in to Microsoft 365 using a federated identity. Can currently only be used in GitHub Actions.
|
|
218
|
+
Log in to Microsoft 365 using a federated identity. Can currently only be used in GitHub Actions, Azure DevOps and GitLab CI/CD.
|
|
206
219
|
|
|
207
220
|
```sh
|
|
208
221
|
m365 login --authType federatedIdentity --appId eb96cfd0-abfa-4477-8d1d-c6dfde3efb19 --tenant 9a1a1bbd-e158-4cf5-967d-a53b8e85c628
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import Global from '../../_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
4
|
+
|
|
5
|
+
# spe container permission remove
|
|
6
|
+
|
|
7
|
+
Removes permissions from a SharePoint Embedded Container
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
m365 spe container permission remove [options]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Options
|
|
16
|
+
|
|
17
|
+
```md definition-list
|
|
18
|
+
`-i, --id <id>`
|
|
19
|
+
: ID of the permission to remove.
|
|
20
|
+
|
|
21
|
+
`--containerId [containerId]`
|
|
22
|
+
: ID of a SharePoint Embedded container. Specify either `containerId` or `containerName` but not both.
|
|
23
|
+
|
|
24
|
+
`-n, --containerName [containerName]`
|
|
25
|
+
: Display name of the Container. Specify either `containerId` or `containerName` but not both.
|
|
26
|
+
|
|
27
|
+
`--containerTypeId [containerTypeId]`
|
|
28
|
+
: The ID of the container type. Specify either `containerTypeId` or `containerTypeName` when using `containerName` but not both.
|
|
29
|
+
|
|
30
|
+
`--containerTypeName [containerTypeName]`
|
|
31
|
+
: The name of the container type. Specify either `containerTypeId` or `containerTypeName` when using `containerName` but not both.
|
|
32
|
+
|
|
33
|
+
`-f, --force [force]`
|
|
34
|
+
: Don't prompt for confirmation.
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
<Global />
|
|
38
|
+
|
|
39
|
+
## Permissions
|
|
40
|
+
|
|
41
|
+
<Tabs>
|
|
42
|
+
<TabItem value="Delegated">
|
|
43
|
+
|
|
44
|
+
| Resource | Permissions |
|
|
45
|
+
|-----------------|--------------------------------------------------------------------|
|
|
46
|
+
| Microsoft Graph | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
|
|
47
|
+
|
|
48
|
+
`FileStorageContainerType.Manage.All` is required only when using `containerTypeName`.
|
|
49
|
+
|
|
50
|
+
</TabItem>
|
|
51
|
+
<TabItem value="Application">
|
|
52
|
+
|
|
53
|
+
This command only supports application permissions when **not** using the `containerTypeName` option.
|
|
54
|
+
|
|
55
|
+
| Resource | Permissions |
|
|
56
|
+
|-----------------|-------------------------------|
|
|
57
|
+
| Microsoft Graph | FileStorageContainer.Selected |
|
|
58
|
+
|
|
59
|
+
</TabItem>
|
|
60
|
+
</Tabs>
|
|
61
|
+
|
|
62
|
+
## Examples
|
|
63
|
+
|
|
64
|
+
Removes the specified permission from a container
|
|
65
|
+
|
|
66
|
+
```sh
|
|
67
|
+
m365 spe container permission remove --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --id "cmVhZGVyX2k6MCMuZnxtZW1iZXJzaGlwfHJvcnlicjExMUBvdXRsb29rLmNvbQ"
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Removes the specified permission from a container and doesn't prompt for confirmation
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
m365 spe container permission remove --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --id "cmVhZGVyX2k6MCMuZnxtZW1iZXJzaGlwfHJvcnlicjExMUBvdXRsb29rLmNvbQ" --force
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Response
|
|
77
|
+
|
|
78
|
+
The command won't return a response on success.
|
|
@@ -45,7 +45,7 @@ m365 spfx project upgrade [options]
|
|
|
45
45
|
|
|
46
46
|
## Remarks
|
|
47
47
|
|
|
48
|
-
The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.
|
|
48
|
+
The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.24.0).
|
|
49
49
|
|
|
50
50
|
This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
|
|
51
51
|
|
|
@@ -22,7 +22,7 @@ m365 spo file archive [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to archive. Specify either `url` or `id`, but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --id [id]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to archive. Specify either `url` or `id`, but not both.
|
|
26
26
|
|
|
27
27
|
`-f, --force`
|
|
28
28
|
: Don't prompt for confirmation.
|
|
@@ -22,7 +22,7 @@ m365 spo file checkin [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --id [id]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `url` or `id` but not both.
|
|
26
26
|
|
|
27
27
|
`-t, --type [type]`
|
|
28
28
|
: Type of the check in. Allowed values: `Minor`, `Major`, `Overwrite`. Defaults to `Major`.
|
|
@@ -54,7 +54,7 @@ m365 spo file checkin [options]
|
|
|
54
54
|
|
|
55
55
|
## Examples
|
|
56
56
|
|
|
57
|
-
Checks in file with the specified
|
|
57
|
+
Checks in file with the specified unique ID located in the specified site.
|
|
58
58
|
|
|
59
59
|
```sh
|
|
60
60
|
m365 spo file checkin --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6'
|
|
@@ -22,7 +22,7 @@ m365 spo file checkout undo [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`-f, --force`
|
|
28
28
|
: Don't prompt for confirmation.
|
|
@@ -22,7 +22,7 @@ m365 spo file checkout [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --id [id]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `url` or `id` but not both.
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
<Global />
|
|
@@ -48,7 +48,7 @@ m365 spo file checkout [options]
|
|
|
48
48
|
|
|
49
49
|
## Examples
|
|
50
50
|
|
|
51
|
-
Checks out file with the specified
|
|
51
|
+
Checks out file with the specified unique ID located in the specified site.
|
|
52
52
|
|
|
53
53
|
```sh
|
|
54
54
|
m365 spo file checkout --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6'
|
|
@@ -85,13 +85,13 @@ Copy a file by site-relative URL to a document library in another site collectio
|
|
|
85
85
|
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
|
|
86
86
|
```
|
|
87
87
|
|
|
88
|
-
Copy file by sourceId (
|
|
88
|
+
Copy file by sourceId (unique ID) to a document library in another site collection and rename the file (without specifying the file extension).
|
|
89
89
|
|
|
90
90
|
```sh
|
|
91
91
|
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
|
|
92
92
|
```
|
|
93
93
|
|
|
94
|
-
Copy file by sourceId (
|
|
94
|
+
Copy file by sourceId (unique ID) to a document library in another site collection with a new name, rename the file if it already exists.
|
|
95
95
|
|
|
96
96
|
```sh
|
|
97
97
|
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf" --nameConflictBehavior rename
|
|
@@ -22,7 +22,7 @@ m365 spo file get [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --id [id]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `url` or `id` but not both.
|
|
26
26
|
|
|
27
27
|
`--asString`
|
|
28
28
|
: Set to retrieve the contents of the specified file as string.
|
|
@@ -63,25 +63,25 @@ m365 spo file get [options]
|
|
|
63
63
|
|
|
64
64
|
## Examples
|
|
65
65
|
|
|
66
|
-
Get file properties for a file with id (
|
|
66
|
+
Get file properties for a file with id (unique ID) parameter located in a site.
|
|
67
67
|
|
|
68
68
|
```sh
|
|
69
69
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6'
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
-
Get contents of the file with id (
|
|
72
|
+
Get contents of the file with id (unique ID) parameter located in a site.
|
|
73
73
|
|
|
74
74
|
```sh
|
|
75
75
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6' --asString
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
Get list item properties for a file with id (
|
|
78
|
+
Get list item properties for a file with id (unique ID) parameter located in a site.
|
|
79
79
|
|
|
80
80
|
```sh
|
|
81
81
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6' --asListItem
|
|
82
82
|
```
|
|
83
83
|
|
|
84
|
-
Saves the file with id (
|
|
84
|
+
Saves the file with id (unique ID) parameter located in a site to a local file.
|
|
85
85
|
|
|
86
86
|
```sh
|
|
87
87
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6' --asFile --path /Users/user/documents/SavedAsTest1.docx
|
|
@@ -111,7 +111,7 @@ Saves a file with the server-relative url located in a site to a local file.
|
|
|
111
111
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/documents/Test1.docx' --asFile --path /Users/user/documents/SavedAsTest1.docx
|
|
112
112
|
```
|
|
113
113
|
|
|
114
|
-
Gets the file properties for a file with id (
|
|
114
|
+
Gets the file properties for a file with id (unique ID) parameter located in a site with permissions.
|
|
115
115
|
|
|
116
116
|
```sh
|
|
117
117
|
m365 spo file get --webUrl https://contoso.sharepoint.com/sites/project-x --id 'b2307a39-e878-458b-bc90-03bc578531d6' --withPermissions
|
|
@@ -22,7 +22,7 @@ m365 spo file retentionlabel ensure [options]
|
|
|
22
22
|
: The site- or server-relative decoded URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`--name <name>`
|
|
28
28
|
: Name of the retention label to apply to the file.
|
|
@@ -22,7 +22,7 @@ m365 spo file retentionlabel remove [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`-f, --force`
|
|
28
28
|
: Don't prompt for confirming removing the retention label from a file.
|
|
@@ -22,7 +22,7 @@ m365 spo file roleassignment add [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`--principalId [principalId]`
|
|
28
28
|
: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
@@ -22,7 +22,7 @@ m365 spo file roleassignment remove [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`--principalId [principalId]`
|
|
28
28
|
: The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
|
|
@@ -22,7 +22,7 @@ m365 spo file roleinheritance break [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`-c, --clearExistingPermissions`
|
|
28
28
|
: Clear all existing permissions from the file.
|
|
@@ -54,13 +54,13 @@ m365 spo file roleinheritance break [options]
|
|
|
54
54
|
|
|
55
55
|
## Examples
|
|
56
56
|
|
|
57
|
-
Break the inheritance of a file with a specific id (
|
|
57
|
+
Break the inheritance of a file with a specific id (unique ID).
|
|
58
58
|
|
|
59
59
|
```sh
|
|
60
60
|
m365 spo file roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileId "b2307a39-e878-458b-bc90-03bc578531d6"
|
|
61
61
|
```
|
|
62
62
|
|
|
63
|
-
Break the inheritance of a file with a specific id (
|
|
63
|
+
Break the inheritance of a file with a specific id (unique ID) and clear all existing permissions.
|
|
64
64
|
|
|
65
65
|
```sh
|
|
66
66
|
m365 spo file roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileId "b2307a39-e878-458b-bc90-03bc578531d6" --clearExistingPermissions
|
|
@@ -22,7 +22,7 @@ m365 spo file roleinheritance reset [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
|
|
27
27
|
`-f, --force`
|
|
28
28
|
: Don't prompt for confirmation.
|
|
@@ -51,7 +51,7 @@ m365 spo file roleinheritance reset [options]
|
|
|
51
51
|
|
|
52
52
|
## Examples
|
|
53
53
|
|
|
54
|
-
Reset inheritance of file with the specified id (
|
|
54
|
+
Reset inheritance of file with the specified id (unique ID) located in the specified site.
|
|
55
55
|
|
|
56
56
|
```sh
|
|
57
57
|
m365 spo file roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileId "b2307a39-e878-458b-bc90-03bc578531d6"
|
|
@@ -22,7 +22,7 @@ m365 spo file sharinginfo get [options]
|
|
|
22
22
|
: The server- or site-relative decoded URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both.
|
|
23
23
|
|
|
24
24
|
`-i, --fileId [fileId]`
|
|
25
|
-
: The
|
|
25
|
+
: The unique ID (GUID) of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both.
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
<Global />
|
|
@@ -54,7 +54,7 @@ Get file sharing information report for the file with the specified server-relat
|
|
|
54
54
|
m365 spo file sharinginfo get --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl "/sites/M365CLI/Shared Documents/SharedFile.docx"
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
-
Get file sharing information report for file with the specified id (
|
|
57
|
+
Get file sharing information report for file with the specified id (unique ID) located in the specified site.
|
|
58
58
|
|
|
59
59
|
```sh
|
|
60
60
|
m365 spo file sharinginfo get --webUrl https://contoso.sharepoint.com/sites/project-x --fileId "b2307a39-e878-458b-bc90-03bc578531d6"
|