@pnp/cli-microsoft365 6.3.0-beta.a991329 → 6.3.0-beta.ac7b232

package/.eslintrc.js

@@ -7,9 +7,11 @@ const dictionary = [
   'adaptive',
   'ai',
   'app',
+  'application',
   'apply',
   'approve',
   'assets',
+  'audit',
   'bin',
   'builder',
   'catalog',
@@ -19,6 +21,7 @@ const dictionary = [
   'content',
   'conversation',
   'custom',
+  'customizer',
   'dataverse',
   'default',
   'external',
@@ -43,6 +46,9 @@ const dictionary = [
   'label',
   'list',
   'link',
+  'log',
+  'login',
+  'logout',
   'management',
   'member',
   'messaging',

package/dist/m365/base/O365MgmtCommand.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Command_1 = require("../../Command");
+class O365MgmtCommand extends Command_1.default {
+    get resource() {
+        return 'https://manage.office.com';
+    }
+}
+exports.default = O365MgmtCommand;
+//# sourceMappingURL=O365MgmtCommand.js.map

package/dist/m365/planner/commands/plan/plan-get.js

@@ -48,8 +48,11 @@ class PlannerPlanGetCommand extends GraphCommand_1.default {
                     logger.log(result);
                 }
                 else {
-                    const groupId = yield this.getGroupId(args);
-                    const plan = yield planner_1.planner.getPlanByTitle(args.options.title, groupId);
+                    let groupId = undefined;
+                    if (args.options.ownerGroupId || args.options.ownerGroupName) {
+                        groupId = yield this.getGroupId(args);
+                    }
+                    const plan = yield planner_1.planner.getPlanByTitle(args.options.title, groupId, args.options.rosterId);
                     const result = yield this.getPlanDetails(plan);
                     if (result) {
                         logger.log(result);
@@ -62,27 +65,27 @@ class PlannerPlanGetCommand extends GraphCommand_1.default {
         });
     }
     getPlanDetails(plan) {
-        const requestOptionsTaskDetails = {
-            url: `${this.resource}/v1.0/planner/plans/${plan.id}/details`,
-            headers: {
-                'accept': 'application/json;odata.metadata=none',
-                'Prefer': 'return=representation'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptionsTaskDetails)
-            .then(planDetails => {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptionsTaskDetails = {
+                url: `${this.resource}/v1.0/planner/plans/${plan.id}/details`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none',
+                    'Prefer': 'return=representation'
+                },
+                responseType: 'json'
+            };
+            const planDetails = yield request_1.default.get(requestOptionsTaskDetails);
             return Object.assign(Object.assign({}, plan), planDetails);
         });
     }
     getGroupId(args) {
-        if (args.options.ownerGroupId) {
-            return Promise.resolve(args.options.ownerGroupId);
-        }
-        return aadGroup_1.aadGroup
-            .getGroupByDisplayName(args.options.ownerGroupName)
-            .then(group => group.id);
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.ownerGroupId) {
+                return args.options.ownerGroupId;
+            }
+            const group = yield aadGroup_1.aadGroup.getGroupByDisplayName(args.options.ownerGroupName);
+            return group.id;
+        });
     }
 }
 _PlannerPlanGetCommand_instances = new WeakSet(), _PlannerPlanGetCommand_initTelemetry = function _PlannerPlanGetCommand_initTelemetry() {
@@ -91,7 +94,8 @@ _PlannerPlanGetCommand_instances = new WeakSet(), _PlannerPlanGetCommand_initTel
             id: typeof args.options.id !== 'undefined',
             title: typeof args.options.title !== 'undefined',
             ownerGroupId: typeof args.options.ownerGroupId !== 'undefined',
-            ownerGroupName: typeof args.options.ownerGroupName !== 'undefined'
+            ownerGroupName: typeof args.options.ownerGroupName !== 'undefined',
+            rosterId: typeof args.options.rosterId !== 'undefined'
         });
     });
 }, _PlannerPlanGetCommand_initOptions = function _PlannerPlanGetCommand_initOptions() {
@@ -103,22 +107,25 @@ _PlannerPlanGetCommand_instances = new WeakSet(), _PlannerPlanGetCommand_initTel
         option: '--ownerGroupId [ownerGroupId]'
     }, {
         option: '--ownerGroupName [ownerGroupName]'
+    }, {
+        option: '--rosterId [rosterId]'
     });
 }, _PlannerPlanGetCommand_initValidators = function _PlannerPlanGetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
-        if (args.options.title && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName';
-        }
-        if (args.options.title && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName but not both';
-        }
         if (args.options.ownerGroupId && !validation_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;
         }
         return true;
     }));
 }, _PlannerPlanGetCommand_initOptionSets = function _PlannerPlanGetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['id', 'title'] });
+    this.optionSets.push({
+        options: ['id', 'title']
+    }, {
+        options: ['ownerGroupId', 'ownerGroupName', 'rosterId'],
+        runsWhen: (args) => {
+            return args.options.title !== undefined;
+        }
+    });
 };
 module.exports = new PlannerPlanGetCommand();
 //# sourceMappingURL=plan-get.js.map

package/dist/m365/planner/commands/plan/plan-list.js

@@ -16,16 +16,16 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _PlannerPlanListCommand_instances, _PlannerPlanListCommand_initTelemetry, _PlannerPlanListCommand_initOptions, _PlannerPlanListCommand_initValidators, _PlannerPlanListCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
 const validation_1 = require("../../../../utils/validation");
-const aadGroup_1 = require("../../../../utils/aadGroup");
 const planner_1 = require("../../../../utils/planner");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
+const aadGroup_1 = require("../../../../utils/aadGroup");
 class PlannerPlanListCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.PLAN_LIST;
     }
     get description() {
-        return 'Returns a list of plans associated with a specified group';
+        return 'Returns a list of plans associated with a specified group or roster';
     }
     constructor() {
         super();
@@ -41,10 +41,16 @@ class PlannerPlanListCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const groupId = yield this.getGroupId(args);
-                const result = yield planner_1.planner.getPlansByGroupId(groupId);
-                if (result && result.length > 0) {
-                    logger.log(result);
+                let plannerPlans = null;
+                if (args.options.ownerGroupId || args.options.ownerGroupName) {
+                    const groupId = yield this.getGroupId(args);
+                    plannerPlans = yield planner_1.planner.getPlansByGroupId(groupId);
+                }
+                else {
+                    plannerPlans = yield planner_1.planner.getPlansByRosterId(args.options.rosterId);
+                }
+                if (plannerPlans && plannerPlans.length > 0) {
+                    logger.log(plannerPlans);
                 }
             }
             catch (err) {
@@ -53,19 +59,21 @@ class PlannerPlanListCommand extends GraphCommand_1.default {
         });
     }
     getGroupId(args) {
-        if (args.options.ownerGroupId) {
-            return Promise.resolve(args.options.ownerGroupId);
-        }
-        return aadGroup_1.aadGroup
-            .getGroupByDisplayName(args.options.ownerGroupName)
-            .then(group => group.id);
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.ownerGroupId) {
+                return args.options.ownerGroupId;
+            }
+            const group = yield aadGroup_1.aadGroup.getGroupByDisplayName(args.options.ownerGroupName);
+            return group.id;
+        });
     }
 }
 _PlannerPlanListCommand_instances = new WeakSet(), _PlannerPlanListCommand_initTelemetry = function _PlannerPlanListCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
             ownerGroupId: typeof args.options.ownerGroupId !== 'undefined',
-            ownerGroupName: typeof args.options.ownerGroupName !== 'undefined'
+            ownerGroupName: typeof args.options.ownerGroupName !== 'undefined',
+            rosterId: typeof args.options.rosterId !== 'undefined'
         });
     });
 }, _PlannerPlanListCommand_initOptions = function _PlannerPlanListCommand_initOptions() {
@@ -73,6 +81,8 @@ _PlannerPlanListCommand_instances = new WeakSet(), _PlannerPlanListCommand_initT
         option: "--ownerGroupId [ownerGroupId]"
     }, {
         option: "--ownerGroupName [ownerGroupName]"
+    }, {
+        option: "--rosterId [rosterId]"
     });
 }, _PlannerPlanListCommand_initValidators = function _PlannerPlanListCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
@@ -82,7 +92,7 @@ _PlannerPlanListCommand_instances = new WeakSet(), _PlannerPlanListCommand_initT
         return true;
     }));
 }, _PlannerPlanListCommand_initOptionSets = function _PlannerPlanListCommand_initOptionSets() {
-    this.optionSets.push({ options: ['ownerGroupId', 'ownerGroupName'] });
+    this.optionSets.push({ options: ['ownerGroupId', 'ownerGroupName', 'rosterId'] });
 };
 module.exports = new PlannerPlanListCommand();
 //# sourceMappingURL=plan-list.js.map

package/dist/m365/purview/commands/auditlog/auditlog-list.js

@@ -0,0 +1,205 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PurviewAuditLogListCommand_instances, _PurviewAuditLogListCommand_initTelemetry, _PurviewAuditLogListCommand_initOptions, _PurviewAuditLogListCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const request_1 = require("../../../../request");
+const accessToken_1 = require("../../../../utils/accessToken");
+const validation_1 = require("../../../../utils/validation");
+const O365MgmtCommand_1 = require("../../../base/O365MgmtCommand");
+const commands_1 = require("../../commands");
+class PurviewAuditLogListCommand extends O365MgmtCommand_1.default {
+    get name() {
+        return commands_1.default.AUDITLOG_LIST;
+    }
+    get description() {
+        return 'List audit logs within your tenant';
+    }
+    defaultProperties() {
+        return ['CreationTime', 'UserId', 'Operation', 'ObjectId'];
+    }
+    constructor() {
+        super();
+        _PurviewAuditLogListCommand_instances.add(this);
+        this.contentTypeOptions = ['AzureActiveDirectory', 'Exchange', 'SharePoint', 'General', 'DLP'];
+        __classPrivateFieldGet(this, _PurviewAuditLogListCommand_instances, "m", _PurviewAuditLogListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _PurviewAuditLogListCommand_instances, "m", _PurviewAuditLogListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _PurviewAuditLogListCommand_instances, "m", _PurviewAuditLogListCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // If we don't create a now object, start and end date can be an few extra ms apart due to execution time between code lines
+            const now = new Date();
+            try {
+                let startTime;
+                if (args.options.startTime) {
+                    startTime = new Date(args.options.startTime);
+                }
+                else {
+                    startTime = new Date(now);
+                    startTime.setDate(startTime.getDate() - 1);
+                }
+                const endTime = args.options.endTime ? new Date(args.options.endTime) : new Date(now);
+                if (this.verbose) {
+                    logger.logToStderr(`Getting audit logs for content type '${args.options.contentType}' within a time frame from '${startTime.toISOString()}' to '${endTime.toISOString()}'.`);
+                }
+                const tenantId = accessToken_1.accessToken.getTenantIdFromAccessToken(Auth_1.default.service.accessTokens[Auth_1.default.defaultResource].accessToken);
+                const contentTypeValue = args.options.contentType === 'DLP' ? 'DLP.All' : 'Audit.' + args.options.contentType;
+                yield this.ensureSubscription(tenantId, contentTypeValue);
+                if (this.verbose) {
+                    logger.logToStderr(`'${args.options.contentType}' subscription is active.`);
+                }
+                const contentUris = [];
+                for (const time = startTime; time < endTime; time.setDate(time.getDate() + 1)) {
+                    const differenceInMs = endTime.getTime() - time.getTime();
+                    const endTimeBatch = new Date(time.getTime() + Math.min(differenceInMs, 1000 * 60 * 60 * 24)); // ms difference cannot be greater than 1 day
+                    if (this.verbose) {
+                        logger.logToStderr(`Get content URIs for date range from '${time.toISOString()}' to '${endTimeBatch.toISOString()}'.`);
+                    }
+                    const contentUrisBatch = yield this.getContentUris(tenantId, contentTypeValue, time, endTimeBatch);
+                    contentUris.push(...contentUrisBatch);
+                }
+                if (this.verbose) {
+                    logger.logToStderr(`Get content from ${contentUris.length} content URIs.`);
+                }
+                const logs = yield this.getContent(logger, contentUris);
+                const sortedLogs = logs.sort(this.auditLogsCompare);
+                logger.log(sortedLogs);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    ensureSubscription(tenantId, contentType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/api/v1.0/${tenantId}/activity/feed/subscriptions/list`,
+                headers: {
+                    accept: 'application/json'
+                },
+                responseType: 'json'
+            };
+            const subscriptions = yield request_1.default.get(requestOptions);
+            if (subscriptions.some(s => s.contentType === contentType && s.status === 'enabled')) {
+                return;
+            }
+            requestOptions.url = `${this.resource}/api/v1.0/${tenantId}/activity/feed/subscriptions/start?contentType=${contentType}`;
+            const subscription = yield request_1.default.post(requestOptions);
+            if (subscription.status !== 'enabled') {
+                throw `Unable to start subscription '${contentType}'`;
+            }
+        });
+    }
+    getContentUris(tenantId, contentType, startTime, endTime) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const contentUris = [];
+            const requestOptions = {
+                url: `${this.resource}/api/v1.0/${tenantId}/activity/feed/subscriptions/content?contentType=${contentType}&startTime=${startTime.toISOString()}&endTime=${endTime.toISOString()}`,
+                headers: {
+                    accept: 'application/json'
+                },
+                responseType: 'json',
+                fullResponse: true
+            };
+            do {
+                const response = yield request_1.default.get(requestOptions);
+                const uris = response.data.map(d => d.contentUri);
+                contentUris.push(...uris);
+                requestOptions.url = response.headers.nextpageuri;
+            } while (requestOptions.url);
+            return contentUris;
+        });
+    }
+    getContent(logger, contentUris) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const logs = [];
+            const batchSize = 30;
+            for (let i = 0; i < contentUris.length; i += batchSize) {
+                const contentUrisBatch = contentUris.slice(i, i + batchSize);
+                if (this.verbose) {
+                    logger.logToStderr(`Retrieving content from next ${contentUrisBatch.length} content URIs. Progress: ${Math.round(i / contentUris.length * 100)}%`);
+                }
+                const batchResult = yield Promise.all(contentUrisBatch.map(uri => request_1.default.get({
+                    url: uri,
+                    headers: {
+                        accept: 'application/json'
+                    },
+                    responseType: 'json'
+                })));
+                batchResult.forEach(res => logs.push(...res));
+            }
+            return logs;
+        });
+    }
+    auditLogsCompare(a, b) {
+        if (a.CreationTime < b.CreationTime) {
+            return -1;
+        }
+        if (a.CreationTime > b.CreationTime) {
+            return 1;
+        }
+        return 0;
+    }
+}
+_PurviewAuditLogListCommand_instances = new WeakSet(), _PurviewAuditLogListCommand_initTelemetry = function _PurviewAuditLogListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            startTime: typeof args.options.startTime !== 'undefined',
+            endTime: typeof args.options.endTime !== 'undefined'
+        });
+    });
+}, _PurviewAuditLogListCommand_initOptions = function _PurviewAuditLogListCommand_initOptions() {
+    this.options.unshift({
+        option: '--contentType <contentType>',
+        autocomplete: this.contentTypeOptions
+    }, {
+        option: '--startTime [startTime]'
+    }, {
+        option: '--endTime [endTime]'
+    });
+}, _PurviewAuditLogListCommand_initValidators = function _PurviewAuditLogListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (this.contentTypeOptions.indexOf(args.options.contentType) === -1) {
+            return `'${args.options.contentType}' is not a valid contentType value. Allowed values: ${this.contentTypeOptions}.`;
+        }
+        if (args.options.startTime) {
+            if (!validation_1.validation.isValidISODateTime(args.options.startTime)) {
+                return `'${args.options.startTime}' is not a valid ISO date time string.`;
+            }
+            const lowerDateLimit = new Date();
+            lowerDateLimit.setDate(lowerDateLimit.getDate() - 7);
+            lowerDateLimit.setHours(lowerDateLimit.getHours() - 1); // Min date is 7 days ago, however there seems to be an 1h margin
+            if (new Date(args.options.startTime) < lowerDateLimit) {
+                return 'startTime value cannot be more than 7 days in the past.';
+            }
+        }
+        if (args.options.endTime) {
+            if (!validation_1.validation.isValidISODateTime(args.options.endTime)) {
+                return `'${args.options.endTime}' is not a valid ISO date time string.`;
+            }
+            if (new Date(args.options.endTime) > new Date()) {
+                return 'endTime value cannot be in the future.';
+            }
+        }
+        if (args.options.startTime && args.options.endTime && new Date(args.options.startTime) >= new Date(args.options.endTime)) {
+            return 'startTime value must be before endTime.';
+        }
+        return true;
+    }));
+};
+module.exports = new PurviewAuditLogListCommand();
+//# sourceMappingURL=auditlog-list.js.map

package/dist/m365/purview/commands.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'purview';
 exports.default = {
     RETENTIONEVENTTYPE_GET: `${prefix} retentioneventtype get`,
+    AUDITLOG_LIST: `${prefix} auditlog list`,
     RETENTIONLABEL_ADD: `${prefix} retentionlabel add`,
     RETENTIONLABEL_GET: `${prefix} retentionlabel get`,
     RETENTIONLABEL_LIST: `${prefix} retentionlabel list`,

package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-add.js

@@ -0,0 +1,95 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SpoApplicationCustomizerAddCommand_instances, _SpoApplicationCustomizerAddCommand_initOptions, _SpoApplicationCustomizerAddCommand_initTelemetry, _SpoApplicationCustomizerAddCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Cli_1 = require("../../../../cli/Cli");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+const spoCustomActionAddCommand = require("../customaction/customaction-add");
+class SpoApplicationCustomizerAddCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.APPLICATIONCUSTOMIZER_ADD;
+    }
+    get description() {
+        return 'Add an application customizer to a site.';
+    }
+    constructor() {
+        super();
+        _SpoApplicationCustomizerAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoApplicationCustomizerAddCommand_instances, "m", _SpoApplicationCustomizerAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoApplicationCustomizerAddCommand_instances, "m", _SpoApplicationCustomizerAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoApplicationCustomizerAddCommand_instances, "m", _SpoApplicationCustomizerAddCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Adding application customizer with title '${args.options.title}' and clientSideComponentId '${args.options.clientSideComponentId}' to the site`);
+            }
+            const options = {
+                webUrl: args.options.webUrl,
+                name: args.options.title,
+                title: args.options.title,
+                clientSideComponentId: args.options.clientSideComponentId,
+                clientSideComponentProperties: args.options.clientSideComponentProperties || '',
+                location: 'ClientSideExtension.ApplicationCustomizer',
+                debug: this.debug,
+                verbose: this.verbose
+            };
+            yield Cli_1.Cli.executeCommand(spoCustomActionAddCommand, { options: Object.assign(Object.assign({}, options), { _: [] }) });
+        });
+    }
+}
+_SpoApplicationCustomizerAddCommand_instances = new WeakSet(), _SpoApplicationCustomizerAddCommand_initOptions = function _SpoApplicationCustomizerAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-t, --title <title>'
+    }, {
+        option: '-u, --webUrl <webUrl>'
+    }, {
+        option: '-i, --clientSideComponentId <clientSideComponentId>'
+    }, {
+        option: '--clientSideComponentProperties [clientSideComponentProperties]'
+    });
+}, _SpoApplicationCustomizerAddCommand_initTelemetry = function _SpoApplicationCustomizerAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            clientSideComponentProperties: typeof args.options.clientSideComponentProperties !== 'undefined'
+        });
+    });
+}, _SpoApplicationCustomizerAddCommand_initValidators = function _SpoApplicationCustomizerAddCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.webUrl) {
+            const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+            if (isValidSharePointUrl !== true) {
+                return isValidSharePointUrl;
+            }
+        }
+        if (!validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        if (args.options.clientSideComponentProperties) {
+            try {
+                JSON.parse(args.options.clientSideComponentProperties);
+            }
+            catch (e) {
+                return `An error has occurred while parsing clientSideComponentProperties: ${e}`;
+            }
+        }
+        return true;
+    }));
+};
+module.exports = new SpoApplicationCustomizerAddCommand();
+//# sourceMappingURL=applicationcustomizer-add.js.map

package/dist/m365/spo/commands.js

@@ -13,6 +13,7 @@ exports.default = {
     APP_TEAMSPACKAGE_DOWNLOAD: `${prefix} app teamspackage download`,
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPGRADE: `${prefix} app upgrade`,
+    APPLICATIONCUSTOMIZER_ADD: `${prefix} applicationcustomizer add`,
     APPPAGE_ADD: `${prefix} apppage add`,
     APPPAGE_SET: `${prefix} apppage set`,
     CDN_GET: `${prefix} cdn get`,

package/dist/utils/planner.js

@@ -44,14 +44,28 @@ exports.planner = {
     getPlansByGroupId(groupId, metadata = 'none') {
         return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, metadata);
     },
+    /**
+     * Get all Planner plans for a specific roster.
+     * @param rosterId Roster ID.
+     */
+    getPlansByRosterId(rosterId, metadata = 'none') {
+        return odata_1.odata.getAllItems(`${graphResource}/beta/planner/rosters/${rosterId}/plans`, metadata);
+    },
     /**
      * Get Planner plan by title in a specific group.
      * @param title Title of the Planner plan. Case insensitive.
-     * @param groupId Owner group ID .
+     * @param groupId Owner group ID.
+     * @param rosterId Roster ID.
      */
-    getPlanByTitle(title, groupId, metadata = 'none') {
+    getPlanByTitle(title, groupId, rosterId, metadata = 'none') {
         return __awaiter(this, void 0, void 0, function* () {
-            const plans = yield this.getPlansByGroupId(groupId, metadata);
+            let plans = [];
+            if (groupId) {
+                plans = yield this.getPlansByGroupId(groupId, metadata);
+            }
+            else if (rosterId) {
+                plans = yield this.getPlansByRosterId(rosterId, metadata);
+            }
             const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
             if (!filteredPlans.length) {
                 throw Error(`The specified plan '${title}' does not exist.`);

package/docs/docs/cmd/planner/plan/plan-get.md

@@ -17,13 +17,21 @@ m365 planner plan get [options]
 : Title of the plan. Specify either `id` or `title` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+: ID of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+: Name of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
 ## Examples
 
 Returns the Microsoft Planner plan with id _gndWOTSK60GfPQfiDDj43JgACDCb_
@@ -44,6 +52,12 @@ Returns the Microsoft Planner plan with title _MyPlan_ for Group _My Planner Gro
 m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
 ```
 
+Returns the Microsoft Planner plan with title _MyPlan_ for Roster _FeMZFDoK8k2oWmuGE-XFHZcAEwtn_
+
+```sh
+m365 planner plan get --title "MyPlan" --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"
+```
+
 ## Response
 
 === "JSON"

package/docs/docs/cmd/planner/plan/plan-list.md

@@ -11,13 +11,21 @@ m365 planner plan list [options]
 ## Options
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: ID of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: Name of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+When using rosterId, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
 ## Examples
 
 Returns a list of Microsoft Planner plans for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
@@ -32,6 +40,12 @@ Returns a list of Microsoft Planner plans for Group _My Planner Group_
 m365 planner plan list --ownerGroupName "My Planner Group"
 ```
 
+Returns a list of Microsoft Planner plans for Roster _FeMZFDoK8k2oWmuGE-XFHZcAEwtn_
+
+```sh
+m365 planner plan list --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"
+```
+
 ## Response
 
 === "JSON"

package/docs/docs/cmd/purview/auditlog/auditlog-list.md

@@ -0,0 +1,123 @@
+# purview auditlog list
+
+List audit logs within your tenant
+
+## Usage
+
+```sh
+m365 purview auditlog list [options]
+```
+
+## Options
+
+`--contentType <contentType>`
+: Content type of logs to retrieve. Possible values: `AzureActiveDirectory`, `Exchange`, `SharePoint`, `General`, `DLP`.
+
+`--startTime [startTime]`
+: Time indicating the **inclusive** start of a time range of content to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z). Start time cannot be more than 7 days in the past. Default value is 24h ago.
+
+`--endTime [endTime]`
+: Time indicating the **exclusive** end of a time range of content to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z). Default value is now.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    Before you can access audit log data, you must enable unified audit logging for your Microsoft 365 tenant. For instructions, check out the page [Turn auditing on or off](https://learn.microsoft.com/en-us/microsoft-365/compliance/audit-log-enable-disable).
+
+!!! important
+    When running this command for the first time for a certain content type, a subscription for this content type is created. It can take up to 12 hours for the first content blobs to become available for that subscription.
+
+!!! tip
+    Retrieving audit logs is an intensive process, especially for large or active tenants. In this case it may take some time to retrieve all audit logs. It can be useful to add the `--verbose` option to your command to view the command progress.
+
+When you specify a value for `contentType`, consider the following:
+
+- `AzureActiveDirectory` includes all Azure AD audit logs.
+- `Exchange` includes all Exchange audit logs.
+- `SharePoint` includes all SharePoint audit logs.
+- `General` includes all other workloads not included in the previous content types.
+- `DLP` DLP events only for all workloads.
+
+## Examples
+
+List all SharePoint audit logs for the past 24 hours
+
+```sh
+m365 purview auditlog list --contentType SharePoint
+```
+
+List all SharePoint audit logs within a specific time frame
+
+```sh
+m365 purview auditlog list --contentType SharePoint --startTime "2023-01-01T00:00:00Z" --endTime "2023-01-03T09:00:00Z"
+```
+
+Get all SharePoint audit logs within a specific time frame and save the logs to a file
+
+```sh
+m365 purview auditlog list --contentType SharePoint --startTime "2023-01-01T00:00:00Z" --endTime "2023-01-01T12:00:00Z" > auditLogs.json
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "AppAccessContext": {
+            "ClientAppId": "94bfad6e-a0b3-4eb9-8e2b-83eeb335de28",
+            "CorrelationId": "040d86a0-f096-5000-d4b4-baac627b75f3",
+            "UniqueTokenId": "5CVDGmrynkGYBkY-MPynAA"
+        },
+        "CreationTime": "2023-01-10T00:00:00",
+        "Id": "4d671836-c772-4169-55f9-08dae745c839",
+        "Operation": "ListItemViewed",
+        "OrganizationId": "6e40c2aa-0565-4013-b38c-d5e6f0c42993",
+        "RecordType": 36,
+        "UserKey": "i:0i.t|00000003-0000-0ff1-ce00-000000000000|app@sharepoint",
+        "UserType": 0,
+        "Version": 1,
+        "Workload": "SharePoint",
+        "ClientIP": "168.63.104.32",
+        "ObjectId": "https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000",
+        "UserId": "john.doe@contoso.com",
+        "ApplicationId": "94bfad6e-a0b3-4eb9-8e2b-83eeb335de28",
+        "CorrelationId": "040d86a0-f096-5000-d4b4-baac627b75f3",
+        "EventSource": "SharePoint",
+        "ItemType": "ListItem",
+        "ListId": "cae414a1-ac65-4a90-844e-651d7a1e463d",
+        "ListItemUniqueId": "2d364471-4d27-4186-b139-072c8225ee4a",
+        "Site": "51f5a236-b2e5-4a6d-a81d-13d188610155",
+        "UserAgent": "NONISV|Contoso|ContosoApp/1.0",
+        "WebId": "38ab94aa-a904-4c2b-8467-4be0e457f97b",
+        "CustomizedDoclib": false,
+        "FromApp": false,
+        "ItemCount": 192,
+        "ListBaseTemplateType": "100",
+        "ListBaseType": "GenericList",
+        "ListColor": "",
+        "ListIcon": "",
+        "Source": "Unknown",
+        "TemplateTypeId": "",
+        "ListTitle": "cae414a1-ac65-4a90-844e-651d7a1e463d"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```txt
+    CreationTime         UserId                Operation       ObjectId                                                                                          
+    -------------------  --------------------  --------------  --------------------------------------------------------------------------------------------------
+    2023-01-10T00:00:00  john.doe@contoso.com  ListItemViewed  https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000
+    ```
+
+=== "CSV"
+
+    ```csv
+    CreationTime,UserId,Operation,ObjectId
+    2023-01-10T00:00:00,john.doe@contoso.com,ListItemViewed,https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000
+    ```

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-add.md

@@ -0,0 +1,56 @@
+# spo applicationcustomizer add
+
+Add an application customizer to a site.
+
+## Usage
+
+```sh
+m365 spo applicationcustomizer add [options]
+```
+
+## Options
+
+`-t, --title <title>`
+: The title of the application customizer.
+
+`-u, --webUrl <webUrl>`
+: URL of the site.
+
+`-i, --clientSideComponentId <clientSideComponentId>`
+: Client-side component ID of the application customizer (GUID).
+
+`--clientSideComponentProperties [clientSideComponentProperties]`
+: JSON string with application customizer properties
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treat quotes differently. For example, this is how an application customizer can be created from the Windows cmd.exe:
+
+```sh
+m365 spo applicationcustomizer add --webUrl https://contoso.sharepoint.com/sites/test --title "YourAppCustomizer" --clientSideComponentId b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
+```
+
+Note, how the clientSideComponentProperties option has escaped double quotes `'{\"testMessage\":\"Test message\"}'` compared to execution from bash `'{"testMessage":"Test message"}'`.
+
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--clientSideComponentProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
+## Examples
+
+Adds an application customizer to the sales site.
+
+```sh
+m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
+Adds an application customizer to the sales site with some properties.
+
+```sh
+m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
+## Response
+
+The command won't return a response on success.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.3.0-beta.a991329",
+  "version": "6.3.0-beta.ac7b232",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",