@pnp/cli-microsoft365 6.4.0-beta.3946b02 → 6.4.0-beta.6b65014

package/dist/m365/flow/commands/owner/owner-add.js

@@ -0,0 +1,147 @@
+"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 _FlowOwnerAddCommand_instances, _FlowOwnerAddCommand_initTelemetry, _FlowOwnerAddCommand_initOptions, _FlowOwnerAddCommand_initOptionSets, _FlowOwnerAddCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const aadGroup_1 = require("../../../../utils/aadGroup");
+const aadUser_1 = require("../../../../utils/aadUser");
+const formatting_1 = require("../../../../utils/formatting");
+const validation_1 = require("../../../../utils/validation");
+const AzmgmtCommand_1 = require("../../../base/AzmgmtCommand");
+const commands_1 = require("../../commands");
+class FlowOwnerAddCommand extends AzmgmtCommand_1.default {
+    get name() {
+        return commands_1.default.OWNER_ADD;
+    }
+    get description() {
+        return 'Assigns permissions to a Power Automate flow';
+    }
+    constructor() {
+        super();
+        _FlowOwnerAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _FlowOwnerAddCommand_instances, "m", _FlowOwnerAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerAddCommand_instances, "m", _FlowOwnerAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerAddCommand_instances, "m", _FlowOwnerAddCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerAddCommand_instances, "m", _FlowOwnerAddCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.verbose) {
+                    logger.logToStderr(`Assigning permissions for ${args.options.userId || args.options.userName || args.options.groupId || args.options.groupName} with permissions ${args.options.roleName} to Power Automate flow ${args.options.flowName}`);
+                }
+                let id = '';
+                if (args.options.userId) {
+                    id = args.options.userId;
+                }
+                else if (args.options.userName) {
+                    id = yield aadUser_1.aadUser.getUserIdByUpn(args.options.userName);
+                }
+                else if (args.options.groupId) {
+                    id = args.options.groupId;
+                }
+                else {
+                    id = yield aadGroup_1.aadGroup.getGroupIdByDisplayName(args.options.groupName);
+                }
+                let type;
+                if (args.options.userId || args.options.userName) {
+                    type = 'User';
+                }
+                else {
+                    type = 'Group';
+                }
+                const requestOptions = {
+                    url: `${this.resource}providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting_1.formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting_1.formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
+                    headers: {
+                        accept: 'application/json'
+                    },
+                    data: {
+                        put: [
+                            {
+                                properties: {
+                                    principal: {
+                                        id: id,
+                                        type: type
+                                    },
+                                    roleName: args.options.roleName
+                                }
+                            }
+                        ]
+                    },
+                    responseType: 'json'
+                };
+                yield request_1.default.post(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_FlowOwnerAddCommand_instances = new WeakSet(), _FlowOwnerAddCommand_initTelemetry = function _FlowOwnerAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            asAdmin: !!args.options.asAdmin,
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            groupId: typeof args.options.groupId !== 'undefined',
+            groupName: typeof args.options.groupName !== 'undefined'
+        });
+    });
+}, _FlowOwnerAddCommand_initOptions = function _FlowOwnerAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-e, --environmentName <environmentName>'
+    }, {
+        option: '-f, --flowName <flowName>'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '--groupId [groupId]'
+    }, {
+        option: '--groupName [groupName]'
+    }, {
+        option: '--roleName <roleName>',
+        autocomplete: FlowOwnerAddCommand.allowedRoleNames
+    }, {
+        option: '--asAdmin'
+    });
+}, _FlowOwnerAddCommand_initOptionSets = function _FlowOwnerAddCommand_initOptionSets() {
+    this.optionSets.push({ options: ['userId', 'userName', 'groupId', 'groupName'] });
+}, _FlowOwnerAddCommand_initValidators = function _FlowOwnerAddCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.flowName)) {
+            return `${args.options.flowName} is not a valid GUID.`;
+        }
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID.`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid userName.`;
+        }
+        if (args.options.groupId && !validation_1.validation.isValidGuid(args.options.groupId)) {
+            return `${args.options.groupId} is not a valid GUID.`;
+        }
+        if (FlowOwnerAddCommand.allowedRoleNames.indexOf(args.options.roleName) === -1) {
+            return `${args.options.roleName} is not a valid roleName. Valid values are: ${FlowOwnerAddCommand.allowedRoleNames.join(', ')}`;
+        }
+        return true;
+    }));
+};
+FlowOwnerAddCommand.allowedRoleNames = ['CanView', 'CanEdit'];
+module.exports = new FlowOwnerAddCommand();
+//# sourceMappingURL=owner-add.js.map

package/dist/m365/flow/commands/owner/owner-remove.js

@@ -0,0 +1,147 @@
+"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 _FlowOwnerRemoveCommand_instances, _FlowOwnerRemoveCommand_initTelemetry, _FlowOwnerRemoveCommand_initOptions, _FlowOwnerRemoveCommand_initValidators, _FlowOwnerRemoveCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Cli_1 = require("../../../../cli/Cli");
+const request_1 = require("../../../../request");
+const aadGroup_1 = require("../../../../utils/aadGroup");
+const aadUser_1 = require("../../../../utils/aadUser");
+const formatting_1 = require("../../../../utils/formatting");
+const validation_1 = require("../../../../utils/validation");
+const AzmgmtCommand_1 = require("../../../base/AzmgmtCommand");
+const commands_1 = require("../../commands");
+class FlowOwnerRemoveCommand extends AzmgmtCommand_1.default {
+    get name() {
+        return commands_1.default.OWNER_REMOVE;
+    }
+    get description() {
+        return 'Removes owner permissions to a Power Automate flow';
+    }
+    constructor() {
+        super();
+        _FlowOwnerRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _FlowOwnerRemoveCommand_instances, "m", _FlowOwnerRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerRemoveCommand_instances, "m", _FlowOwnerRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerRemoveCommand_instances, "m", _FlowOwnerRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _FlowOwnerRemoveCommand_instances, "m", _FlowOwnerRemoveCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.verbose) {
+                    logger.logToStderr(`Removing owner ${args.options.userId || args.options.userName || args.options.groupId || args.options.groupName} from flow ${args.options.flowName} in environment ${args.options.environmentName}`);
+                }
+                const removeFlowOwner = () => __awaiter(this, void 0, void 0, function* () {
+                    let idToRemove = '';
+                    if (args.options.userId) {
+                        idToRemove = args.options.userId;
+                    }
+                    else if (args.options.userName) {
+                        idToRemove = yield aadUser_1.aadUser.getUserIdByUpn(args.options.userName);
+                    }
+                    else if (args.options.groupId) {
+                        idToRemove = args.options.groupId;
+                    }
+                    else {
+                        idToRemove = yield aadGroup_1.aadGroup.getGroupIdByDisplayName(args.options.groupName);
+                    }
+                    const requestOptions = {
+                        url: `${this.resource}providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting_1.formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting_1.formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
+                        headers: {
+                            accept: 'application/json'
+                        },
+                        data: {
+                            delete: [
+                                {
+                                    id: idToRemove
+                                }
+                            ]
+                        },
+                        responseType: 'json'
+                    };
+                    yield request_1.default.post(requestOptions);
+                });
+                if (args.options.confirm) {
+                    yield removeFlowOwner();
+                }
+                else {
+                    const result = yield Cli_1.Cli.prompt({
+                        type: 'confirm',
+                        name: 'continue',
+                        default: false,
+                        message: `Are you sure you want to remove owner '${args.options.groupId || args.options.groupName || args.options.userId || args.options.userName}' from the specified flow?`
+                    });
+                    if (result.continue) {
+                        yield removeFlowOwner();
+                    }
+                }
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_FlowOwnerRemoveCommand_instances = new WeakSet(), _FlowOwnerRemoveCommand_initTelemetry = function _FlowOwnerRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            groupId: typeof args.options.groupId !== 'undefined',
+            groupName: typeof args.options.groupName !== 'undefined',
+            asAdmin: !!args.options.asAdmin,
+            confirm: !!args.options.confirm
+        });
+    });
+}, _FlowOwnerRemoveCommand_initOptions = function _FlowOwnerRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-e, --environmentName <environmentName>'
+    }, {
+        option: '-f, --flowName <flowName>'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '--groupId [groupId]'
+    }, {
+        option: '--groupName [groupName]'
+    }, {
+        option: '--asAdmin'
+    }, {
+        option: '--confirm'
+    });
+}, _FlowOwnerRemoveCommand_initValidators = function _FlowOwnerRemoveCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.flowName)) {
+            return `${args.options.flowName} is not a valid GUID.`;
+        }
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID.`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid userName.`;
+        }
+        if (args.options.groupId && !validation_1.validation.isValidGuid(args.options.groupId)) {
+            return `${args.options.groupId} is not a valid GUID.`;
+        }
+        return true;
+    }));
+}, _FlowOwnerRemoveCommand_initOptionSets = function _FlowOwnerRemoveCommand_initOptionSets() {
+    this.optionSets.push({ options: ['userId', 'userName', 'groupId', 'groupName'] });
+};
+module.exports = new FlowOwnerRemoveCommand();
+//# sourceMappingURL=owner-remove.js.map

package/dist/m365/flow/commands/run/run-list.js

@@ -42,7 +42,7 @@ class FlowRunListCommand extends AzmgmtItemsListCommand_1.AzmgmtItemsListCommand
             if (this.verbose) {
                 logger.logToStderr(`Retrieving list of runs for Microsoft Flow ${args.options.flowName}...`);
             }
-            let url = `${this.resource}providers/Microsoft.ProcessSimple/environments/${formatting_1.formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting_1.formatting.encodeQueryParameter(args.options.flowName)}/runs?api-version=2016-11-01`;
+            let url = `${this.resource}providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting_1.formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting_1.formatting.encodeQueryParameter(args.options.flowName)}/runs?api-version=2016-11-01`;
             const filters = this.getFilters(args.options);
             if (filters.length > 0) {
                 url += `&$filter=${filters.join(' and ')}`;
@@ -86,7 +86,8 @@ _FlowRunListCommand_instances = new WeakSet(), _FlowRunListCommand_initTelemetry
         Object.assign(this.telemetryProperties, {
             status: typeof args.options.status !== 'undefined',
             triggerStartTime: typeof args.options.triggerStartTime !== 'undefined',
-            triggerEndTime: typeof args.options.triggerEndTime !== 'undefined'
+            triggerEndTime: typeof args.options.triggerEndTime !== 'undefined',
+            asAdmin: !!args.options.asAdmin
         });
     });
 }, _FlowRunListCommand_initOptions = function _FlowRunListCommand_initOptions() {
@@ -101,6 +102,8 @@ _FlowRunListCommand_instances = new WeakSet(), _FlowRunListCommand_initTelemetry
         option: '--triggerStartTime [triggerStartTime]'
     }, {
         option: '--triggerEndTime [triggerEndTime]'
+    }, {
+        option: '--asAdmin'
     });
 }, _FlowRunListCommand_initValidators = function _FlowRunListCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {

package/dist/m365/flow/commands.js

@@ -11,7 +11,9 @@ exports.default = {
     EXPORT: `${prefix} export`,
     GET: `${prefix} get`,
     LIST: `${prefix} list`,
+    OWNER_ADD: `${prefix} owner add`,
     OWNER_LIST: `${prefix} owner list`,
+    OWNER_REMOVE: `${prefix} owner remove`,
     REMOVE: `${prefix} remove`,
     RUN_CANCEL: `${prefix} run cancel`,
     RUN_GET: `${prefix} run get`,

package/dist/m365/planner/commands/roster/roster-member-get.js

@@ -0,0 +1,98 @@
+"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 _PlannerRosterMemberGetCommand_instances, _PlannerRosterMemberGetCommand_initTelemetry, _PlannerRosterMemberGetCommand_initOptions, _PlannerRosterMemberGetCommand_initOptionSets, _PlannerRosterMemberGetCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const validation_1 = require("../../../../utils/validation");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const aadUser_1 = require("../../../../utils/aadUser");
+class PlannerRosterMemberGetCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.ROSTER_MEMBER_GET;
+    }
+    get description() {
+        return 'Gets a member of the specified Microsoft Planner Roster';
+    }
+    constructor() {
+        super();
+        _PlannerRosterMemberGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _PlannerRosterMemberGetCommand_instances, "m", _PlannerRosterMemberGetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _PlannerRosterMemberGetCommand_instances, "m", _PlannerRosterMemberGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _PlannerRosterMemberGetCommand_instances, "m", _PlannerRosterMemberGetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _PlannerRosterMemberGetCommand_instances, "m", _PlannerRosterMemberGetCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving member ${args.options.userName || args.options.userId} from the Microsoft Planner Roster`);
+            }
+            try {
+                const userId = yield this.getUserId(args);
+                const requestOptions = {
+                    url: `${this.resource}/beta/planner/rosters/${args.options.rosterId}/members/${userId}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json'
+                };
+                const response = yield request_1.default.get(requestOptions);
+                logger.log(response);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    getUserId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.userId) {
+                return args.options.userId;
+            }
+            return aadUser_1.aadUser.getUserIdByUpn(args.options.userName);
+        });
+    }
+}
+_PlannerRosterMemberGetCommand_instances = new WeakSet(), _PlannerRosterMemberGetCommand_initTelemetry = function _PlannerRosterMemberGetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined'
+        });
+    });
+}, _PlannerRosterMemberGetCommand_initOptions = function _PlannerRosterMemberGetCommand_initOptions() {
+    this.options.unshift({
+        option: '--rosterId <rosterId>'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    });
+}, _PlannerRosterMemberGetCommand_initOptionSets = function _PlannerRosterMemberGetCommand_initOptionSets() {
+    this.optionSets.push({ options: ['userId', 'userName'] });
+}, _PlannerRosterMemberGetCommand_initValidators = function _PlannerRosterMemberGetCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid userName`;
+        }
+        return true;
+    }));
+};
+module.exports = new PlannerRosterMemberGetCommand();
+//# sourceMappingURL=roster-member-get.js.map

package/dist/m365/planner/commands.js

@@ -15,6 +15,7 @@ exports.default = {
     ROSTER_ADD: `${prefix} roster add`,
     ROSTER_GET: `${prefix} roster get`,
     ROSTER_MEMBER_ADD: `${prefix} roster member add`,
+    ROSTER_MEMBER_GET: `${prefix} roster member get`,
     ROSTER_MEMBER_LIST: `${prefix} roster member list`,
     ROSTER_MEMBER_REMOVE: `${prefix} roster member remove`,
     ROSTER_REMOVE: `${prefix} roster remove`,

package/dist/m365/spo/commands/customaction/customaction-get.js

@@ -77,14 +77,26 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
                 }
                 return customAction;
             }
-            const customActions = yield spo_1.spo.getCustomActions(options.webUrl, options.scope, `Title eq '${formatting_1.formatting.encodeQueryParameter(options.title)}'`);
-            if (customActions.length === 1) {
-                return customActions[0];
+            else if (options.title) {
+                const customActions = yield spo_1.spo.getCustomActions(options.webUrl, options.scope, `Title eq '${formatting_1.formatting.encodeQueryParameter(options.title)}'`);
+                if (customActions.length === 1) {
+                    return customActions[0];
+                }
+                if (customActions.length === 0) {
+                    throw `No user custom action with title '${options.title}' found`;
+                }
+                throw `Multiple user custom actions with title '${options.title}' found. Please disambiguate using IDs: ${customActions.map(a => a.Id).join(', ')}`;
             }
-            if (customActions.length === 0) {
-                throw `No user custom action with title '${options.title}' found`;
+            else {
+                const customActions = yield spo_1.spo.getCustomActions(options.webUrl, options.scope, `ClientSideComponentId eq guid'${options.clientSideComponentId}'`);
+                if (customActions.length === 0) {
+                    throw `No user custom action with ClientSideComponentId '${options.clientSideComponentId}' found`;
+                }
+                if (customActions.length > 1) {
+                    throw `Multiple user custom actions with ClientSideComponentId '${options.clientSideComponentId}' found. Please disambiguate using IDs: ${customActions.map((customAction) => customAction.Id).join(', ')}`;
+                }
+                return customActions[0];
             }
-            throw `Multiple user custom actions with title '${options.title}' found. Please disambiguate using IDs: ${customActions.map(a => a.Id).join(', ')}`;
         });
     }
     humanizeScope(scope) {
@@ -100,6 +112,9 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
 _SpoCustomActionGetCommand_instances = new WeakSet(), _SpoCustomActionGetCommand_initTelemetry = function _SpoCustomActionGetCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
+            id: typeof args.options.id !== 'undefined',
+            title: typeof args.options.title !== 'undefined',
+            clientSideComponentId: typeof args.options.clientSideComponentId !== 'undefined',
             scope: args.options.scope || 'All'
         });
     });
@@ -108,6 +123,8 @@ _SpoCustomActionGetCommand_instances = new WeakSet(), _SpoCustomActionGetCommand
         option: '-i, --id [id]'
     }, {
         option: '-t, --title [title]'
+    }, {
+        option: '-c, --clientSideComponentId [clientSideComponentId]'
     }, {
         option: '-u, --webUrl <webUrl>'
     }, {
@@ -130,10 +147,13 @@ _SpoCustomActionGetCommand_instances = new WeakSet(), _SpoCustomActionGetCommand
                 return `${args.options.scope} is not a valid custom action scope. Allowed values are Site|Web|All`;
             }
         }
+        if (args.options.clientSideComponentId && validation_1.validation.isValidGuid(args.options.clientSideComponentId) === false) {
+            return `${args.options.clientSideComponentId} is not a valid GUID.`;
+        }
         return true;
     }));
 }, _SpoCustomActionGetCommand_initOptionSets = function _SpoCustomActionGetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['id', 'title'] });
+    this.optionSets.push({ options: ['id', 'title', 'clientSideComponentId'] });
 };
 module.exports = new SpoCustomActionGetCommand();
 //# sourceMappingURL=customaction-get.js.map

package/dist/m365/spo/commands/file/file-move.js

@@ -55,7 +55,7 @@ class SpoFileMoveCommand extends SpoCommand_1.default {
                 // A user might enter folder instead of file as source url by mistake
                 // then there are edge cases when deleteIfAlreadyExists flag is set
                 // the user can receive misleading error message.
-                this.fileExists(tenantUrl, webUrl, args.options.sourceUrl);
+                yield this.fileExists(tenantUrl, webUrl, args.options.sourceUrl);
                 if (args.options.deleteIfAlreadyExists) {
                     // try delete target file, if deleteIfAlreadyExists flag is set
                     const filename = args.options.sourceUrl.replace(/^.*[\\\/]/, '');

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

@@ -106,7 +106,7 @@ class SpoListAddCommand extends SpoCommand_1.default {
     mapRequestBody(options) {
         const requestBody = {
             Title: options.title,
-            BaseTemplate: ListTemplateType_1.ListTemplateType[options.baseTemplate.trim()].valueOf()
+            BaseTemplate: options.baseTemplate ? ListTemplateType_1.ListTemplateType[options.baseTemplate.trim()].valueOf() : ListTemplateType_1.ListTemplateType.GenericList
         };
         if (options.description) {
             requestBody.Description = options.description;
@@ -148,7 +148,7 @@ class SpoListAddCommand extends SpoCommand_1.default {
             requestBody.DisableGridEditing = options.disableGridEditing;
         }
         if (options.draftVersionVisibility) {
-            requestBody.DraftVersionVisibility = options.draftVersionVisibility;
+            requestBody.DraftVersionVisibility = DraftVisibilityType_1.DraftVisibilityType[options.draftVersionVisibility.trim()];
         }
         if (options.emailAlias) {
             requestBody.EmailAlias = options.emailAlias;
@@ -226,7 +226,7 @@ class SpoListAddCommand extends SpoCommand_1.default {
             requestBody.IsApplicationList = options.isApplicationList;
         }
         if (options.listExperienceOptions) {
-            requestBody.ListExperienceOptions = options.listExperienceOptions;
+            requestBody.ListExperienceOptions = ListExperience_1.ListExperience[options.listExperienceOptions.trim()];
         }
         if (options.majorVersionLimit) {
             requestBody.MajorVersionLimit = options.majorVersionLimit;
@@ -296,6 +296,7 @@ _SpoListAddCommand_instances = new WeakSet(), _SpoListAddCommand_initTelemetry =
         const telemetryProps = {};
         // add properties with identifiable data
         [
+            'baseTemplate',
             'description',
             'templateFeatureId',
             'schemaXml',
@@ -342,7 +343,7 @@ _SpoListAddCommand_instances = new WeakSet(), _SpoListAddCommand_initTelemetry =
     this.options.unshift({
         option: '-t, --title <title>'
     }, {
-        option: '--baseTemplate <baseTemplate>',
+        option: '--baseTemplate [baseTemplate]',
         autocomplete: this.listTemplateTypeMap
     }, {
         option: '-u, --webUrl <webUrl>'
@@ -520,9 +521,11 @@ _SpoListAddCommand_instances = new WeakSet(), _SpoListAddCommand_initTelemetry =
         if (isValidSharePointUrl !== true) {
             return isValidSharePointUrl;
         }
-        const template = ListTemplateType_1.ListTemplateType[args.options.baseTemplate.trim()];
-        if (!template) {
-            return `${args.options.baseTemplate} is not a valid baseTemplate value`;
+        if (args.options.baseTemplate) {
+            const template = ListTemplateType_1.ListTemplateType[args.options.baseTemplate.trim()];
+            if (!template) {
+                return `${args.options.baseTemplate} is not a valid baseTemplate value`;
+            }
         }
         if (args.options.templateFeatureId &&
             !validation_1.validation.isValidGuid(args.options.templateFeatureId)) {
@@ -538,7 +541,7 @@ _SpoListAddCommand_instances = new WeakSet(), _SpoListAddCommand_initTelemetry =
         }
         if (args.options.draftVersionVisibility) {
             const draftType = DraftVisibilityType_1.DraftVisibilityType[args.options.draftVersionVisibility.trim()];
-            if (!draftType) {
+            if (draftType === undefined) {
                 return `${args.options.draftVersionVisibility} is not a valid draftVisibilityType value`;
             }
         }

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

@@ -150,7 +150,7 @@ class SpoListSetCommand extends SpoCommand_1.default {
             requestBody.DisableGridEditing = options.disableGridEditing;
         }
         if (options.draftVersionVisibility) {
-            requestBody.DraftVersionVisibility = options.draftVersionVisibility;
+            requestBody.DraftVersionVisibility = DraftVisibilityType_1.DraftVisibilityType[options.draftVersionVisibility.trim()];
         }
         if (options.emailAlias) {
             requestBody.EmailAlias = options.emailAlias;
@@ -228,7 +228,7 @@ class SpoListSetCommand extends SpoCommand_1.default {
             requestBody.IsApplicationList = options.isApplicationList;
         }
         if (options.listExperienceOptions) {
-            requestBody.ListExperienceOptions = options.listExperienceOptions;
+            requestBody.ListExperienceOptions = ListExperience_1.ListExperience[options.listExperienceOptions.trim()];
         }
         if (options.majorVersionLimit) {
             requestBody.MajorVersionLimit = options.majorVersionLimit;
@@ -545,7 +545,7 @@ _SpoListSetCommand_instances = new WeakSet(), _SpoListSetCommand_initTelemetry =
         }
         if (args.options.draftVersionVisibility) {
             const draftType = DraftVisibilityType_1.DraftVisibilityType[args.options.draftVersionVisibility.trim()];
-            if (!draftType) {
+            if (draftType === undefined) {
                 return `${args.options.draftVersionVisibility} is not a valid draftVisibilityType value`;
             }
         }

package/dist/utils/aadGroup.js

@@ -53,6 +53,24 @@ exports.aadGroup = {
             }
             return groups[0];
         });
+    },
+    /**
+     * Get id of a group by its display name.
+     * @param displayName Group display name.
+     * @throws Error when group was not found.
+     * @throws Error when multiple groups with the same name were found.
+     */
+    getGroupIdByDisplayName(displayName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const groups = yield odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(displayName)}'&$select=id`);
+            if (!groups.length) {
+                throw Error(`The specified group '${displayName}' does not exist.`);
+            }
+            if (groups.length > 1) {
+                throw Error(`Multiple groups with name '${displayName}' found: ${groups.map(x => x.id).join(',')}.`);
+            }
+            return groups[0].id;
+        });
     }
 };
 //# sourceMappingURL=aadGroup.js.map

package/docs/docs/cmd/flow/owner/owner-add.md

@@ -0,0 +1,61 @@
+# flow owner add
+
+Assigns permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner add [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--roleName <roleName>`
+: Access level for the user on the flow. Valid options are `CanView` or `CanEdit`.
+
+`--asAdmin`
+: Run the command as admin.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Assign owner permissions to a specific Power Automate flow for a user with ID
+
+```sh
+m365 flow owner add --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a user with UPN
+
+```sh
+m365 flow owner add --userName "john.doe@contoso.com" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a group
+
+```sh
+m365 flow owner add --groupId 8d4d9f32-1ab0-4f81-9054-efbb1759e8e6 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/flow/owner/owner-remove.md

@@ -0,0 +1,67 @@
+# flow owner remove
+
+Removes owner permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner remove [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--asAdmin`
+: Run the command as admin.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove owner permissions from a specific Power Automate flow for a user by ID without prompting for confirmation
+
+```sh
+m365 flow owner remove --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --confirm
+```
+
+Remove owner permissions from a specific Power Automate flow for a user by UPN as admin
+
+```sh
+m365 flow owner remove --userName john.doe@contoso.com --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by ID
+
+```sh
+m365 flow owner remove --groupId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by name as admin
+
+```sh
+m365 flow owner remove --groupName "Test group" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -25,6 +25,9 @@ m365 flow run list [options]
 `--triggerEndTime [triggerEndTime]`
 : Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
 
+`--asAdmin`
+: Run the command as admin. Use this flag when targeting flows you don't own.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -56,6 +59,12 @@ List runs of the specified Microsoft Flow between a specific time range
 m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --triggerStartTime 2023-01-21T18:19:00Z --triggerEndTime 2023-01-22T00:00:00Z
 ```
 
+List runs of the specified Microsoft Flow owned by another user
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --asAdmin
+```
+
 ## Response
 
 ### Standard response
@@ -123,3 +132,22 @@ m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c
     name,startTime,status
     08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,Running
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow run list --environmentName "Default-de348bc7-1aeb-4406-8cb3-97db021cadb4" --flowName "08585329112602833828909892130CU17"
+
+    Date: 1/3/2023
+
+    ## 08585329112602833828909892130CU17 (/providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17)
+
+    Property | Value
+    ---------|-------
+    name | 08585329112602833828909892130CU17
+    id | /providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    properties | {"startTime":"2022-11-17T14:33:45.2763872Z","status":"Running","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"trigger":{"name":"When_a_new_response_is_submitted","inputsLink":{"uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=jmdMRWvY7uGoxTmqd3_a2bJtegXuVyuKTKKUVLiwh38","contentVersion":"6ZrBBE+MJg7IvhMgyJLMmA==","contentSize":349,"contentHash":{"algorithm":"md5","value":"6ZrBBE+MJg7IvhMgyJLMmA=="}},"outputsLink":{"uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=Y3qqjuWrrcQJrmF7uvm6LVzQy5w-dNOFWJ8Yt8khXvA","contentVersion":"Z/4a8tfYygNAR1xpc44iww==","contentSize":493,"contentHash":{"algorithm":"md5","value":"Z/4a8tfYygNAR1xpc44iww=="}},"startTime":"2022-11-17T14:33:45.1914506Z","endTime":"2022-11-17T14:33:45.1914506Z","originHistoryName":"08585329112602833829909892130CU00","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"status":"Succeeded"}}
+    startTime | 2022-11-17T14:33:45.2763872Z
+    status | Running
+    ```

package/docs/docs/cmd/planner/roster/roster-member-get.md

@@ -0,0 +1,87 @@
+# planner roster member get
+
+Gets a member of the specified Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster member get [options]
+```
+
+## Options
+
+`--rosterId <rosterId>`
+: ID of the Planner Roster.
+
+`--userId [userId]`
+: User's Azure AD ID. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Gets a specific user by user name as member of the Planner Roster
+
+```sh
+m365 planner roster member get --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userName john.doe@contoso.com
+```
+
+Gets a specific user by ID as member of the Planner Roster
+
+```sh
+m365 planner roster member get --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId d049a857-f1c3-4fb3-a629-d8cfb3bd7275
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "b3a1be03-54a5-43d2-b4fb-6562fe9bec0b",
+      "userId": "2056d2f6-3257-4253-8cfc-b73393e414e5",
+      "tenantId": "5b7b813c-2339-48cd-8c51-bd4fcb269420",
+      "roles": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    id      : b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
+    roles   : []
+    tenantId: 5b7b813c-2339-48cd-8c51-bd4fcb269420
+    userId  : 2056d2f6-3257-4253-8cfc-b73393e414e5
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,userId,tenantId,roles
+    b3a1be03-54a5-43d2-b4fb-6562fe9bec0b,2056d2f6-3257-4253-8cfc-b73393e414e5,5b7b813c-2339-48cd-8c51-bd4fcb269420,[]
+    ```
+    
+=== "Markdown"
+
+    ```md
+    # planner roster member get --rosterId "tYqYlNd6eECmsNhN_fcq85cAGAnd" --userId "2056d2f6-3257-4253-8cfc-b73393e414e5"
+
+    Date: 18/2/2023
+
+    ## b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
+
+    Property | Value
+    ---------|-------
+    id | b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
+    userId | 2056d2f6-3257-4253-8cfc-b73393e414e5
+    tenantId | 5b7b813c-2339-48cd-8c51-bd4fcb269420
+    roles | []
+    ```

package/docs/docs/cmd/spo/customaction/customaction-get.md

@@ -11,10 +11,13 @@ m365 spo customaction get [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the user custom action to retrieve information for. Specify either `id` or `title`
+: ID of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
 
 `-t, --title [title]`
-: Title of the user custom action to retrieve information for. Specify either `id` or `title`
+: Title of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
+
+`-c, --clientSideComponentId [clientSideComponentId]`
+: clientSideComponentId of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
 
 `-u, --webUrl <webUrl>`
 : Url of the site or site collection to retrieve the custom action from
@@ -26,34 +29,133 @@ m365 spo customaction get [options]
 
 ## Remarks
 
-If the command finds multiple user custom actions with the specified title, it will prompt you to disambiguate which user custom action it should use, listing the discovered IDs.
+If the command finds multiple user custom actions with the specified `title` or `clientSideComponentId`, it will prompt you to disambiguate which user custom action it should get, listing the discovered IDs.
 
 ## Examples
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site or site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the id and a given url
 
 ```sh
 m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test
 ```
 
-Return details about the user custom action with Title _YourAppCustomizer_ located in site or site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the title and a given url
 
 ```sh
 m365 spo customaction get --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test
 ```
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the clientSideComponentId and a given url
+
+```sh
+m365 spo customaction get --clientSideComponentId "34a019f9-6198-4053-a3b6-fbdea9a107fd" --webUrl https://contoso.sharepoint.com/sites/test
+```
+
+Return details about the user custom action based on the id and a given url and the scope
 
 ```sh
-m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Site
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Site
 ```
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the id and a given url and the scope
 
 ```sh
-m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Web
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Web
 ```
 
-## More information
+Return details about the user custom action based on the id and a given url and the scope
+
+```sh
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Web
+```
 
-- UserCustomAction REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction](https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction)
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientSideComponentId": "34a019f9-6198-4053-a3b6-fbdea9a107fd",
+      "ClientSideComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
+      "CommandUIExtension": null,
+      "Description": null,
+      "Group": null,
+      "Id": "158cb0d1-8703-4a36-866d-84aed8233bd3",
+      "ImageUrl": null,
+      "Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
+      "Name": "{158cb0d1-8703-4a36-866d-84aed8233bd3}",
+      "RegistrationId": "100",
+      "RegistrationType": 1,
+      "Rights": "{\"High\":0,\"Low\":0}",
+      "Scope": "Web",
+      "ScriptBlock": null,
+      "ScriptSrc": null,
+      "Sequence": 65536,
+      "Title": "ExtensionTraining",
+      "Url": null,
+      "VersionOfUserCustomAction": "1.0.1.0"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientSideComponentId        : 34a019f9-6198-4053-a3b6-fbdea9a107fd
+    ClientSideComponentProperties: {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
+    CommandUIExtension           : null
+    Description                  : null
+    Group                        : null
+    Id                           : 158cb0d1-8703-4a36-866d-84aed8233bd3
+    ImageUrl                     : null
+    Location                     : ClientSideExtension.ListViewCommandSet.CommandBar
+    Name                         : {158cb0d1-8703-4a36-866d-84aed8233bd3}
+    RegistrationId               : 100
+    RegistrationType             : 1
+    Rights                       : {"High":0,"Low":0}
+    Scope                        : Web
+    ScriptBlock                  : null
+    ScriptSrc                    : null
+    Sequence                     : 65536
+    Title                        : ExtensionTraining
+    Url                          : null
+    VersionOfUserCustomAction    : 1.0.1.0
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
+    34a019f9-6198-4053-a3b6-fbdea9a107fd,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,158cb0d1-8703-4a36-866d-84aed8233bd3,,ClientSideExtension.ListViewCommandSet.CommandBar,{158cb0d1-8703-4a36-866d-84aed8233bd3},100,1,"{""High"":0,""Low"":0}",Web,,,65536,ExtensionTraining,,1.0.1.0
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo customaction get --webUrl "https://contoso.sharepoint.com" --clientSideComponentId "34a019f9-6198-4053-a3b6-fbdea9a107fd" --scope "Web"
+
+    Date: 27/1/2023
+
+    ## ExtensionTraining (158cb0d1-8703-4a36-866d-84aed8233bd3)
+
+    Property | Value
+    ---------|-------
+    ClientSideComponentId | 34a019f9-6198-4053-a3b6-fbdea9a107fd
+    ClientSideComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
+    CommandUIExtension | null
+    Description | null
+    Group | null
+    Id | 158cb0d1-8703-4a36-866d-84aed8233bd3
+    ImageUrl | null
+    Location | ClientSideExtension.ListViewCommandSet.CommandBar
+    Name | {158cb0d1-8703-4a36-866d-84aed8233bd3}
+    RegistrationId | 100
+    RegistrationType | 1
+    Rights | {"High":0,"Low":0}
+    Scope | Web
+    ScriptBlock | null
+    ScriptSrc | null
+    Sequence | 65536
+    Title | ExtensionTraining
+    Url | null
+    VersionOfUserCustomAction | 1.0.1.0
+    ```

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

@@ -13,8 +13,8 @@ m365 spo list add [options]
 `-t, --title <title>`
 : Title of the list to add.
 
-`--baseTemplate <baseTemplate>`
-: The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default `GenericList`.
+`--baseTemplate [baseTemplate]`
+: The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default value is `GenericList`.
 
 `-u, --webUrl <webUrl>`
 : URL of the site where the list should be added.

package/docs/docs/cmd/spo/list/list-set.md

@@ -59,7 +59,7 @@ m365 spo list set [options]
 : Property for assigning or retrieving grid editing on the list. Valid values are `true`, `false`.
 
 `--draftVersionVisibility [draftVersionVisibility]`
-: Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`. Default `Reader`.
+: Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`.
 
 `--emailAlias [emailAlias]`
 : If e-mail notification is enabled, gets or sets the e-mail address to use tonotify to the owner of an item when an assignment has changed or the item has been updated.
@@ -137,7 +137,7 @@ m365 spo list set [options]
 : Indicates whether this list should be treated as a top level navigation object or not.
 
 `--listExperienceOptions [listExperienceOptions]`
-: Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`. Default `Auto`.
+: Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`.
 
 `--majorVersionLimit [majorVersionLimit]`
 : Gets or sets the maximum number of major versions allowed for an item in a document library that uses version control with major versions only.

package/package.json

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