@pnp/cli-microsoft365 6.10.0-beta.bd0bd83 → 6.10.0-beta.f43fa4d

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/m365/spo/commands/theme/theme-get.js

@@ -54,8 +54,7 @@ class SpoThemeGetCommand extends SpoCommand_1.default {
                 if (contents && contents.ErrorInfo) {
                     throw contents.ErrorInfo.ErrorMessage || 'ClientSvc unknown error';
                 }
-                const json2 = yield Promise.resolve(json);
-                const theme = json2[6];
+                const theme = json[6];
                 delete theme._ObjectType_;
                 logger.log(theme);
             }

package/dist/m365/teams/commands/chat/chat-member-add.js

@@ -0,0 +1,117 @@
+"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 _TeamsChatMemberAddCommand_instances, _TeamsChatMemberAddCommand_initTelemetry, _TeamsChatMemberAddCommand_initOptions, _TeamsChatMemberAddCommand_initValidators, _TeamsChatMemberAddCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const validation_1 = require("../../../../utils/validation");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+class TeamsChatMemberAddCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.CHAT_MEMBER_ADD;
+    }
+    get description() {
+        return 'Adds a member to a Microsoft Teams chat conversation.';
+    }
+    constructor() {
+        super();
+        _TeamsChatMemberAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberAddCommand_instances, "m", _TeamsChatMemberAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberAddCommand_instances, "m", _TeamsChatMemberAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberAddCommand_instances, "m", _TeamsChatMemberAddCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberAddCommand_instances, "m", _TeamsChatMemberAddCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.verbose) {
+                    logger.logToStderr(`Adding member ${args.options.userId || args.options.userName} to chat with id ${args.options.chatId}...`);
+                }
+                const chatMemberAddOptions = {
+                    url: `${this.resource}/v1.0/chats/${args.options.chatId}/members`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json',
+                    data: {
+                        '@odata.type': '#microsoft.graph.aadUserConversationMember',
+                        'user@odata.bind': `https://graph.microsoft.com/v1.0/users/${args.options.userId || formatting_1.formatting.encodeQueryParameter(args.options.userName)}`,
+                        visibleHistoryStartDateTime: args.options.includeAllHistory ? '0001-01-01T00:00:00Z' : args.options.visibleHistoryStartDateTime,
+                        roles: [args.options.role || 'owner']
+                    }
+                };
+                yield request_1.default.post(chatMemberAddOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_TeamsChatMemberAddCommand_instances = new WeakSet(), _TeamsChatMemberAddCommand_initTelemetry = function _TeamsChatMemberAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            role: typeof args.options.role !== 'undefined',
+            visibleHistoryStartDateTime: typeof args.options.visibleHistoryStartDateTime !== 'undefined',
+            includeAllHistory: !!args.options.includeAllHistory
+        });
+    });
+}, _TeamsChatMemberAddCommand_initOptions = function _TeamsChatMemberAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --chatId <chatId>'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '--role [role]',
+        autocomplete: TeamsChatMemberAddCommand.roles
+    }, {
+        option: '--visibleHistoryStartDateTime [visibleHistoryStartDateTime]'
+    }, {
+        option: '--includeAllHistory'
+    });
+}, _TeamsChatMemberAddCommand_initValidators = function _TeamsChatMemberAddCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidTeamsChatId(args.options.chatId)) {
+            return `${args.options.chatId} is not a valid chatId.`;
+        }
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid userId.`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid userName.`;
+        }
+        if (args.options.role && TeamsChatMemberAddCommand.roles.indexOf(args.options.role) < 0) {
+            return `${args.options.role} is not a valid role. Allowed values are ${TeamsChatMemberAddCommand.roles.join(', ')}`;
+        }
+        if (args.options.visibleHistoryStartDateTime && !validation_1.validation.isValidISODateTime(args.options.visibleHistoryStartDateTime)) {
+            return `'${args.options.visibleHistoryStartDateTime}' is not a valid visibleHistoryStartDateTime.`;
+        }
+        return true;
+    }));
+}, _TeamsChatMemberAddCommand_initOptionSets = function _TeamsChatMemberAddCommand_initOptionSets() {
+    this.optionSets.push({ options: ['userId', 'userName'] }, {
+        options: ['visibleHistoryStartDateTime', 'includeAllHistory'],
+        runsWhen: (args) => args.options.visibleHistoryStartDateTime || args.options.includeAllHistory
+    });
+};
+TeamsChatMemberAddCommand.roles = ['owner', 'guest'];
+module.exports = new TeamsChatMemberAddCommand();
+//# sourceMappingURL=chat-member-add.js.map

package/dist/m365/teams/commands/team/team-app-list.js

@@ -43,7 +43,7 @@ class TeamsTeamAppListCommand extends GraphCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 if (this.verbose) {
-                    logger.logToStderr(`Retrieving installed apps for team '${args.options.teamId || args.options.teamId}'`);
+                    logger.logToStderr(`Retrieving installed apps for team '${args.options.teamId || args.options.teamName}'`);
                 }
                 const teamId = yield this.getTeamId(args);
                 const res = yield odata_1.odata.getAllItems(`${this.resource}/v1.0/teams/${teamId}/installedApps?$expand=teamsApp,teamsAppDefinition`);

package/dist/m365/teams/commands.js

@@ -20,6 +20,7 @@ exports.default = {
     CHANNEL_SET: `${prefix} channel set`,
     CHAT_GET: `${prefix} chat get`,
     CHAT_LIST: `${prefix} chat list`,
+    CHAT_MEMBER_ADD: `${prefix} chat member add`,
     CHAT_MEMBER_LIST: `${prefix} chat member list`,
     CHAT_MEMBER_REMOVE: `${prefix} chat member remove`,
     CHAT_MESSAGE_LIST: `${prefix} chat message list`,

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/aad/user/user-get.mdx

@@ -25,7 +25,10 @@ m365 aad user get [options]
 : The email of the user to retrieve information for. Use either `id`, `userName` or `email`, but not all.
 
 `-p, --properties [properties]`
-: Comma-separated list of properties to retrieve
+: Comma-separated list of properties to retrieve.
+
+`--withManager`
+: Retrieve the direct manager of the user.
 ```
 
 <Global />
@@ -74,24 +77,113 @@ Get information about the currently logged in user using the UserName token
 m365 aad user get --userName "@meUserName"
 ```
 
+Get information about a user with the manager's details
+
+```sh
+m365 aad user get --userName AarifS@contoso.onmicrosoft.com --withManager
+```
+
 ## Response
 
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "businessPhones": ["+32499-99-99-99"],
+    "displayName": "John Doe",
+    "givenName": "John",
+    "jobTitle": "Sales Manager",
+    "mail": "john.doe@contoso.com",
+    "mobilePhone": "+32499-99-99-99",
+    "officeLocation": "Vosselaar",
+    "preferredLanguage": "nl-BE",
+    "surname": "Doe",
+    "userPrincipalName": "john.doe@contoso.com",
+    "id": "990e2425-f595-43bc-85ed-b89a44093793"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  businessPhones   : ["+32499-99-99-99"]
+  displayName      : John Doe
+  givenName        : John
+  id               : 990e2425-f595-43bc-85ed-b89a44093793
+  jobTitle         : Sales Manager
+  mail             : john.doe@contoso.com
+  mobilePhone      : +32499-99-99-99
+  officeLocation   : Vosselaar
+  preferredLanguage: nl-BE
+  surname          : Doe
+  userPrincipalName: john.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,id
+  John Doe,John,Sales Manager,john.doe@contoso.com,+32499-99-99-99,Vosselaar,nl-BE,Doe,john.doe@contoso.com,990e2425-f595-43bc-85ed-b89a44093793
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad user get --userName "john.doe@contoso.com"
+
+  Date: 16/02/2023
+
+  ## John Doe (990e2425-f595-43bc-85ed-b89a44093793)
+
+  Property | Value
+  ---------|-------
+  displayName | John Doe
+  givenName | John
+  jobTitle | Sales Manager
+  mail | john.doe@contoso.com
+  mobilePhone | +32499-99-99-99
+  officeLocation | Vosselaar
+  preferredLanguage | nl-BE
+  surname | Doe
+  userPrincipalName | john.doe@contoso.com
+  id | 990e2425-f595-43bc-85ed-b89a44093793
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `withManager` response
+
+When we make use of the option `withManager` the response will differ. 
+
 <Tabs>
   <TabItem value="JSON">
 
   ```json
   {
-    "businessPhones": [],
+    "businessPhones": ["+32499-99-99-99"],
     "displayName": "John Doe",
-    "givenName": null,
-    "jobTitle": null,
-    "mail": null,
-    "mobilePhone": null,
-    "officeLocation": null,
-    "preferredLanguage": null,
-    "surname": null,
+    "givenName": "John",
+    "jobTitle": "Sales Manager",
+    "mail": "john.doe@contoso.com",
+    "mobilePhone": "+32499-99-99-99",
+    "officeLocation": "Vosselaar",
+    "preferredLanguage": "nl-BE",
+    "surname": "Doe",
     "userPrincipalName": "john.doe@contoso.com",
-    "id": "74a3b772-3122-447b-b9da-10895e238219"
+    "id": "990e2425-f595-43bc-85ed-b89a44093793",
+    "manager": {
+      "displayName": "Jane Doe",
+      "userPrincipalName": "jane.doe@contoso.com",
+      "id": "eb77fbcf-6fe8-458b-985d-1747284793bc",
+      "mail": "jane.doe@contoso.com"
+    }
   }
   ```
 
@@ -99,16 +191,17 @@ m365 aad user get --userName "@meUserName"
   <TabItem value="Text">
 
   ```text
-  businessPhones   : []
+  businessPhones   : ["+32499-99-99-99"]
   displayName      : John Doe
-  givenName        : null
-  id               : 74a3b772-3122-447b-b9da-10895e238219
-  jobTitle         : null
-  mail             : null
-  mobilePhone      : null
-  officeLocation   : null
-  preferredLanguage: null
-  surname          : null
+  givenName        : John
+  id               : 990e2425-f595-43bc-85ed-b89a44093793
+  jobTitle         : Sales Manager
+  mail             : john.doe@contoso.com
+  manager          : {"displayName":"Jane Doe","userPrincipalName":"jane.doe@contoso.com","id":"eb77fbcf-6fe8-458b-985d-1747284793bc","mail":"jane.doe@contoso.com"}
+  mobilePhone      : +32499-99-99-99
+  officeLocation   : Vosselaar
+  preferredLanguage: nl-BE
+  surname          : Doe
   userPrincipalName: john.doe@contoso.com
   ```
 
@@ -116,15 +209,15 @@ m365 aad user get --userName "@meUserName"
   <TabItem value="CSV">
 
   ```csv
-  displayName,userPrincipalName,id
-  John Doe,john.doe@contoso.com,74a3b772-3122-447b-b9da-10895e238219
+  displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,id
+  John Doe,John,Sales Manager,john.doe@contoso.com,+32499-99-99-99,Vosselaar,nl-BE,Doe,john.doe@contoso.com,990e2425-f595-43bc-85ed-b89a44093793
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # aad user get --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --firstName "John" --lastName "Doe" --jobTitle "Sales Manager" --officeLocation "Vosselaar" --preferredLanguage "nl-BE"
+  # aad user get --userName "john.doe@contoso.com" --withManager
 
   Date: 16/02/2023
 
@@ -135,13 +228,13 @@ m365 aad user get --userName "@meUserName"
   displayName | John Doe
   givenName | John
   jobTitle | Sales Manager
-  mail | null
-  mobilePhone | null
+  mail | john.doe@contoso.com
+  mobilePhone | +32499-99-99-99
   officeLocation | Vosselaar
   preferredLanguage | nl-BE
   surname | Doe
   userPrincipalName | john.doe@contoso.com
-  id | 0649d0bd-53dc-4e1d-a357-76f1d92d447b
+  id | 990e2425-f595-43bc-85ed-b89a44093793
   ```
 
   </TabItem>

package/docs/docs/cmd/pa/app/app-owner-set.mdx

@@ -0,0 +1,60 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa app owner set
+
+Sets a new owner for a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app owner set [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--userId [userId]`
+: The Azure AD ID of the new owner. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: The user principal name of the new owner. Specify either `userId` or `userName` but not both.
+
+`--roleForOldAppOwner [roleForOldAppOwner]`
+: Grant permissions for the previous owner. Allowed values: `CanView`, `CanEdit`. Don't specify a value to remove the previous owner from the app.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be a Global or Power Platform admin.
+
+:::
+
+## Examples
+
+Set a new owner for a Power Apps app and make the previous owner co-owner
+
+```sh
+m365 pa app owner set --environmentName Default-716eb9fb-bf79-4be9-b0c7-900824fcbe25 --appName 7ab97923-4a4d-4467-b030-12071d2b810b --userId c6ee6ed4-0172-4fdc-87a3-cfd9c324de1d --roleForOldAppOwner CanEdit
+```
+
+Set a new owner for a Power Apps app and remove the previous owner
+
+```sh
+m365 pa app owner set --environmentName Default-716eb9fb-bf79-4be9-b0c7-900824fcbe25 --appName 7ab97923-4a4d-4467-b030-12071d2b810b --userName john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.