@pnp/cli-microsoft365 7.0.0-beta.2756488 → 7.0.0-beta.4bb805e

package/dist/Command.js

@@ -40,7 +40,7 @@ class CommandErrorWithOutput {
 exports.CommandErrorWithOutput = CommandErrorWithOutput;
 class Command {
     get allowedOutputs() {
-        return ['csv', 'json', 'md', 'text'];
+        return ['csv', 'json', 'md', 'text', 'none'];
     }
     constructor() {
         // These functions must be defined with # so that they're truly private

package/dist/cli/Cli.js

@@ -107,7 +107,9 @@ class Cli {
                 showHelp ||
                 parsedArgs.h ||
                 parsedArgs.help) {
-                this.printHelp(this.getHelpMode(parsedArgs));
+                if (parsedArgs.output !== 'none') {
+                    this.printHelp(this.getHelpMode(parsedArgs));
+                }
                 return Promise.resolve();
             }
             const optionsWithoutShorts = Cli.removeShortOptions(this.optionsFromArgs);
@@ -144,11 +146,21 @@ class Cli {
         return __awaiter(this, void 0, void 0, function* () {
             const logger = {
                 log: (message) => {
-                    const output = Cli.formatOutput(command, message, args.options);
-                    Cli.log(output);
+                    if (args.options.output !== 'none') {
+                        const output = Cli.formatOutput(command, message, args.options);
+                        Cli.log(output);
+                    }
+                },
+                logRaw: (message) => {
+                    if (args.options.output !== 'none') {
+                        Cli.log(message);
+                    }
                 },
-                logRaw: (message) => Cli.log(message),
-                logToStderr: (message) => Cli.error(message)
+                logToStderr: (message) => {
+                    if (args.options.output !== 'none') {
+                        Cli.error(message);
+                    }
+                }
             };
             if (args.options.debug) {
                 logger.logToStderr(`Executing command ${command.name} with options ${JSON.stringify(args)}`);
@@ -158,7 +170,7 @@ class Cli {
             const cli = Cli.getInstance();
             const parentCommandName = cli.currentCommandName;
             cli.currentCommandName = command.getCommandName(cli.currentCommandName);
-            const showSpinner = cli.getSettingWithDefaultValue(settingsNames_1.settingsNames.showSpinner, true);
+            const showSpinner = cli.getSettingWithDefaultValue(settingsNames_1.settingsNames.showSpinner, true) && args.options.output !== 'none';
             // don't show spinner if running tests
             /* c8 ignore next 3 */
             if (showSpinner && typeof global.it === 'undefined') {
@@ -207,7 +219,7 @@ class Cli {
                     logErr.push(message);
                 }
             };
-            if (args.options.debug) {
+            if (args.options.debug && args.options.output !== 'none') {
                 const message = `Executing command ${command.name} with options ${JSON.stringify(args)}`;
                 if (listener && listener.stderr) {
                     listener.stderr(message);
@@ -730,8 +742,11 @@ class Cli {
         Cli.log();
     }
     closeWithError(error, args, showHelpIfEnabled = false) {
-        const chalk = require('chalk');
         let exitCode = 1;
+        if (args.options.output === 'none') {
+            return process.exit(exitCode);
+        }
+        const chalk = require('chalk');
         let errorMessage = error instanceof Command_1.CommandError ? error.message : error;
         if ((!args.options.output || args.options.output === 'json') &&
             !this.getSettingWithDefaultValue(settingsNames_1.settingsNames.printErrorsAsPlainText, true)) {

package/dist/m365/booking/commands/business/business-get.js

@@ -56,26 +56,25 @@ class BookingBusinessGetCommand extends GraphCommand_1.default {
         });
     }
     getBusinessId(options) {
-        if (options.id) {
-            return Promise.resolve(options.id);
-        }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/solutions/bookingBusinesses`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((response) => {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (options.id) {
+                return options.id;
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/solutions/bookingBusinesses`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
             const name = options.name;
             const bookingBusinesses = response.value.filter(val => { var _a; return ((_a = val.displayName) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === name.toLocaleLowerCase(); });
             if (!bookingBusinesses.length) {
-                return Promise.reject(`The specified business with name ${options.name} does not exist.`);
+                throw `The specified business with name ${options.name} does not exist.`;
             }
             if (bookingBusinesses.length > 1) {
-                return Promise.reject(`Multiple businesses with name ${options.name} found. Please disambiguate: ${bookingBusinesses.map(x => x.id).join(', ')}`);
+                throw `Multiple businesses with name ${options.name} found. Please disambiguate: ${bookingBusinesses.map(x => x.id).join(', ')}`;
             }
             return bookingBusinesses[0].id;
         });

package/dist/m365/cli/commands/config/config-set.js

@@ -73,7 +73,7 @@ _CliConfigSetCommand_instances = new WeakSet(), _CliConfigSetCommand_initTelemet
         if (CliConfigSetCommand.optionNames.indexOf(args.options.key) < 0) {
             return `${args.options.key} is not a valid setting. Allowed values: ${CliConfigSetCommand.optionNames.join(', ')}`;
         }
-        const allowedOutputs = ['text', 'json', 'csv', 'md'];
+        const allowedOutputs = ['text', 'json', 'csv', 'md', 'none'];
         if (args.options.key === settingsNames_1.settingsNames.output &&
             allowedOutputs.indexOf(args.options.value) === -1) {
             return `${args.options.value} is not a valid value for the option ${args.options.key}. Allowed values: ${allowedOutputs.join(', ')}`;

package/dist/m365/spo/commands/list/list-roleassignment-add.js

@@ -15,16 +15,13 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _SpoListRoleAssignmentAddCommand_instances, _SpoListRoleAssignmentAddCommand_initTelemetry, _SpoListRoleAssignmentAddCommand_initOptions, _SpoListRoleAssignmentAddCommand_initValidators, _SpoListRoleAssignmentAddCommand_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 urlUtil_1 = require("../../../../utils/urlUtil");
 const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
 const commands_1 = require("../../commands");
-const SpoUserGetCommand = require("../user/user-get");
-const SpoGroupGetCommand = require("../group/group-get");
-const SpoRoleDefinitionListCommand = require("../roledefinition/roledefinition-list");
+const spo_1 = require("../../../../utils/spo");
 class SpoListRoleAssignmentAddCommand extends SpoCommand_1.default {
     get name() {
         return commands_1.default.LIST_ROLEASSIGNMENT_ADD;
@@ -57,13 +54,15 @@ class SpoListRoleAssignmentAddCommand extends SpoCommand_1.default {
                     const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl);
                     requestUrl += `GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')/`;
                 }
-                args.options.roleDefinitionId = yield this.getRoleDefinitionId(args.options);
+                args.options.roleDefinitionId = yield this.getRoleDefinitionId(args.options, logger);
                 if (args.options.upn) {
-                    args.options.principalId = yield this.getUserPrincipalId(args.options);
+                    const user = yield spo_1.spo.getUserByEmail(args.options.webUrl, args.options.upn, logger, this.verbose);
+                    args.options.principalId = user.Id;
                     yield this.addRoleAssignment(requestUrl, logger, args.options);
                 }
                 else if (args.options.groupName) {
-                    args.options.principalId = yield this.getGroupPrincipalId(args.options);
+                    const group = yield spo_1.spo.getGroupByName(args.options.webUrl, args.options.groupName, logger, this.verbose);
+                    args.options.principalId = group.Id;
                     yield this.addRoleAssignment(requestUrl, logger, args.options);
                 }
                 else {
@@ -89,50 +88,13 @@ class SpoListRoleAssignmentAddCommand extends SpoCommand_1.default {
             return request_1.default.post(requestOptions);
         });
     }
-    getRoleDefinitionId(options) {
+    getRoleDefinitionId(options, logger) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!options.roleDefinitionName) {
                 return options.roleDefinitionId;
             }
-            const roleDefinitionListCommandOptions = {
-                webUrl: options.webUrl,
-                output: 'json',
-                debug: this.debug,
-                verbose: this.verbose
-            };
-            const output = yield Cli_1.Cli.executeCommandWithOutput(SpoRoleDefinitionListCommand, { options: Object.assign(Object.assign({}, roleDefinitionListCommandOptions), { _: [] }) });
-            const getRoleDefinitionListOutput = JSON.parse(output.stdout);
-            const roleDefinitionId = getRoleDefinitionListOutput.find((role) => role.Name === options.roleDefinitionName).Id;
-            return roleDefinitionId;
-        });
-    }
-    getGroupPrincipalId(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const groupGetCommandOptions = {
-                webUrl: options.webUrl,
-                name: options.groupName,
-                output: 'json',
-                debug: this.debug,
-                verbose: this.verbose
-            };
-            const output = yield Cli_1.Cli.executeCommandWithOutput(SpoGroupGetCommand, { options: Object.assign(Object.assign({}, groupGetCommandOptions), { _: [] }) });
-            const getGroupOutput = JSON.parse(output.stdout);
-            return getGroupOutput.Id;
-        });
-    }
-    getUserPrincipalId(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const userGetCommandOptions = {
-                webUrl: options.webUrl,
-                email: options.upn,
-                id: undefined,
-                output: 'json',
-                debug: this.debug,
-                verbose: this.verbose
-            };
-            const output = yield Cli_1.Cli.executeCommandWithOutput(SpoUserGetCommand, { options: Object.assign(Object.assign({}, userGetCommandOptions), { _: [] }) });
-            const getUserOutput = JSON.parse(output.stdout);
-            return getUserOutput.Id;
+            const roleDefinition = yield spo_1.spo.getRoleDefinitionByName(options.webUrl, options.roleDefinitionName, logger, this.verbose);
+            return roleDefinition.Id;
         });
     }
 }

package/dist/m365/spo/commands/page/page-remove.js

@@ -37,37 +37,8 @@ class SpoPageRemoveCommand extends SpoCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            let requestDigest = '';
-            let pageName = args.options.name;
-            const removePage = () => __awaiter(this, void 0, void 0, function* () {
-                try {
-                    const reqDigest = yield spo_1.spo.getRequestDigest(args.options.webUrl);
-                    requestDigest = reqDigest.FormDigestValue;
-                    if (!pageName.endsWith('.aspx')) {
-                        pageName += '.aspx';
-                    }
-                    if (this.verbose) {
-                        logger.logToStderr(`Removing page ${pageName}...`);
-                    }
-                    const requestOptions = {
-                        url: `${args.options
-                            .webUrl}/_api/web/getfilebyserverrelativeurl('${urlUtil_1.urlUtil.getServerRelativeSiteUrl(args.options.webUrl)}/sitepages/${pageName}')`,
-                        headers: {
-                            'X-RequestDigest': requestDigest,
-                            'X-HTTP-Method': 'DELETE',
-                            'content-type': 'application/json;odata=nometadata',
-                            accept: 'application/json;odata=nometadata'
-                        },
-                        responseType: 'json'
-                    };
-                    yield request_1.default.post(requestOptions);
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.force) {
-                yield removePage();
+                yield this.removePage(logger, args);
             }
             else {
                 const result = yield Cli_1.Cli.prompt({
@@ -77,11 +48,42 @@ class SpoPageRemoveCommand extends SpoCommand_1.default {
                     message: `Are you sure you want to remove the page '${args.options.name}'?`
                 });
                 if (result.continue) {
-                    yield removePage();
+                    yield this.removePage(logger, args);
                 }
             }
         });
     }
+    removePage(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let requestDigest = '';
+                let pageName = args.options.name;
+                const reqDigest = yield spo_1.spo.getRequestDigest(args.options.webUrl);
+                requestDigest = reqDigest.FormDigestValue;
+                if (!pageName.endsWith('.aspx')) {
+                    pageName += '.aspx';
+                }
+                if (this.verbose) {
+                    logger.logToStderr(`Removing page ${pageName}...`);
+                }
+                const requestOptions = {
+                    url: `${args.options
+                        .webUrl}/_api/web/getfilebyserverrelativeurl('${urlUtil_1.urlUtil.getServerRelativeSiteUrl(args.options.webUrl)}/sitepages/${pageName}')`,
+                    headers: {
+                        'X-RequestDigest': requestDigest,
+                        'X-HTTP-Method': 'DELETE',
+                        'content-type': 'application/json;odata=nometadata',
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json'
+                };
+                yield request_1.default.post(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
 }
 _SpoPageRemoveCommand_instances = new WeakSet(), _SpoPageRemoveCommand_initOptions = function _SpoPageRemoveCommand_initOptions() {
     this.options.unshift({

package/dist/m365/spo/commands/roledefinition/roledefinition-remove.js

@@ -36,29 +36,8 @@ class SpoRoleDefinitionRemoveCommand extends SpoCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const removeRoleDefinition = () => __awaiter(this, void 0, void 0, function* () {
-                if (this.verbose) {
-                    logger.logToStderr(`Removing role definition from site ${args.options.webUrl}...`);
-                }
-                const requestOptions = {
-                    url: `${args.options.webUrl}/_api/web/roledefinitions(${args.options.id})`,
-                    method: 'delete',
-                    headers: {
-                        'X-HTTP-Method': 'DELETE',
-                        'If-Match': '*',
-                        'accept': 'application/json;odata=nometadata'
-                    },
-                    responseType: 'json'
-                };
-                try {
-                    yield request_1.default.delete(requestOptions);
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.force) {
-                yield removeRoleDefinition();
+                yield this.removeRoleDefinition(logger, args);
             }
             else {
                 const result = yield Cli_1.Cli.prompt({
@@ -68,11 +47,34 @@ class SpoRoleDefinitionRemoveCommand extends SpoCommand_1.default {
                     message: `Are you sure you want to remove the role definition with id ${args.options.id} from site ${args.options.webUrl}?`
                 });
                 if (result.continue) {
-                    yield removeRoleDefinition();
+                    yield this.removeRoleDefinition(logger, args);
                 }
             }
         });
     }
+    removeRoleDefinition(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Removing role definition from site ${args.options.webUrl}...`);
+            }
+            const requestOptions = {
+                url: `${args.options.webUrl}/_api/web/roledefinitions(${args.options.id})`,
+                method: 'delete',
+                headers: {
+                    'X-HTTP-Method': 'DELETE',
+                    'If-Match': '*',
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            try {
+                yield request_1.default.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
 }
 _SpoRoleDefinitionRemoveCommand_instances = new WeakSet(), _SpoRoleDefinitionRemoveCommand_initTelemetry = function _SpoRoleDefinitionRemoveCommand_initTelemetry() {
     this.telemetry.push((args) => {

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

@@ -47,10 +47,10 @@ class SpoSiteAppPermissionAddCommand extends GraphCommand_1.default {
         }
         let endpoint = "";
         if (args.options.appId) {
-            endpoint = `${this.resource}/v1.0/myorganization/applications?$filter=appId eq '${formatting_1.formatting.encodeQueryParameter(args.options.appId)}'`;
+            endpoint = `${this.resource}/v1.0/myorganization/servicePrincipals?$select=appId,displayName&$filter=appId eq '${formatting_1.formatting.encodeQueryParameter(args.options.appId)}'`;
         }
         else {
-            endpoint = `${this.resource}/v1.0/myorganization/applications?$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(args.options.appDisplayName)}'`;
+            endpoint = `${this.resource}/v1.0/myorganization/servicePrincipals?$select=appId,displayName&$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(args.options.appDisplayName)}'`;
         }
         const appRequestOptions = {
             url: endpoint,
@@ -168,7 +168,7 @@ _SpoSiteAppPermissionAddCommand_instances = new WeakSet(), _SpoSiteAppPermission
         return validation_1.validation.isValidSharePointUrl(args.options.siteUrl);
     }));
 }, _SpoSiteAppPermissionAddCommand_initOptionSets = function _SpoSiteAppPermissionAddCommand_initOptionSets() {
-    this.optionSets.push({ options: ['appId', 'appDisplayName'] });
+    this.optionSets.push({ options: ['appId', 'appDisplayName'], runsWhen: (args) => !args.options.appId && !args.options.appDisplayName });
 };
 module.exports = new SpoSiteAppPermissionAddCommand();
 //# sourceMappingURL=site-apppermission-add.js.map

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

@@ -311,7 +311,7 @@ class SpoSiteSetCommand extends SpoCommand_1.default {
     }
     updateSiteProperties(logger, args) {
         const isGroupConnectedSite = this.isGroupConnectedSite();
-        const sharedProperties = ['classification', 'disableFlows', 'shareByEmailEnabled', 'sharingCapability', 'noScriptSite'];
+        const sharedProperties = ['classification', 'disableFlows', 'socialBarOnSitePagesDisabled', 'shareByEmailEnabled', 'sharingCapability', 'noScriptSite'];
         const siteProperties = ['title', 'resourceQuota', 'resourceQuotaWarningLevel', 'storageQuota', 'storageQuotaWarningLevel', 'allowSelfServiceUpgrade'];
         let properties = sharedProperties;
         properties = properties;
@@ -363,6 +363,9 @@ class SpoSiteSetCommand extends SpoCommand_1.default {
             if (typeof args.options.disableFlows !== 'undefined') {
                 payload.push(`<SetProperty Id="${propertyId++}" ObjectPathId="5" Name="DisableFlows"><Parameter Type="Boolean">${args.options.disableFlows}</Parameter></SetProperty>`);
             }
+            if (typeof args.options.socialBarOnSitePagesDisabled !== 'undefined') {
+                payload.push(`<SetProperty Id="${propertyId++}" ObjectPathId="5" Name="SocialBarOnSitePagesDisabled"><Parameter Type="Boolean">${args.options.socialBarOnSitePagesDisabled}</Parameter></SetProperty>`);
+            }
             if (typeof args.options.shareByEmailEnabled !== 'undefined') {
                 payload.push(`<SetProperty Id="${propertyId++}" ObjectPathId="5" Name="ShareByEmailEnabled"><Parameter Type="Boolean">${args.options.shareByEmailEnabled}</Parameter></SetProperty>`);
             }
@@ -442,6 +445,7 @@ _SpoSiteSetCommand_instances = new WeakSet(), _SpoSiteSetCommand_initTelemetry =
         Object.assign(this.telemetryProperties, {
             classification: typeof args.options.classification === 'string',
             disableFlows: args.options.disableFlows,
+            socialBarOnSitePagesDisabled: args.options.socialBarOnSitePagesDisabled,
             isPublic: args.options.isPublic,
             owners: typeof args.options.owners !== 'undefined',
             shareByEmailEnabled: args.options.shareByEmailEnabled,
@@ -470,6 +474,9 @@ _SpoSiteSetCommand_instances = new WeakSet(), _SpoSiteSetCommand_initTelemetry =
     }, {
         option: '--disableFlows [disableFlows]',
         autocomplete: ['true', 'false']
+    }, {
+        option: '--socialBarOnSitePagesDisabled [socialBarOnSitePagesDisabled]',
+        autocomplete: ['true', 'false']
     }, {
         option: '--isPublic [isPublic]',
         autocomplete: ['true', 'false']
@@ -517,6 +524,7 @@ _SpoSiteSetCommand_instances = new WeakSet(), _SpoSiteSetCommand_initTelemetry =
         }
         if (typeof args.options.classification === 'undefined' &&
             typeof args.options.disableFlows === 'undefined' &&
+            typeof args.options.socialBarOnSitePagesDisabled === 'undefined' &&
             typeof args.options.title === 'undefined' &&
             typeof args.options.description === 'undefined' &&
             typeof args.options.isPublic === 'undefined' &&
@@ -580,7 +588,7 @@ _SpoSiteSetCommand_instances = new WeakSet(), _SpoSiteSetCommand_initTelemetry =
     }));
 }, _SpoSiteSetCommand_initTypes = function _SpoSiteSetCommand_initTypes() {
     this.types.string.push('classification');
-    this.types.boolean.push('isPublic', 'disableFlows', 'shareByEmailEnabled', 'allowSelfServiceUpgrade', 'noScriptSite');
+    this.types.boolean.push('isPublic', 'disableFlows', 'socialBarOnSitePagesDisabled', 'shareByEmailEnabled', 'allowSelfServiceUpgrade', 'noScriptSite');
 };
 module.exports = new SpoSiteSetCommand();
 //# sourceMappingURL=site-set.js.map

package/dist/utils/spo.js

@@ -19,6 +19,7 @@ const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
 const formatting_1 = require("./formatting");
 const odata_1 = require("./odata");
+const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -569,6 +570,30 @@ exports.spo = {
             return res.AadObjectId.NameId;
         });
     },
+    /**
+   * Retrieves the spo user by email.
+   * @param webUrl Web url
+   * @param email The email of the user
+   * @param logger the Logger object
+   * @param debug set if debug logging should be logged
+   */
+    getUserByEmail(webUrl, email, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the spo user by email ${email}`);
+            }
+            const requestUrl = `${webUrl}/_api/web/siteusers/GetByEmail('${formatting_1.formatting.encodeQueryParameter(email)}')`;
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const userInstance = yield request_1.default.get(requestOptions);
+            return userInstance;
+        });
+    },
     /**
      * Retrieves the menu state for the quick launch.
      * @param webUrl Web url
@@ -628,6 +653,55 @@ exports.spo = {
             };
             return request_1.default.post(requestOptions);
         });
+    },
+    /**
+  * Retrieves the spo group by name.
+  * @param webUrl Web url
+  * @param name The name of the group
+  * @param logger the Logger object
+  * @param debug set if debug logging should be logged
+  */
+    getGroupByName(webUrl, name, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the group by name ${name}`);
+            }
+            const requestUrl = `${webUrl}/_api/web/sitegroups/GetByName('${formatting_1.formatting.encodeQueryParameter(name)}')`;
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const groupInstance = yield request_1.default.get(requestOptions);
+            return groupInstance;
+        });
+    },
+    /**
+  * Retrieves the role definition by name.
+  * @param webUrl Web url
+  * @param name the name of the role definition
+  * @param logger the Logger object
+  * @param debug set if debug logging should be logged
+  */
+    getRoleDefinitionByName(webUrl, name, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the role definitions for ${name}`);
+            }
+            const roledefinitions = yield odata_1.odata.getAllItems(`${webUrl}/_api/web/roledefinitions`);
+            const roledefinition = roledefinitions.find((role) => role.Name === name);
+            if (!roledefinition) {
+                throw `No roledefinition is found for ${name}`;
+            }
+            const permissions = new base_permissions_1.BasePermissions();
+            permissions.high = roledefinition.BasePermissions.High;
+            permissions.low = roledefinition.BasePermissions.Low;
+            roledefinition.BasePermissionsValue = permissions.parse();
+            roledefinition.RoleTypeKindValue = RoleType_1.RoleType[roledefinition.RoleTypeKind];
+            return roledefinition;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/_clisettings.mdx

@@ -10,7 +10,7 @@ Setting name|Definition|Default value
 `disableTelemetry`|Disables sending of telemetry data|`false`
 `errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
 `helpMode`|Defines what part of command's help to display. Allowed values are `options`, `examples`, `remarks`, `response`, `full`|`full`
-`output`|Defines the default output when issuing a command|`json`
+`output`|Defines the default output when issuing a command. Allowed values are `json`, `text`, `csv`, `md`, `none`|`json`
 `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
 `prompt`|Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved.|`false`
 `showHelpOnFailure`|Automatically display help when executing a command failed|`true`

package/docs/docs/cmd/_global.mdx

@@ -6,7 +6,7 @@
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.
 
 `-o, --output [output]`
-: Output type. `json`, `text`, `csv`, `md`. Default `json`.
+: Output type. `json`, `text`, `csv`, `md`, `none`. Default `json`.
 
 `--verbose`
 : Runs command with verbose logging.

package/docs/docs/cmd/spo/site/site-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site add
 
@@ -178,6 +180,39 @@ Create new classic site collection using the Team site template. Set time zone t
 m365 spo site add --type ClassicSite --url https://contoso.sharepoint.com/sites/team --title Team --owners admin@contoso.onmicrosoft.com --timeZone 4 --webTemplate STS#0 --removeDeletedSite --wait
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "https://contoso.sharepoint.com/sites/marketing"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Creating SharePoint Communication Site using REST: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest](https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest)

package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx

@@ -32,9 +32,13 @@ To use this command you have to have permissions to access the tenant admin site
 Add a site collection app catalog to the specified site
 
 ```sh
-m365 spo site appcatalog add --siteUrl https://contoso.sharepoint/sites/site
+m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-appcatalog-list.mdx

@@ -64,6 +64,20 @@ m365 spo site appcatalog list
   https://contoso.sharepoint.com/sites/site1,9798e615-b586-455e-8486-84913f492c49
   ```
 
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site appcatalog list
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  AbsoluteUrl | https://contoso.sharepoint.com/sites/site1
+  SiteID | 9798e615-b586-455e-8486-84913f492c49
+  ```
+
   </TabItem>
 </Tabs>