@pnp/cli-microsoft365 6.2.0 → 6.3.0-beta.3f7129c

package/dist/m365/spo/commands/site/site-apppermission-add.js

@@ -17,6 +17,7 @@ var _SpoSiteAppPermissionAddCommand_instances, _SpoSiteAppPermissionAddCommand_i
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
 const formatting_1 = require("../../../../utils/formatting");
+const spo_1 = require("../../../../utils/spo");
 const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -37,19 +38,6 @@ class SpoSiteAppPermissionAddCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _SpoSiteAppPermissionAddCommand_instances, "m", _SpoSiteAppPermissionAddCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _SpoSiteAppPermissionAddCommand_instances, "m", _SpoSiteAppPermissionAddCommand_initOptionSets).call(this);
     }
-    getSpoSiteId(args) {
-        const url = new URL(args.options.siteUrl);
-        const requestOptions = {
-            url: `${this.resource}/v1.0/sites/${url.hostname}:${url.pathname}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((site) => site.id);
-    }
     getAppInfo(args) {
         if (args.options.appId && args.options.appDisplayName) {
             return Promise.resolve({
@@ -136,7 +124,7 @@ class SpoSiteAppPermissionAddCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                this.siteId = yield this.getSpoSiteId(args);
+                this.siteId = yield spo_1.spo.getSpoGraphSiteId(args.options.siteUrl);
                 const appInfo = yield this.getAppInfo(args);
                 let permission = yield this.addPermissions(args, appInfo);
                 if (this.roleNeedsElevation(args.options.permission)) {

package/dist/m365/spo/commands/site/site-apppermission-get.js

@@ -16,6 +16,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoSiteAppPermissionGetCommand_instances, _SpoSiteAppPermissionGetCommand_initOptions, _SpoSiteAppPermissionGetCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const spo_1 = require("../../../../utils/spo");
 const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -32,19 +33,6 @@ class SpoSiteAppPermissionGetCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _SpoSiteAppPermissionGetCommand_instances, "m", _SpoSiteAppPermissionGetCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoSiteAppPermissionGetCommand_instances, "m", _SpoSiteAppPermissionGetCommand_initValidators).call(this);
     }
-    getSpoSiteId(args) {
-        const url = new URL(args.options.siteUrl);
-        const requestOptions = {
-            url: `${this.resource}/v1.0/sites/${url.hostname}:${url.pathname}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((site) => site.id);
-    }
     getApplicationPermission(args, siteId) {
         const requestOptions = {
             url: `${this.resource}/v1.0/sites/${siteId}/permissions/${args.options.id}`,
@@ -58,7 +46,7 @@ class SpoSiteAppPermissionGetCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const siteId = yield this.getSpoSiteId(args);
+                const siteId = yield spo_1.spo.getSpoGraphSiteId(args.options.siteUrl);
                 const permissionObject = yield this.getApplicationPermission(args, siteId);
                 const transposed = [];
                 permissionObject.grantedToIdentities.forEach((permissionEntity) => {

package/dist/m365/spo/commands/site/site-apppermission-list.js

@@ -16,6 +16,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoSiteAppPermissionListCommand_instances, _SpoSiteAppPermissionListCommand_initTelemetry, _SpoSiteAppPermissionListCommand_initOptions, _SpoSiteAppPermissionListCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const spo_1 = require("../../../../utils/spo");
 const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -34,19 +35,6 @@ class SpoSiteAppPermissionListCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _SpoSiteAppPermissionListCommand_instances, "m", _SpoSiteAppPermissionListCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoSiteAppPermissionListCommand_instances, "m", _SpoSiteAppPermissionListCommand_initValidators).call(this);
     }
-    getSpoSiteId(args) {
-        const url = new URL(args.options.siteUrl);
-        const requestOptions = {
-            url: `${this.resource}/v1.0/sites/${url.hostname}:${url.pathname}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((site) => site.id);
-    }
     getFilteredPermissions(args, permissions) {
         let filterProperty = 'displayName';
         let filterValue = args.options.appDisplayName;
@@ -95,7 +83,7 @@ class SpoSiteAppPermissionListCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                this.siteId = yield this.getSpoSiteId(args);
+                this.siteId = yield spo_1.spo.getSpoGraphSiteId(args.options.siteUrl);
                 const permRes = yield this.getPermissions();
                 let permissions = permRes.value;
                 if (args.options.appId || args.options.appDisplayName) {

package/dist/m365/spo/commands/site/site-apppermission-remove.js

@@ -17,6 +17,7 @@ var _SpoSiteAppPermissionRemoveCommand_instances, _SpoSiteAppPermissionRemoveCom
 Object.defineProperty(exports, "__esModule", { value: true });
 const Cli_1 = require("../../../../cli/Cli");
 const request_1 = require("../../../../request");
+const spo_1 = require("../../../../utils/spo");
 const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -36,19 +37,6 @@ class SpoSiteAppPermissionRemoveCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _SpoSiteAppPermissionRemoveCommand_instances, "m", _SpoSiteAppPermissionRemoveCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _SpoSiteAppPermissionRemoveCommand_instances, "m", _SpoSiteAppPermissionRemoveCommand_initOptionSets).call(this);
     }
-    getSpoSiteId(args) {
-        const url = new URL(args.options.siteUrl);
-        const requestOptions = {
-            url: `${this.resource}/v1.0/sites/${url.hostname}:${url.pathname}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((site) => site.id);
-    }
     getPermissions() {
         const requestOptions = {
             url: `${this.resource}/v1.0/sites/${this.siteId}/permissions`,
@@ -98,7 +86,7 @@ class SpoSiteAppPermissionRemoveCommand extends GraphCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const removeSiteAppPermission = () => __awaiter(this, void 0, void 0, function* () {
                 try {
-                    this.siteId = yield this.getSpoSiteId(args);
+                    this.siteId = yield spo_1.spo.getSpoGraphSiteId(args.options.siteUrl);
                     const permissionIdsToRemove = yield this.getPermissionIds(args);
                     const tasks = [];
                     for (const permissionId of permissionIdsToRemove) {

package/dist/m365/spo/commands/site/site-apppermission-set.js

@@ -16,6 +16,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoSiteAppPermissionSetCommand_instances, _SpoSiteAppPermissionSetCommand_initTelemetry, _SpoSiteAppPermissionSetCommand_initOptions, _SpoSiteAppPermissionSetCommand_initValidators, _SpoSiteAppPermissionSetCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const spo_1 = require("../../../../utils/spo");
 const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -36,19 +37,6 @@ class SpoSiteAppPermissionSetCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _SpoSiteAppPermissionSetCommand_instances, "m", _SpoSiteAppPermissionSetCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _SpoSiteAppPermissionSetCommand_instances, "m", _SpoSiteAppPermissionSetCommand_initOptionSets).call(this);
     }
-    getSpoSiteId(args) {
-        const url = new URL(args.options.siteUrl);
-        const siteRequestOptions = {
-            url: `${this.resource}/v1.0/sites/${url.hostname}:${url.pathname}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(siteRequestOptions)
-            .then((site) => site.id);
-    }
     getFilteredPermissions(args, permissions) {
         let filterProperty = 'displayName';
         let filterValue = args.options.appDisplayName;
@@ -85,7 +73,7 @@ class SpoSiteAppPermissionSetCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                this.siteId = yield this.getSpoSiteId(args);
+                this.siteId = yield spo_1.spo.getSpoGraphSiteId(args.options.siteUrl);
                 const sitePermissionId = yield this.getPermission(args);
                 const requestOptions = {
                     url: `${this.resource}/v1.0/sites/${this.siteId}/permissions/${sitePermissionId}`,

package/dist/m365/spo/commands/web/web-set.js

@@ -62,6 +62,9 @@ class SpoWebSetCommand extends SpoCommand_1.default {
             if (typeof args.options.footerEnabled !== 'undefined') {
                 payload.FooterEnabled = args.options.footerEnabled;
             }
+            if (typeof args.options.navAudienceTargetingEnabled !== 'undefined') {
+                payload.NavAudienceTargetingEnabled = args.options.navAudienceTargetingEnabled;
+            }
             if (typeof args.options.searchScope !== 'undefined') {
                 const searchScope = args.options.searchScope.toLowerCase();
                 payload.SearchScope = SpoWebSetCommand.searchScopeOptions.indexOf(searchScope);
@@ -96,11 +99,12 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
             description: typeof args.options.description !== 'undefined',
             headerEmphasis: typeof args.options.headerEmphasis !== 'undefined',
             headerLayout: typeof args.options.headerLayout !== 'undefined',
-            megaMenuEnabled: args.options.megaMenuEnabled,
+            megaMenuEnabled: typeof args.options.megaMenuEnabled !== 'undefined',
             siteLogoUrl: typeof args.options.siteLogoUrl !== 'undefined',
             title: typeof args.options.title !== 'undefined',
-            quickLaunchEnabled: args.options.quickLaunchEnabled,
-            footerEnabled: args.options.footerEnabled,
+            quickLaunchEnabled: typeof args.options.quickLaunchEnabled !== 'undefined',
+            footerEnabled: typeof args.options.footerEnabled !== 'undefined',
+            navAudienceTargetingEnabled: typeof args.options.navAudienceTargetingEnabled !== 'undefined',
             searchScope: args.options.searchScope !== 'undefined'
         });
         this.trackUnknownOptions(this.telemetryProperties, args.options);
@@ -129,12 +133,15 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
     }, {
         option: '--footerEnabled [footerEnabled]',
         autocomplete: ['true', 'false']
+    }, {
+        option: '--navAudienceTargetingEnabled [navAudienceTargetingEnabled]',
+        autocomplete: ['true', 'false']
     }, {
         option: '--searchScope [searchScope]',
         autocomplete: SpoWebSetCommand.searchScopeOptions
     });
 }, _SpoWebSetCommand_initTypes = function _SpoWebSetCommand_initTypes() {
-    this.types.boolean.push('megaMenuEnabled', 'footerEnabled', 'quickLaunchEnabled');
+    this.types.boolean.push('megaMenuEnabled', 'footerEnabled', 'quickLaunchEnabled', 'navAudienceTargetingEnabled');
 }, _SpoWebSetCommand_initValidators = function _SpoWebSetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
         const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.url);

package/dist/m365/spo/commands.js

@@ -167,6 +167,7 @@ exports.default = {
     NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
     NAVIGATION_NODE_LIST: `${prefix} navigation node list`,
     NAVIGATION_NODE_REMOVE: `${prefix} navigation node remove`,
+    NAVIGATION_NODE_SET: `${prefix} navigation node set`,
     ORGASSETSLIBRARY_ADD: `${prefix} orgassetslibrary add`,
     ORGASSETSLIBRARY_LIST: `${prefix} orgassetslibrary list`,
     ORGASSETSLIBRARY_REMOVE: `${prefix} orgassetslibrary remove`,

package/dist/m365/teams/commands/chat/chat-list.js

@@ -41,14 +41,14 @@ class TeamsChatListCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
-            if (isAppOnlyAuth && !args.options.userId && !args.options.userName) {
+            const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAccessToken && !args.options.userId && !args.options.userName) {
                 throw `The option 'userId' or 'userName' is required when obtaining chats using app only permissions`;
             }
-            else if (!isAppOnlyAuth && (args.options.userId || args.options.userName)) {
+            else if (!isAppOnlyAccessToken && (args.options.userId || args.options.userName)) {
                 throw `The options 'userId' or 'userName' cannot be used when obtaining chats using delegated permissions`;
             }
-            let requestUrl = `${this.resource}/v1.0/${!isAppOnlyAuth ? 'me' : `users/${args.options.userId || args.options.userName}`}/chats`;
+            let requestUrl = `${this.resource}/v1.0/${!isAppOnlyAccessToken ? 'me' : `users/${args.options.userId || args.options.userName}`}/chats`;
             if (args.options.type) {
                 requestUrl += `?$filter=chatType eq '${args.options.type}'`;
             }

package/dist/m365/teams/commands/meeting/meeting-attendancereport-list.js

@@ -42,19 +42,19 @@ class TeamsMeetingAttendancereportListCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
-            if (isAppOnlyAuth && !args.options.userId && !args.options.userName && !args.options.email) {
+            const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAccessToken && !args.options.userId && !args.options.userName && !args.options.email) {
                 this.handleError(`The option 'userId', 'userName' or 'email' is required when retrieving meeting attendance report using app only permissions`);
             }
-            else if (!isAppOnlyAuth && (args.options.userId || args.options.userName || args.options.email)) {
+            else if (!isAppOnlyAccessToken && (args.options.userId || args.options.userName || args.options.email)) {
                 this.handleError(`The options 'userId', 'userName' and 'email' cannot be used when retrieving meeting attendance reports using delegated permissions`);
             }
             try {
                 if (this.verbose) {
-                    logger.logToStderr(`Retrieving attendance report for ${isAppOnlyAuth ? 'specific user' : 'currently logged in user'}`);
+                    logger.logToStderr(`Retrieving attendance report for ${isAppOnlyAccessToken ? 'specific user' : 'currently logged in user'}`);
                 }
                 let requestUrl = `${this.resource}/v1.0/`;
-                if (isAppOnlyAuth) {
+                if (isAppOnlyAccessToken) {
                     requestUrl += 'users/';
                     if (args.options.userId) {
                         requestUrl += args.options.userId;

package/dist/m365/teams/commands/meeting/meeting-get.js

@@ -53,23 +53,23 @@ class TeamsMeetingGetCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
-            if (isAppOnlyAuth) {
+            const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAccessToken) {
                 if (!args.options.userId && !args.options.userName && !args.options.email) {
                     this.handleError(`The option 'userId', 'userName' or 'email' is required when retrieving meetings using app only permissions`);
                 }
             }
             else {
-                if (!isAppOnlyAuth && (args.options.userId || args.options.userName || args.options.email)) {
+                if (!isAppOnlyAccessToken && (args.options.userId || args.options.userName || args.options.email)) {
                     this.handleError(`The options 'userId', 'userName' and 'email' cannot be used when retrieving meetings using delegated permissions`);
                 }
             }
             if (this.verbose) {
-                logger.logToStderr(`Retrieving meeting for ${isAppOnlyAuth ? 'specific user' : 'currently logged in user'}`);
+                logger.logToStderr(`Retrieving meeting for ${isAppOnlyAccessToken ? 'specific user' : 'currently logged in user'}`);
             }
             try {
                 let requestUrl = `${this.resource}/v1.0/`;
-                if (isAppOnlyAuth) {
+                if (isAppOnlyAccessToken) {
                     requestUrl += 'users/';
                     if (args.options.userId) {
                         requestUrl += args.options.userId;

package/dist/m365/teams/commands/meeting/meeting-list.js

@@ -22,6 +22,7 @@ const commands_1 = require("../../commands");
 const odata_1 = require("../../../../utils/odata");
 const validation_1 = require("../../../../utils/validation");
 const AadUserGetCommand = require("../../../aad/commands/user/user-get");
+const accessToken_1 = require("../../../../utils/accessToken");
 class TeamsMeetingListCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.MEETING_LIST;
@@ -42,12 +43,12 @@ class TeamsMeetingListCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const isAppOnlyAuth = Auth_1.Auth.isAppOnlyAuth(Auth_1.default.service.accessTokens[this.resource].accessToken);
+                const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
                 if (this.verbose) {
-                    logger.logToStderr(`Retrieving meetings for ${isAppOnlyAuth ? 'specific user' : 'currently logged in user'}`);
+                    logger.logToStderr(`Retrieving meetings for ${isAppOnlyAccessToken ? 'specific user' : 'currently logged in user'}`);
                 }
                 let requestUrl = `${this.resource}/v1.0/`;
-                if (isAppOnlyAuth) {
+                if (isAppOnlyAccessToken) {
                     if (!args.options.userId && !args.options.userName && !args.options.email) {
                         throw `The option 'userId', 'userName' or 'email' is required when retrieving meetings using app only permissions`;
                     }

package/dist/utils/accessToken.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.accessToken = void 0;
 exports.accessToken = {
     isAppOnlyAccessToken(accessToken) {
-        let isAppOnlyAccessToken = false;
+        let isAppOnlyAccessToken;
         if (!accessToken || accessToken.length === 0) {
             return isAppOnlyAccessToken;
         }

package/dist/utils/spo.js

@@ -1,4 +1,13 @@
 "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());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spo = void 0;
 const url = require("url");
@@ -237,6 +246,24 @@ exports.spo = {
             });
         });
     },
+    /**
+     * Returns the Graph id of a site
+     * @param webUrl web url e.g. https://contoso.sharepoint.com/sites/site1
+     */
+    getSpoGraphSiteId(webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = new URL(webUrl);
+            const requestOptions = {
+                url: `https://graph.microsoft.com/v1.0/sites/${url.hostname}:${url.pathname}?$select=id`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const result = yield request_1.default.get(requestOptions);
+            return result.id;
+        });
+    },
     /**
      * Ensures the folder path exists
      * @param webFullUrl web full url e.g. https://contoso.sharepoint.com/sites/site1

package/docs/docs/cmd/aad/app/app-list.md

@@ -23,6 +23,7 @@ m365 aad app list
 ## Response
 
 === "JSON"
+
     ```json
     [
       {
@@ -136,6 +137,7 @@ m365 aad app list
     ```
 
 === "Text"
+
     ```text
     appId                                 id                                    displayName                                                              signInAudience
     ------------------------------------  ------------------------------------  -----------------------------------------------------------------------  ----------------------------------
@@ -143,6 +145,7 @@ m365 aad app list
     ```
 
 === "CSV"
+
     ```csv
     appId,id,displayName,signInAudience
     61ed4fab-a861-4307-bb87-a6a53dbe39f5,ff2798f7-1c7a-4607-8a7b-3d5e0c18c756,TestAppPermissions,AzureADMyOrg

package/docs/docs/cmd/aad/user/user-set.md

@@ -83,6 +83,6 @@ Change password of the currently logged in user
 m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
 ```
 
-### Response
+## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/flow/run/run-list.md

@@ -16,6 +16,15 @@ m365 flow run list [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
+`--status [status]` 
+: Filter the results to only flow runs with a given status: `Succeeded`, `Running`, `Failed` or `Cancelled`. By default all flow runs are listed.
+
+`--triggerStartTime [triggerStartTime]`
+: Time indicating the inclusive start of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
+`--triggerEndTime [triggerEndTime]`
+: Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -35,6 +44,18 @@ List runs of the specified Microsoft Flow
 m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
 ```
 
+List runs of the specified Microsoft Flow with a specific status
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --status Running
+```
+
+List runs of the specified Microsoft Flow between a specific time range
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --triggerStartTime 2023-01-21T18:19:00Z --triggerEndTime 2023-01-22T00:00:00Z
+```
+
 ## Response
 
 ### Standard response

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

@@ -27,6 +27,10 @@ m365 planner plan remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+If you wish to delete a Planner plan contained within a Planner Roster, you'll have to remove the roster using [planner roster remove](../roster/roster-remove.md).
+
 ## Examples
 
 Removes the Microsoft Planner plan by ID

package/docs/docs/cmd/planner/roster/roster-add.md

@@ -0,0 +1,60 @@
+# planner roster add
+
+Creates a new Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster add [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    The Roster will be automatically deleted when it doesn't contain a plan 24 hours after its creation. Membership information will be completely erased within 30 days of this deletion.
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! important
+    To be able to create a new Roster, the Planner Roster creation tenant setting should be enabled. Use the [planner tenant settings list](../tenant/tenant-settings-list.md) command to check if this setting is enabled for your tenant.
+
+## Examples
+
+Creates a new Microsoft Planner Roster
+
+```sh
+m365 planner roster add
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "e6fmvM_yi0OJgvmepE5uj5cAE6qX",
+      "assignedSensitivityLabel": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    assignedSensitivityLabel: null
+    id                      : e6fmvM_yi0OJgvmepE5uj5cAE6qX
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,assignedSensitivityLabel
+    e6fmvM_yi0OJgvmepE5uj5cAE6qX,
+    ```
+    
+## Additional information
+Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/planner/roster/roster-remove.md

@@ -0,0 +1,48 @@
+# planner roster remove
+
+Removes a Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster remove [options]
+```
+
+## Options
+
+`--id <id>`
+: ID of the Planner Roster.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    Deleting a Planner Roster will also delete the plan within the Roster.
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Removes a Planner Roster
+
+```sh
+m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd
+```
+
+Removes a Planner Roster without confirmation prompt
+
+```sh
+m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --confirm
+```
+
+## Response
+
+The command won't return a response on success.
+
+## Additional information
+Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md

@@ -14,10 +14,10 @@ m365 spo listitem attachment list [options]
 URL of the site from which the item should be retrieved
 
 `--listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`

package/docs/docs/cmd/spo/listitem/listitem-isrecord.md

@@ -17,10 +17,10 @@ m365 spo listitem isrecord [options]
 : The ID of the list item to check if it is a record
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`