@pnp/cli-microsoft365 6.8.0-beta.74dea8a → 6.8.0-beta.85a1ca9

package/dist/m365/spo/commands/tenant/tenant-commandset-remove.js

@@ -0,0 +1,152 @@
+"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 _SpoTenantCommandSetRemoveCommand_instances, _SpoTenantCommandSetRemoveCommand_initTelemetry, _SpoTenantCommandSetRemoveCommand_initOptions, _SpoTenantCommandSetRemoveCommand_initValidators, _SpoTenantCommandSetRemoveCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Cli_1 = require("../../../../cli/Cli");
+const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+const odata_1 = require("../../../../utils/odata");
+const spo_1 = require("../../../../utils/spo");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoTenantCommandSetRemoveCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_COMMANDSET_REMOVE;
+    }
+    get description() {
+        return 'Removes a ListView Command Set that is installed tenant wide.';
+    }
+    constructor() {
+        super();
+        _SpoTenantCommandSetRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetRemoveCommand_instances, "m", _SpoTenantCommandSetRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetRemoveCommand_instances, "m", _SpoTenantCommandSetRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetRemoveCommand_instances, "m", _SpoTenantCommandSetRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetRemoveCommand_instances, "m", _SpoTenantCommandSetRemoveCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (args.options.confirm) {
+                    return yield this.removeTenantCommandSet(logger, args);
+                }
+                const result = yield Cli_1.Cli.prompt({
+                    type: 'confirm',
+                    name: 'continue',
+                    default: false,
+                    message: `Are you sure you want to remove the tenant commandset ${args.options.id || args.options.title || args.options.clientSideComponentId}?`
+                });
+                if (result.continue) {
+                    yield this.removeTenantCommandSet(logger, args);
+                }
+            }
+            catch (err) {
+                logger.log(err);
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    removeTenantCommandSet(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const appCatalogUrl = yield spo_1.spo.getTenantAppCatalogUrl(logger, this.debug);
+            if (!appCatalogUrl) {
+                throw 'No app catalog URL found';
+            }
+            const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(appCatalogUrl, '/lists/TenantWideExtensions');
+            const requestUrl = `${appCatalogUrl}/_api/web/GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')`;
+            const id = yield this.getTenantCommandSetId(logger, args, requestUrl);
+            if (this.verbose) {
+                logger.logToStderr(`Removing tenant command set ${args.options.id || args.options.title || args.options.clientSideComponentId}`);
+            }
+            const requestOptions = {
+                url: `${requestUrl}/items(${id})`,
+                method: 'POST',
+                headers: {
+                    'X-HTTP-Method': 'DELETE',
+                    'If-Match': '*',
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
+    getTenantCommandSetId(logger, args, requestUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Getting the tenant command set ${args.options.id || args.options.title || args.options.clientSideComponentId}`);
+            }
+            let filter = '';
+            if (args.options.title) {
+                filter = `Title eq '${args.options.title}'`;
+            }
+            else if (args.options.id) {
+                filter = `Id eq ${args.options.id}`;
+            }
+            else {
+                filter = `TenantWideExtensionComponentId eq '${args.options.clientSideComponentId}'`;
+            }
+            const listItemInstances = yield odata_1.odata.getAllItems(`${requestUrl}/items?$filter=startswith(TenantWideExtensionLocation,'ClientSideExtension.ListViewCommandSet') and ${filter}`);
+            if (listItemInstances.length === 0) {
+                throw 'The specified command set was not found';
+            }
+            if (listItemInstances.length > 1) {
+                throw `Multiple command sets with ${args.options.title || args.options.clientSideComponentId} were found. Please disambiguate (IDs): ${listItemInstances.map(item => item.Id).join(', ')}`;
+            }
+            return listItemInstances[0].Id;
+        });
+    }
+}
+_SpoTenantCommandSetRemoveCommand_instances = new WeakSet(), _SpoTenantCommandSetRemoveCommand_initTelemetry = function _SpoTenantCommandSetRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            title: typeof args.options.title !== 'undefined',
+            id: typeof args.options.id !== 'undefined',
+            clientSideComponentId: typeof args.options.clientSideComponentId !== 'undefined',
+            confirm: !!args.options.confirm
+        });
+    });
+}, _SpoTenantCommandSetRemoveCommand_initOptions = function _SpoTenantCommandSetRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-t, --title [title]'
+    }, {
+        option: '-i, --id [id]'
+    }, {
+        option: '-c, --clientSideComponentId  [clientSideComponentId]'
+    }, {
+        option: '--confirm'
+    });
+}, _SpoTenantCommandSetRemoveCommand_initValidators = function _SpoTenantCommandSetRemoveCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.id) {
+            const id = parseInt(args.options.id);
+            if (isNaN(id)) {
+                return `${args.options.id} is not a valid list item ID`;
+            }
+        }
+        if (args.options.clientSideComponentId &&
+            !validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        return true;
+    }));
+}, _SpoTenantCommandSetRemoveCommand_initOptionSets = function _SpoTenantCommandSetRemoveCommand_initOptionSets() {
+    this.optionSets.push({ options: ['title', 'id', 'clientSideComponentId'] });
+};
+module.exports = new SpoTenantCommandSetRemoveCommand();
+//# sourceMappingURL=tenant-commandset-remove.js.map

package/dist/m365/spo/commands/tenant/tenant-commandset-set.js

@@ -0,0 +1,203 @@
+"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 _SpoTenantCommandSetSetCommand_instances, _SpoTenantCommandSetSetCommand_initTelemetry, _SpoTenantCommandSetSetCommand_initOptions, _SpoTenantCommandSetSetCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+const spo_1 = require("../../../../utils/spo");
+class SpoTenantCommandSetSetCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_COMMANDSET_SET;
+    }
+    get description() {
+        return 'Updates a ListView Command Set that is installed tenant wide.';
+    }
+    constructor() {
+        super();
+        _SpoTenantCommandSetSetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetSetCommand_instances, "m", _SpoTenantCommandSetSetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetSetCommand_instances, "m", _SpoTenantCommandSetSetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetSetCommand_instances, "m", _SpoTenantCommandSetSetCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const appCatalogUrl = yield spo_1.spo.getTenantAppCatalogUrl(logger, this.debug);
+                if (!appCatalogUrl) {
+                    throw 'No app catalog URL found';
+                }
+                const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(appCatalogUrl, '/lists/TenantWideExtensions');
+                const listItem = yield this.getListItemById(logger, appCatalogUrl, listServerRelativeUrl, args.options.id);
+                if (listItem.TenantWideExtensionLocation.indexOf("ClientSideExtension.ListViewCommandSet") === -1) {
+                    throw 'The item is not a ListViewCommandSet';
+                }
+                yield this.updateTenantWideExtension(appCatalogUrl, args.options, listServerRelativeUrl, logger);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    getListItemById(logger, webUrl, listServerRelativeUrl, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Getting the list item by id ${id}`);
+            }
+            const reqOptions = {
+                url: `${webUrl}/_api/web/GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')/Items(${id})`,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            return yield request_1.default.get(reqOptions);
+        });
+    }
+    updateTenantWideExtension(appCatalogUrl, options, listServerRelativeUrl, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Updating tenant wide extension to the TenantWideExtensions list');
+            }
+            const formValues = [];
+            if (options.newTitle !== undefined) {
+                formValues.push({
+                    FieldName: 'Title',
+                    FieldValue: options.newTitle
+                });
+            }
+            if (options.clientSideComponentId !== undefined) {
+                formValues.push({
+                    FieldName: 'TenantWideExtensionComponentId',
+                    FieldValue: options.clientSideComponentId
+                });
+            }
+            if (options.location !== undefined) {
+                formValues.push({
+                    FieldName: 'TenantWideExtensionLocation',
+                    FieldValue: this.getLocation(options.location)
+                });
+            }
+            if (options.listType !== undefined) {
+                formValues.push({
+                    FieldName: 'TenantWideExtensionListTemplate',
+                    FieldValue: this.getListTemplate(options.listType)
+                });
+            }
+            if (options.clientSideComponentProperties !== undefined) {
+                formValues.push({
+                    FieldName: 'TenantWideExtensionComponentProperties',
+                    FieldValue: options.clientSideComponentProperties
+                });
+            }
+            if (options.webTemplate !== undefined) {
+                formValues.push({
+                    FieldName: 'TenantWideExtensionWebTemplate',
+                    FieldValue: options.webTemplate
+                });
+            }
+            const requestOptions = {
+                url: `${appCatalogUrl}/_api/web/GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')/Items(${options.id})/ValidateUpdateListItem()`,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                data: {
+                    formValues: formValues
+                },
+                responseType: 'json'
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
+    getLocation(location) {
+        switch (location) {
+            case 'Both':
+                return 'ClientSideExtension.ListViewCommandSet';
+            case 'ContextMenu':
+                return 'ClientSideExtension.ListViewCommandSet.ContextMenu';
+            default:
+                return 'ClientSideExtension.ListViewCommandSet.CommandBar';
+        }
+    }
+    getListTemplate(listTemplate) {
+        switch (listTemplate) {
+            case 'SitePages':
+                return '119';
+            case 'Library':
+                return '101';
+            default:
+                return '100';
+        }
+    }
+}
+_SpoTenantCommandSetSetCommand_instances = new WeakSet(), _SpoTenantCommandSetSetCommand_initTelemetry = function _SpoTenantCommandSetSetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            newTitle: typeof args.options.newTitle !== 'undefined',
+            listType: args.options.listType,
+            clientSideComponentId: typeof args.options.clientSideComponentId !== 'undefined',
+            clientSideComponentProperties: typeof args.options.clientSideComponentProperties !== 'undefined',
+            webTemplate: typeof args.options.webTemplate !== 'undefined',
+            location: args.options.location
+        });
+    });
+}, _SpoTenantCommandSetSetCommand_initOptions = function _SpoTenantCommandSetSetCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --id <id>'
+    }, {
+        option: '-t, --newTitle [newTitle]'
+    }, {
+        option: '-l, --listType [listType]',
+        autocomplete: SpoTenantCommandSetSetCommand.listTypes
+    }, {
+        option: '-i, --clientSideComponentId [clientSideComponentId]'
+    }, {
+        option: '-p, --clientSideComponentProperties [clientSideComponentProperties]'
+    }, {
+        option: '-w, --webTemplate [webTemplate]'
+    }, {
+        option: '--location [location]',
+        autocomplete: SpoTenantCommandSetSetCommand.locations
+    });
+}, _SpoTenantCommandSetSetCommand_initValidators = function _SpoTenantCommandSetSetCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!args.options.newTitle &&
+            !args.options.listType &&
+            !args.options.clientSideComponentId &&
+            !args.options.clientSideComponentProperties &&
+            !args.options.webTemplate &&
+            !args.options.location) {
+            return 'Specify at least one property to update';
+        }
+        if (args.options.clientSideComponentId && !validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        if (args.options.listType && SpoTenantCommandSetSetCommand.listTypes.indexOf(args.options.listType) < 0) {
+            return `${args.options.listType} is not a valid list type. Allowed values are ${SpoTenantCommandSetSetCommand.listTypes.join(', ')}`;
+        }
+        if (args.options.location && SpoTenantCommandSetSetCommand.locations.indexOf(args.options.location) < 0) {
+            return `${args.options.location} is not a valid location. Allowed values are ${SpoTenantCommandSetSetCommand.locations.join(', ')}`;
+        }
+        return true;
+    }));
+};
+SpoTenantCommandSetSetCommand.listTypes = ['List', 'Library', 'SitePages'];
+SpoTenantCommandSetSetCommand.locations = ['ContextMenu', 'CommandBar', 'Both'];
+module.exports = new SpoTenantCommandSetSetCommand();
+//# sourceMappingURL=tenant-commandset-set.js.map

package/dist/m365/spo/commands.js

@@ -16,6 +16,7 @@ exports.default = {
     APPLICATIONCUSTOMIZER_ADD: `${prefix} applicationcustomizer add`,
     APPLICATIONCUSTOMIZER_GET: `${prefix} applicationcustomizer get`,
     APPLICATIONCUSTOMIZER_LIST: `${prefix} applicationcustomizer list`,
+    APPLICATIONCUSTOMIZER_REMOVE: `${prefix} applicationcustomizer remove`,
     APPPAGE_ADD: `${prefix} apppage add`,
     APPPAGE_SET: `${prefix} apppage set`,
     CDN_GET: `${prefix} cdn get`,
@@ -158,6 +159,7 @@ exports.default = {
     LISTITEM_ADD: `${prefix} listitem add`,
     LISTITEM_ATTACHMENT_LIST: `${prefix} listitem attachment list`,
     LISTITEM_BATCH_ADD: `${prefix} listitem batch add`,
+    LISTITEM_BATCH_SET: `${prefix} listitem batch set`,
     LISTITEM_GET: `${prefix} listitem get`,
     LISTITEM_ISRECORD: `${prefix} listitem isrecord`,
     LISTITEM_LIST: `${prefix} listitem list`,
@@ -291,6 +293,10 @@ exports.default = {
     TENANT_APPCATALOGURL_GET: `${prefix} tenant appcatalogurl get`,
     TENANT_APPLICATIONCUSTOMIZER_ADD: `${prefix} tenant applicationcustomizer add`,
     TENANT_APPLICATIONCUSTOMIZER_GET: `${prefix} tenant applicationcustomizer get`,
+    TENANT_APPLICATIONCUSTOMIZER_LIST: `${prefix} tenant applicationcustomizer list`,
+    TENANT_APPLICATIONCUSTOMIZER_REMOVE: `${prefix} tenant applicationcustomizer remove`,
+    TENANT_COMMANDSET_REMOVE: `${prefix} tenant commandset remove`,
+    TENANT_COMMANDSET_SET: `${prefix} tenant commandset set`,
     TENANT_RECYCLEBINITEM_LIST: `${prefix} tenant recyclebinitem list`,
     TENANT_RECYCLEBINITEM_REMOVE: `${prefix} tenant recyclebinitem remove`,
     TENANT_RECYCLEBINITEM_RESTORE: `${prefix} tenant recyclebinitem restore`,

package/dist/utils/formatting.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatting = void 0;
+exports.formatting = exports.CheckStatus = void 0;
+const chalk = require("chalk");
 const stripJsonComments = require("strip-json-comments");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
+/**
+ * Has the particular check passed or failed
+ */
+var CheckStatus;
+(function (CheckStatus) {
+    CheckStatus[CheckStatus["Success"] = 0] = "Success";
+    CheckStatus[CheckStatus["Failure"] = 1] = "Failure";
+})(CheckStatus = exports.CheckStatus || (exports.CheckStatus = {}));
 exports.formatting = {
     escapeXml(s) {
         if (!s) {
@@ -54,16 +63,23 @@ exports.formatting = {
         const regex = new RegExp(`\\s*(${quoteChar})?(.*?)\\1\\s*(?:${delimiter}|$)`, 'gs');
         const lines = s.split('\n');
         const match = (line) => [...line.matchAll(regex)]
-            .map(m => m[2]) // we only want the second capture group
-            .slice(0, -1); // cut off blank match at the end
-        const heads = match(lines[0]);
-        return lines.slice(1).map(line => {
-            return match(line).reduce((acc, cur, i) => {
-                const val = cur;
-                const numValue = parseInt(val);
-                const key = heads[i];
-                return Object.assign(Object.assign({}, acc), { [key]: isNaN(numValue) || numValue.toString() !== val ? val : numValue });
-            }, {});
+            .map(m => m[2]); // we only want the second capture group
+        const heads = match(lines[0]).slice(0, -1);
+        return lines.slice(1)
+            .filter(text => text.trim() !== '')
+            .map(line => {
+            const lineMatch = match(line);
+            const obj = {};
+            heads.forEach((key, index) => {
+                const value = parseInt(lineMatch[index]);
+                if (isNaN(value) || value.toString() !== lineMatch[index]) {
+                    obj[key] = lineMatch[index];
+                }
+                else {
+                    obj[key] = parseInt(lineMatch[index]);
+                }
+            });
+            return obj;
         });
     },
     encodeQueryParameter(value) {
@@ -132,6 +148,14 @@ exports.formatting = {
         }
         xml = xml.replace(/<\/?[0-9]{1,}>/g, '');
         return xml;
+    },
+    getStatus(result, message) {
+        const primarySupported = process.platform !== 'win32' ||
+            process.env.CI === 'true' ||
+            process.env.TERM === 'xterm-256color';
+        const success = primarySupported ? '✔' : '√';
+        const failure = primarySupported ? '✖' : '×';
+        return `${result === CheckStatus.Success ? chalk.green(success) : chalk.red(failure)} ${message}`;
     }
 };
 //# sourceMappingURL=formatting.js.map

package/dist/utils/pid.js

@@ -68,6 +68,11 @@ exports.pid = {
             return processName;
         }
         return undefined;
+    },
+    isPowerShell() {
+        const processName = exports.pid.getProcessName(process.ppid) || '';
+        return processName.indexOf('powershell') > -1 ||
+            processName.indexOf('pwsh') > -1;
     }
 };
 //# sourceMappingURL=pid.js.map

package/docs/docs/cmd/app/permission/permission-add.md

@@ -0,0 +1,53 @@
+# app permission add
+
+Adds the specified application and/or delegated permissions to the current AAD app API permissions
+
+## Usage
+
+```sh
+m365 app permission add [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for
+
+`--applicationPermission [applicationPermission]`
+: Space-separated list of application permissions to add
+
+`--delegatedPermission [delegatedPermission]`
+: Space-separated list of delegated permissions to add
+
+`--grantAdminConsent`
+: If specified, admin consent to the newly added permissions will be granted.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Adds the specified application permissions to the default app registered in the .m365rc.json file while granting admin consent.
+
+```sh
+m365 app permission add --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
+```
+
+Adds the specified delegated permissions to the default app registered in the .m365rc.json file without granting admin consent.
+
+```sh
+m365 app permission add --delegatedPermission 'https://graph.microsoft.com/offline_access'
+```
+
+Adds the specified application and delegated permissions to a specific app registered in the .m365rc.json file while granting admin consent.
+
+```sh
+m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermission 'https://graph.microsoft.com/offline_access' --grantAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -121,3 +121,21 @@ m365 flow environment list
     name,displayName
     d87a7535-dd31-4437-bfe1-95340acd55c5,Contoso Environment
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment list
+
+    Date: 2023-05-18
+
+    ## Contoso Environment (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4)
+
+    Property | Value
+    ---------|-------
+    name | Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    location | europe
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    displayName | Contoso Environment
+    ```

package/docs/docs/cmd/flow/flow-get.md

@@ -417,3 +417,23 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
     name,displayName,description,triggers,actions
     ca76d7b8-3b76-4050-8c03-9fb310ad172f,My Flow,,OpenApiConnection,"OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem"
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow get --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4" --name "ca76d7b8-3b76-4050-8c03-9fb310ad172f"
+
+    Date: 2023-05-18
+
+    ## My Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f)
+
+    Property | Value
+    ---------|-------
+    name | ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | My Flow
+    description | My Flow
+    triggers | OpenApiConnection
+    actions | OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem
+    ```

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

@@ -147,3 +147,20 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
     name,displayName
     00afcb83-df7b-4fe0-ab9c-1542a1dc66a9,Contoso Invoicing Flow
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow list --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+
+    Date: 2023-05-18
+
+    ## Contoso Invoicing Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9)
+
+    Property | Value
+    ---------|-------
+    name | 00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | Contoso Invoicing Flow
+    ```

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

@@ -30,7 +30,7 @@ m365 planner plan get [options]
 ## 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.
+    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
 

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

@@ -24,7 +24,7 @@ m365 planner plan list [options]
 ## 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.
+    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
 

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

@@ -71,5 +71,6 @@ m365 planner roster add
     assignedSensitivityLabel | null
     ```
 
-## Additional information
+## More 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-get.md

@@ -68,6 +68,6 @@ m365 planner roster get --id tYqYlNd6eECmsNhN_fcq85cAGAnd
     assignedSensitivityLabel | null
     ```
 
-## Additional information
+## More 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

@@ -44,5 +44,6 @@ m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --confirm
 
 The command won't return a response on success.
 
-## Additional information
+## More 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/task/task-set.md

@@ -335,7 +335,7 @@ m365 planner task set --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"  --percentComplete 50
     checklist | {}
     ```
 
-## Additional information
+## More information
 
 - Using order hints in Planner: [https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0)
 - Applied categories in Planner: [https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0)