@pnp/cli-microsoft365 6.3.0-beta.37c6261 → 6.3.0-beta.456e93a

package/dist/m365/spo/commands/navigation/navigation-node-get.js

@@ -0,0 +1,73 @@
+"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 _SpoNavigationNodeGetCommand_instances, _SpoNavigationNodeGetCommand_initOptions, _SpoNavigationNodeGetCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoNavigationNodeGetCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.NAVIGATION_NODE_GET;
+    }
+    get description() {
+        return 'Retrieve information about a specific navigation node';
+    }
+    constructor() {
+        super();
+        _SpoNavigationNodeGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoNavigationNodeGetCommand_instances, "m", _SpoNavigationNodeGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoNavigationNodeGetCommand_instances, "m", _SpoNavigationNodeGetCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving information about navigation node with id ${args.options.id}`);
+            }
+            const requestOptions = {
+                url: `${args.options.webUrl}/_api/web/navigation/GetNodeById(${args.options.id})`,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            try {
+                const listInstance = yield request_1.default.get(requestOptions);
+                logger.log(listInstance);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_SpoNavigationNodeGetCommand_instances = new WeakSet(), _SpoNavigationNodeGetCommand_initOptions = function _SpoNavigationNodeGetCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --webUrl <webUrl>'
+    }, {
+        option: '--id <id>'
+    });
+}, _SpoNavigationNodeGetCommand_initValidators = function _SpoNavigationNodeGetCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        const id = parseInt(args.options.id);
+        if (isNaN(id)) {
+            return `${args.options.id} is not a valid number`;
+        }
+        return validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+    }));
+};
+module.exports = new SpoNavigationNodeGetCommand();
+//# sourceMappingURL=navigation-node-get.js.map

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

@@ -53,6 +53,9 @@ class SpoSiteDesignAddCommand extends SpoCommand_1.default {
                 if (args.options.previewImageAltText) {
                     info.PreviewImageAltText = args.options.previewImageAltText;
                 }
+                if (args.options.thumbnailUrl) {
+                    info.ThumbnailUrl = args.options.thumbnailUrl;
+                }
                 if (args.options.isDefault) {
                     info.IsDefault = true;
                 }
@@ -83,6 +86,7 @@ _SpoSiteDesignAddCommand_instances = new WeakSet(), _SpoSiteDesignAddCommand_ini
             description: (!(!args.options.description)).toString(),
             previewImageUrl: (!(!args.options.previewImageUrl)).toString(),
             previewImageAltText: (!(!args.options.previewImageAltText)).toString(),
+            thumbnailUrl: (!(!args.options.thumbnailUrl)).toString(),
             isDefault: args.options.isDefault || false
         });
     });
@@ -100,6 +104,8 @@ _SpoSiteDesignAddCommand_instances = new WeakSet(), _SpoSiteDesignAddCommand_ini
         option: '-m, --previewImageUrl [previewImageUrl]'
     }, {
         option: '-a, --previewImageAltText [previewImageAltText]'
+    }, {
+        option: '--thumbnailUrl [thumbnailUrl]'
     }, {
         option: '--isDefault'
     });

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

@@ -0,0 +1,179 @@
+"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 _SpoTenantApplicationCustomizerAddCommand_instances, _SpoTenantApplicationCustomizerAddCommand_initTelemetry, _SpoTenantApplicationCustomizerAddCommand_initOptions, _SpoTenantApplicationCustomizerAddCommand_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 Cli_1 = require("../../../../cli/Cli");
+const spoTenantAppCatalogUrlGetCommand = require("../tenant/tenant-appcatalogurl-get");
+const spoListItemAddCommand = require("../listitem/listitem-add");
+const spoListItemListCommand = require("../listitem/listitem-list");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+class SpoTenantApplicationCustomizerAddCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_APPLICATIONCUSTOMIZER_ADD;
+    }
+    get description() {
+        return 'Add an application customizer as a tenant wide extension.';
+    }
+    constructor() {
+        super();
+        _SpoTenantApplicationCustomizerAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const appCatalogUrl = yield this.getAppCatalogUrl(logger);
+                const componentManifest = yield this.getComponentManifest(appCatalogUrl, args.options.clientSideComponentId, logger);
+                const clientComponentManifest = JSON.parse(componentManifest.ClientComponentManifest);
+                if (clientComponentManifest.extensionType !== "ApplicationCustomizer") {
+                    throw `The extension type of this component is not of type 'ApplicationCustomizer' but of type '${clientComponentManifest.extensionType}'`;
+                }
+                const solution = yield this.getSolutionFromAppCatalog(appCatalogUrl, componentManifest.SolutionId, logger);
+                if (!solution.ContainsTenantWideExtension) {
+                    throw `The solution does not contain an extension that can be deployed to all sites. Make sure that you've entered the correct component Id.`;
+                }
+                else if (!solution.SkipFeatureDeployment) {
+                    throw 'The solution has not been deployed to all sites. Make sure to deploy this solution to all sites.';
+                }
+                yield this.addTenantWideExtension(appCatalogUrl, args.options, logger);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    getAppCatalogUrl(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const spoTenantAppCatalogUrlGetCommandOutput = yield Cli_1.Cli.executeCommandWithOutput(spoTenantAppCatalogUrlGetCommand, { options: { output: 'text', _: [] } });
+            if (this.verbose) {
+                logger.logToStderr(spoTenantAppCatalogUrlGetCommandOutput.stderr);
+            }
+            const appCatalogUrl = spoTenantAppCatalogUrlGetCommandOutput.stdout;
+            if (!appCatalogUrl) {
+                throw 'Cannot add tenant-wide application customizer as app catalog cannot be found';
+            }
+            if (this.verbose) {
+                logger.logToStderr(`Got tenant app catalog url: ${appCatalogUrl}`);
+            }
+            return appCatalogUrl;
+        });
+    }
+    getComponentManifest(appCatalogUrl, clientSideComponentId, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Retrieving component manifest item from the ComponentManifests list on the app catalog site so that we get the solution id');
+            }
+            const camlQuery = `<View><ViewFields><FieldRef Name='ClientComponentId'></FieldRef><FieldRef Name='SolutionId'></FieldRef><FieldRef Name='ClientComponentManifest'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='ClientComponentId' /><Value Type='Guid'>${clientSideComponentId}</Value></Eq></Where></Query></View>`;
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/Lists/ComponentManifests`,
+                camlQuery: camlQuery,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: 'json'
+            };
+            const output = yield Cli_1.Cli.executeCommandWithOutput(spoListItemListCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+            if (this.verbose) {
+                logger.logToStderr(output.stderr);
+            }
+            const outputParsed = JSON.parse(output.stdout);
+            if (outputParsed.length === 0) {
+                throw 'No component found with the specified clientSideComponentId found in the component manifest list. Make sure that the application is added to the application catalog';
+            }
+            return outputParsed[0];
+        });
+    }
+    getSolutionFromAppCatalog(appCatalogUrl, solutionId, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving solution with id ${solutionId} from the application catalog`);
+            }
+            const camlQuery = `<View><ViewFields><FieldRef Name='SkipFeatureDeployment'></FieldRef><FieldRef Name='ContainsTenantWideExtension'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='AppProductID' /><Value Type='Guid'>${solutionId}</Value></Eq></Where></Query></View>`;
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/AppCatalog`,
+                camlQuery: camlQuery,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: 'json'
+            };
+            const output = yield Cli_1.Cli.executeCommandWithOutput(spoListItemListCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+            if (this.verbose) {
+                logger.logToStderr(output.stderr);
+            }
+            const outputParsed = JSON.parse(output.stdout);
+            if (outputParsed.length === 0) {
+                throw `No component found with the solution id ${solutionId}. Make sure that the solution is available in the app catalog`;
+            }
+            return outputParsed[0];
+        });
+    }
+    addTenantWideExtension(appCatalogUrl, options, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Pre-checks finished. Adding tenant wide extension to the TenantWideExtensions list');
+            }
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/Lists/TenantWideExtensions`,
+                Title: options.title,
+                TenantWideExtensionComponentId: options.clientSideComponentId,
+                TenantWideExtensionLocation: 'ClientSideExtension.ApplicationCustomizer',
+                TenantWideExtensionSequence: 0,
+                TenantWideExtensionListTemplate: 0,
+                TenantWideExtensionComponentProperties: options.clientSideComponentProperties || '',
+                TenantWideExtensionWebTemplate: options.webTemplate || '',
+                TenantWideExtensionDisabled: false,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: options.output
+            };
+            yield Cli_1.Cli.executeCommand(spoListItemAddCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+        });
+    }
+}
+_SpoTenantApplicationCustomizerAddCommand_instances = new WeakSet(), _SpoTenantApplicationCustomizerAddCommand_initTelemetry = function _SpoTenantApplicationCustomizerAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            clientSideComponentProperties: typeof args.options.clientSideComponentProperties !== 'undefined',
+            webTemplate: typeof args.options.webTemplate !== 'undefined'
+        });
+    });
+}, _SpoTenantApplicationCustomizerAddCommand_initOptions = function _SpoTenantApplicationCustomizerAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-t, --title <title>'
+    }, {
+        option: '-i, --clientSideComponentId <clientSideComponentId>'
+    }, {
+        option: '-p, --clientSideComponentProperties [clientSideComponentProperties]'
+    }, {
+        option: '-w, --webTemplate [webTemplate]'
+    });
+}, _SpoTenantApplicationCustomizerAddCommand_initValidators = function _SpoTenantApplicationCustomizerAddCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        return true;
+    }));
+};
+module.exports = new SpoTenantApplicationCustomizerAddCommand();
+//# sourceMappingURL=tenant-applicationcustomizer-add.js.map

package/dist/m365/spo/commands.js

@@ -168,6 +168,7 @@ exports.default = {
     LISTITEM_SET: `${prefix} listitem set`,
     MAIL_SEND: `${prefix} mail send`,
     NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
+    NAVIGATION_NODE_GET: `${prefix} navigation node get`,
     NAVIGATION_NODE_LIST: `${prefix} navigation node list`,
     NAVIGATION_NODE_REMOVE: `${prefix} navigation node remove`,
     NAVIGATION_NODE_SET: `${prefix} navigation node set`,
@@ -277,6 +278,7 @@ exports.default = {
     STORAGEENTITY_REMOVE: `${prefix} storageentity remove`,
     TENANT_APPCATALOG_ADD: `${prefix} tenant appcatalog add`,
     TENANT_APPCATALOGURL_GET: `${prefix} tenant appcatalogurl get`,
+    TENANT_APPLICATIONCUSTOMIZER_ADD: `${prefix} tenant applicationcustomizer add`,
     TENANT_RECYCLEBINITEM_LIST: `${prefix} tenant recyclebinitem list`,
     TENANT_RECYCLEBINITEM_REMOVE: `${prefix} tenant recyclebinitem remove`,
     TENANT_RECYCLEBINITEM_RESTORE: `${prefix} tenant recyclebinitem restore`,

package/dist/utils/aadUser.js

@@ -0,0 +1,38 @@
+"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.aadUser = void 0;
+const request_1 = require("../request");
+const formatting_1 = require("./formatting");
+const graphResource = 'https://graph.microsoft.com';
+exports.aadUser = {
+    /**
+     * Retrieve the id of a user by its UPN.
+     * @param upn User UPN.
+     */
+    getUserIdByUpn(upn) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${graphResource}/v1.0/users?$filter=userPrincipalName eq '${formatting_1.formatting.encodeQueryParameter(upn)}'&$select=Id`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            if (res.value.length === 0) {
+                throw Error(`The specified user with user name ${upn} does not exist.`);
+            }
+            return res.value[0].id;
+        });
+    }
+};
+//# sourceMappingURL=aadUser.js.map

package/dist/utils/planner.js

@@ -57,15 +57,12 @@ exports.planner = {
      * @param groupId Owner group ID.
      * @param rosterId Roster ID.
      */
-    getPlanByTitle(title, groupId, rosterId, metadata = 'none') {
+    getPlanByTitle(title, groupId, metadata = 'none') {
         return __awaiter(this, void 0, void 0, function* () {
             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/dist/utils/spo.js

@@ -18,6 +18,7 @@ const config_1 = require("../config");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
 const formatting_1 = require("./formatting");
+const odata_1 = require("./odata");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -484,6 +485,66 @@ exports.spo = {
             const res = yield request_1.default.get(requestOptions);
             return res;
         });
+    },
+    /**
+     * Retrieves a list of Custom Actions from a SharePoint site.
+     * @param webUrl Web url
+     * @param scope The scope of custom actions to retrieve, allowed values "Site", "Web" or "All".
+     * @param filter An OData filter query to limit the results.
+     */
+    getCustomActions(webUrl, scope, filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (scope && scope !== "All" && scope !== "Site" && scope !== "Web") {
+                throw `Invalid scope '${scope}'. Allowed values are 'Site', 'Web' or 'All'.`;
+            }
+            const queryString = filter ? `?$filter=${filter}` : "";
+            if (scope && scope !== "All") {
+                return yield odata_1.odata.getAllItems(`${webUrl}/_api/${scope}/UserCustomActions${queryString}`);
+            }
+            const customActions = [
+                ...yield odata_1.odata.getAllItems(`${webUrl}/_api/Site/UserCustomActions${queryString}`),
+                ...yield odata_1.odata.getAllItems(`${webUrl}/_api/Web/UserCustomActions${queryString}`)
+            ];
+            return customActions;
+        });
+    },
+    /**
+     * Retrieves a Custom Actions from a SharePoint site by Id.
+     * @param webUrl Web url
+     * @param id The Id of the Custom Action
+     * @param scope The scope of custom actions to retrieve, allowed values "Site", "Web" or "All".
+     */
+    getCustomActionById(webUrl, id, scope) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (scope && scope !== "All" && scope !== "Site" && scope !== "Web") {
+                throw `Invalid scope '${scope}'. Allowed values are 'Site', 'Web' or 'All'.`;
+            }
+            function getById(webUrl, id, scope) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const requestOptions = {
+                        url: `${webUrl}/_api/${scope}/UserCustomActions(guid'${id}')`,
+                        headers: {
+                            accept: 'application/json;odata=nometadata'
+                        },
+                        responseType: 'json'
+                    };
+                    const result = yield request_1.default.get(requestOptions);
+                    if (result["odata.null"] === true) {
+                        return undefined;
+                    }
+                    return result;
+                });
+            }
+            if (scope && scope !== "All") {
+                return yield getById(webUrl, id, scope);
+            }
+            const customActionOnWeb = yield getById(webUrl, id, "Web");
+            if (customActionOnWeb) {
+                return customActionOnWeb;
+            }
+            const customActionOnSite = yield getById(webUrl, id, "Site");
+            return customActionOnSite;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/aad/user/user-recyclebinitem-clear.md

@@ -0,0 +1,42 @@
+# aad user recyclebinitem clear
+
+Removes all users from the tenant recycle bin
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem clear [options]
+```
+
+## Options
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+
+!!! note
+    After running this command, it may take a minute before all deleted users are effectively removed from the tenant.
+
+## Examples
+
+Removes all users from the tenant recycle bin
+
+```sh
+m365 aad user recyclebinitem clear
+```
+
+Removes all users from the tenant recycle bin without confirmation prompt
+
+```sh
+m365 aad user recyclebinitem clear --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-recyclebinitem-remove.md

@@ -0,0 +1,45 @@
+# aad user recyclebinitem remove
+
+Removes a user from the recycle bin in the current tenant
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem remove [options]
+```
+
+## Options
+
+`--id <id>`
+: ID of the deleted user.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+
+!!! note
+    After running this command, it may take a minute before the deleted user is effectively removed from the tenant.
+
+## Examples
+
+Removes a specific user from the recycle bin
+
+```sh
+m365 aad user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Removes a specific user from the recycle bin without confirmation prompt
+
+```sh
+m365 aad user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3 --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/option/option-list.md

@@ -0,0 +1,63 @@
+# context option list
+
+List all options added to the context
+
+## Usage
+
+```sh
+m365 context option list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all options added to the context
+
+```sh
+m365 context option list
+```
+
+## Response
+
+The responses below are an example. The output may differ based on the contents of the context file
+
+=== "JSON"
+
+    ```json
+    {
+      "url": "https://contoso.sharepoint.com",
+      "list": "list name"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    list: list name
+    url : https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    url,list
+    https://contoso.sharepoint.com,list name
+    ```
+
+=== "Markdown"
+
+    ```md
+    # context option list
+
+    Date: 7/2/2023
+
+    ## https://contoso.sharepoint.com
+
+    Property | Value
+    ---------|-------
+    url | https://contoso.sharepoint.com
+    list | list name
+    ```

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

@@ -10,8 +10,8 @@ m365 flow environment get [options]
 
 ## Options
 
-`-n, --name <name>`
-: The name of the environment to get information about
+`-n, --name [name]`
+: The name of the environment to get information about. When not specified, the default environment is retrieved.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,12 +24,17 @@ If the environment with the name you specified doesn't exist, you will get the `
 
 ## Examples
 
-Get information about the Microsoft Flow environment named _Default-d87a7535-dd31-4437-bfe1-95340acd55c5_
+Get information about a Microsoft Flow environment specified by name
 
 ```sh
 m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
+Get information about the default Microsoft Flow environment
+```sh
+m365 flow environment get
+```
+
 ## Response
 
 ### Standard response
@@ -129,3 +134,26 @@ m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
     name,id,location,displayName,provisioningState,environmentSku,azureRegionHint,isDefault
     Default-d87a7535-dd31-4437-bfe1-95340acd55c5,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5,india,contoso (default),Succeeded,Default,centralindia,1  
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment get
+
+    Date: 8/2/2023
+
+    ## contoso (default) (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5)
+
+    Property | Value
+    ---------|-------
+    name | Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    location | india
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    properties | {"displayName":"contoso (default)","createdTime":"2019-12-21T18:32:11.8708704Z","createdBy":{"id":"SYSTEM","displayName": "SYSTEM","type": "NotSpecified"},"provisioningState":"Succeeded","creationType":"DefaultTenant","environmentSku":"Default","environmentType":"NotSpecified","states":{"management":{"id":"NotSpecified"},"runtime":{"runtimeReasonCode":"NotSpecified","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"id":"Enabled"}},"isDefault":true,"isPayAsYouGoEnabled":false,"azureRegionHint":"centralindia","runtimeEndpoints":{"microsoft.BusinessAppPlatform":"https://india.api.bap.microsoft.com","microsoft.CommonDataModel":"https://india.api.cds.microsoft.com","microsoft.PowerApps":"https://india.api.powerapps.com",microsoft.PowerAppsAdvisor":"https://india.api.advisor.powerapps.com","microsoft.PowerVirtualAgents":"https://powervamg.in-il101.gateway.prod.island.powerapps.com","microsoft.ApiManagement":"https://management.INDIA.azure-apihub.net","microsoft.Flow":"https://india.api.flow.microsoft.com"},"linkedEnvironmentMetadata":{"type":"NotSpecified","resourceId":"3aa550bf-52ac-42fc-98f7-5d1833c1501c","friendlyName":"contoso (default)","uniqueName":"orgfc80770f","domainName":"orgfc80770f","version":"9.2.22105.00154","instanceUrl":"https://orgfc80770f.crm8.dynamics.com/","instanceApiUrl":"https://orgfc80770f.api.crm8.dynamics.com","baseLanguage":1033,"instanceState":"Ready","createdTime":"2019-12-25T15:46:14.433Z"},"environmentFeatures":{"isOpenApiEnabled":false},"cluster":{"category":"Prod","number":"101","uriSuffix":"in-il101.gateway.prod.island","geoShortName":"IN","environment":"Prod"},"governanceConfiguration":{"protectionLevel":"Basic"}}
+    displayName | contoso (default)
+    provisioningState | Succeeded
+    environmentSku | Default
+    azureRegionHint | centralindia
+    isDefault | true
+    ```

package/docs/docs/cmd/login.md

@@ -159,3 +159,29 @@ Log in to Microsoft 365 using a client secret.
 ```sh
 m365 login --authType secret --secret topSeCr3t@007
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "Text"
+
+    ```text
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "CSV"
+
+    ```csv
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "Markdown"
+
+    ```md
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```