@pnp/cli-microsoft365 7.3.0 → 7.4.0-beta.4c4cef8

package/docs/docs/cmd/{aad → entra}/user/user-recyclebinitem-restore.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad user recyclebinitem restore
+# entra user recyclebinitem restore
 
 Restores a user from the recycle bin in the current tenant
 
 ## Usage
 
+```sh
+m365 entra user recyclebinitem restore [options]
+```
+
+## Alias
+
 ```sh
 m365 aad user recyclebinitem restore [options]
 ```
@@ -40,7 +46,7 @@ After running this command, it may take a minute before the user will reappear i
 Restore user from the recycle bin.
 
 ```sh
-m365 aad user recyclebinitem restore --id 990e2425-f595-43bc-85ed-b89a44093793
+m365 entra user recyclebinitem restore --id 990e2425-f595-43bc-85ed-b89a44093793
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/user/user-remove.mdx

@@ -1,11 +1,17 @@
 import Global from '/docs/cmd/_global.mdx';
 
-# aad user remove
+# entra user remove
 
 Removes a specific user
 
 ## Usage
 
+```sh
+m365 entra user remove [options]
+```
+
+## Alias
+
 ```sh
 m365 aad user remove [options]
 ```
@@ -50,13 +56,13 @@ After running this command, it may take a minute before the user is effectively
 Removes a specific user by id
 
 ```sh
-m365 aad user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
+m365 entra user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
 ```
 
 Removes a specific user by its UPN
 
 ```sh
-m365 aad user remove --userName john.doe@contoso.com
+m365 entra user remove --userName john.doe@contoso.com
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/user/user-set.mdx

@@ -1,11 +1,17 @@
 import Global from '/docs/cmd/_global.mdx';
 
-# aad user set
+# entra user set
 
 Updates information of the specified user
 
 ## Usage
 
+```sh
+m365 entra user set [options]
+```
+
+## Alias
+
 ```sh
 m365 aad user set [options]
 ```
@@ -87,48 +93,48 @@ If the user with the specified ID or username doesn't exist, or if the specified
 Update specific property _department_ of user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 
 ```sh
-m365 aad user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --department IT
+m365 entra user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --department IT
 ```
 
 Update multiple properties of user by name
 ```sh
-m365 aad user set --userName steve@contoso.onmicrosoft.com --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation "New York"
+m365 entra user set --userName steve@contoso.onmicrosoft.com --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation "New York"
 ```
 
 Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 
 ```sh
-m365 aad user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
+m365 entra user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
 ```
 
 Disable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 
 ```sh
-m365 aad user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
+m365 entra user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
 ```
 
 Reset password of a given user by userName and require the user to change the password on the next sign in
 
 ```sh
-m365 aad user set --userName steve@contoso.onmicrosoft.com --resetPassword --newPassword 6NLUId79Lc24 --forceChangePasswordNextSignIn
+m365 entra user set --userName steve@contoso.onmicrosoft.com --resetPassword --newPassword 6NLUId79Lc24 --forceChangePasswordNextSignIn
 ```
 
 Change password of the currently logged in user
 
 ```sh
-m365 aad user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
+m365 entra user set --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
 ```
 
 Updates a user with a manager
 
 ```sh
-m365 aad user set --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
+m365 entra user set --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
 ```
 
 Updates a user by removing its manager
 
 ```sh
-m365 aad user set --userName "john.doe@contoso.com" --removeManager
+m365 entra user set --userName "john.doe@contoso.com" --removeManager
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/user/user-signin-list.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad user signin list
+# entra user signin list
 
-Retrieves the Azure AD user sign-ins for the tenant
+Retrieves the Entra ID user sign-ins for the tenant
 
 ## Usage
 
+```sh
+m365 entra user signin list [options]
+```
+
+## Alias
+
 ```sh
 m365 aad user signin list [options]
 ```
@@ -35,55 +41,55 @@ m365 aad user signin list [options]
 Get all user's sign-ins in your tenant
 
 ```sh
-m365 aad user signin list
+m365 entra user signin list
 ```
 
 Get all user's sign-ins filter by given user's UPN in the tenant
 
 ```sh
-m365 aad user signin list --userName 'johndoe@example.com'
+m365 entra user signin list --userName 'johndoe@example.com'
 ```
 
 Get all user's sign-ins filter by given user's Id in the tenant
 
 ```sh
-m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111'
+m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111'
 ```
 
 Get all user's sign-ins filter by given application display name in the tenant
 
 ```sh
-m365 aad user signin list --appDisplayName 'Graph explorer'
+m365 entra user signin list --appDisplayName 'Graph explorer'
 ```
 
 Get all user's sign-ins filter by given application identifier in the tenant
 
 ```sh
-m365 aad user signin list --appId '00000000-0000-0000-0000-000000000000'
+m365 entra user signin list --appId '00000000-0000-0000-0000-000000000000'
 ```
 
 Get all user's sign-ins filter by given user's UPN and application display name in the tenant
 
 ```sh
-m365 aad user signin list --userName 'johndoe@example.com' --appDisplayName 'Graph explorer'
+m365 entra user signin list --userName 'johndoe@example.com' --appDisplayName 'Graph explorer'
 ```
 
 Get all user's sign-ins filter by given user's Id and application display name in the tenant
 
 ```sh
-m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appDisplayName 'Graph explorer'
+m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appDisplayName 'Graph explorer'
 ```
 
 Get all user's sign-ins filter by given user's UPN and application identifier in the tenant
 
 ```sh
-m365 aad user signin list --userName 'johndoe@example.com' --appId '00000000-0000-0000-0000-000000000000'
+m365 entra user signin list --userName 'johndoe@example.com' --appId '00000000-0000-0000-0000-000000000000'
 ```
 
 Get all user's sign-ins filter by given user's Id and application identifier in the tenant
 
 ```sh
-m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'
+m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'
 ```
 
 ## Response
@@ -178,13 +184,13 @@ m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appI
   <TabItem value="Markdown">
 
   ```md
-  # aad user signin list
+  # entra user signin list
 
   Date: 2023-06-02
 
   Property | Value
   ---------|-------
-  # aad user signin list
+  # entra user signin list
 
   Date: 2023-06-02
 

package/docs/docs/cmd/pa/app/app-get.mdx

@@ -20,6 +20,12 @@ m365 pa app get [options]
 
 `-d, --displayName [displayName]`
 : The display name of the Microsoft Power App to get information about.
+
+`--asAdmin`
+: Run the command as admin for apps you don't have permission to.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Required when using `asAdmin`.
 ```
 
 <Global />
@@ -32,6 +38,9 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
+As a maker, you are able to retrieve the Power Apps you have permission to. As an administrator, you are also able to retrieve Power Apps from other users you don't have permission to. To get the app from another user, use the `asAdmin` option and make sure to specify the `environment` option as well.
+
+
 If you try to retrieve a non-existing Microsoft Power App, you will get the `Request failed with status code 404` error.
 
 ## Examples
@@ -48,6 +57,12 @@ Get information about the specified Microsoft Power App by the app's display nam
 m365 pa app get --displayName App
 ```
 
+Get information about the specific app you do not have access to.
+
+```sh
+m365 pa app get --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/pa/app/app-remove.mdx

@@ -18,6 +18,12 @@ m365 pa app remove [options]
 
 `-f, --force`
 : Don't prompt for confirmation
+
+`--asAdmin`
+: Run the command as admin for apps you don't own.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Required when using `asAdmin`.
 ```
 
 <Global />
@@ -26,6 +32,8 @@ m365 pa app remove [options]
 
 By default, the command will try to remove a Power App. As maker, you are able to delete the Power Apps you own. As administrator, you are also able to delete Power Apps from other users.
 
+To remove an app you do not own, use the `asAdmin` option and make sure to specify the `environmentName` option as well.
+
 To remove a model-driven Power App you need administrator permissions.
 
 If the Power App with the name you specified doesn't exist, you will get the `Error: App 'abc' does not exist` error.
@@ -44,6 +52,12 @@ Removes the specified Power App without confirmation
 m365 pa app remove --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --force
 ```
 
+Removes the specified Power App you don't own
+
+```sh
+m365 pa app remove --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/planner/plan/plan-add.mdx

@@ -38,7 +38,7 @@ m365 planner plan add [options]
 
 ## Remarks
 
-- Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad m365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/m365group/m365group-user-add/) plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.
+- Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `entra m365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/entra/m365group/m365group-user-add/) plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.
 
 - Hint: Unlike for groups, a Planner Roster can contain only 1 plan.
 

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

@@ -101,7 +101,7 @@ Deleting and creating classic site collections is by default asynchronous and de
 
 The `--owners` option is mandatory for creating `CommunicationSite` sites with app-only permissions.
 
-When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`aad m365group add`](../../aad/m365group/m365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
+When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`entra m365group add`](../../entra/m365group/m365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
 
 ## Examples
 

package/docs/docs/cmd/teams/team/team-add.mdx

@@ -32,7 +32,7 @@ m365 teams team add [options]
 
 ## Remarks
 
-If you want to add a Team to an existing Microsoft 365 Group use the [aad m365group teamify](../../aad/m365group/m365group-teamify.mdx) command instead.
+If you want to add a Team to an existing Microsoft 365 Group use the [entra m365group teamify](../../entra/m365group/m365group-teamify.mdx) command instead.
 
 This command will return different responses based on the presence of the `--wait` option. If present, the command will return a `group` resource in the response. If not present, the command will return a `teamsAsyncOperation` resource in the response.
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.3.0",
+  "version": "7.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "7.3.0",
+      "version": "7.4.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-common": "^14.5.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.3.0",
+  "version": "7.4.0-beta.4c4cef8",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -301,4 +301,4 @@
     "sinon": "^17.0.0",
     "source-map-support": "^0.5.21"
   }
-}
+}

package/dist/m365/aad/commands/m365group/m365group-user-list.js

@@ -1,94 +0,0 @@
-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 _AadM365GroupUserListCommand_instances, _AadM365GroupUserListCommand_initTelemetry, _AadM365GroupUserListCommand_initOptions, _AadM365GroupUserListCommand_initValidators;
-import { odata } from '../../../../utils/odata.js';
-import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
-import commands from '../../commands.js';
-import { aadGroup } from '../../../../utils/aadGroup.js';
-class AadM365GroupUserListCommand extends GraphCommand {
-    get name() {
-        return commands.M365GROUP_USER_LIST;
-    }
-    get description() {
-        return "Lists users for the specified Microsoft 365 group";
-    }
-    constructor() {
-        super();
-        _AadM365GroupUserListCommand_instances.add(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initValidators).call(this);
-    }
-    async commandAction(logger, args) {
-        try {
-            const isUnifiedGroup = await aadGroup.isUnifiedGroup(args.options.groupId);
-            if (!isUnifiedGroup) {
-                throw Error(`Specified group with id '${args.options.groupId}' is not a Microsoft 365 group.`);
-            }
-            let users = await this.getOwners(args.options.groupId, logger);
-            if (args.options.role !== 'Owner') {
-                const membersAndGuests = await this.getMembersAndGuests(args.options.groupId, logger);
-                users = users.concat(membersAndGuests);
-            }
-            if (args.options.role) {
-                users = users.filter(i => i.userType === args.options.role);
-            }
-            await logger.log(users);
-        }
-        catch (err) {
-            this.handleRejectedODataJsonPromise(err);
-        }
-    }
-    async getOwners(groupId, logger) {
-        if (this.verbose) {
-            await logger.logToStderr(`Retrieving owners of the group with id ${groupId}`);
-        }
-        const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners?$select=id,displayName,userPrincipalName,userType`;
-        const users = await odata.getAllItems(endpoint);
-        // Currently there is a bug in the Microsoft Graph that returns Owners as
-        // userType 'member'. We therefore update all returned user as owner
-        users.forEach(user => {
-            user.userType = 'Owner';
-        });
-        return users;
-    }
-    async getMembersAndGuests(groupId, logger) {
-        if (this.verbose) {
-            await logger.logToStderr(`Retrieving members of the group with id ${groupId}`);
-        }
-        const endpoint = `${this.resource}/v1.0/groups/${groupId}/members?$select=id,displayName,userPrincipalName,userType`;
-        return await odata.getAllItems(endpoint);
-    }
-}
-_AadM365GroupUserListCommand_instances = new WeakSet(), _AadM365GroupUserListCommand_initTelemetry = function _AadM365GroupUserListCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            role: args.options.role
-        });
-    });
-}, _AadM365GroupUserListCommand_initOptions = function _AadM365GroupUserListCommand_initOptions() {
-    this.options.unshift({
-        option: "-i, --groupId <groupId>"
-    }, {
-        option: "-r, --role [type]",
-        autocomplete: ["Owner", "Member", "Guest"]
-    });
-}, _AadM365GroupUserListCommand_initValidators = function _AadM365GroupUserListCommand_initValidators() {
-    this.validators.push(async (args) => {
-        if (!validation.isValidGuid(args.options.groupId)) {
-            return `${args.options.groupId} is not a valid GUID`;
-        }
-        if (args.options.role) {
-            if (['Owner', 'Member', 'Guest'].indexOf(args.options.role) === -1) {
-                return `${args.options.role} is not a valid role value. Allowed values Owner|Member|Guest`;
-            }
-        }
-        return true;
-    });
-};
-export default new AadM365GroupUserListCommand();
-//# sourceMappingURL=m365group-user-list.js.map

package/docs/docs/cmd/aad/app/app-permission-add.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# aad app permission add
-
-Adds the specified application and/or delegated permissions to a specified Entra ID (Azure AD) app
-
-## Usage
-
-```sh
-m365 aad app permission add [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --appId [appId]`
-: Client ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
-
-`--appObjectId [appObjectId]`
-: Object ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
-
-`-a, --applicationPermissions [applicationPermissions]`
-: Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
-
-`-d, --delegatedPermissions [delegatedPermissions]`
-: Space-separated list of delegated permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
-
-`--grantAdminConsent`
-: When specified, grants application & delegated permissions through admin consent.
-```
-
-<Global />
-
-## Remarks
-
-Scopes/Roles to grant must be fully-qualified so that we can disambiguate them between the different resources.
-
-## Examples
-
-Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by client id
-
-```sh
-m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
-```
-
-Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by object id
-
-```sh
-m365 aad app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
-```
-
-Grant multiple app-only permissions to an Entra ID (Azure AD) app specified by client id and grant admin consent
-
-```sh
-m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grandAdminConsent
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-remove.mdx

@@ -1,59 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app remove
-
-Removes an Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app remove [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`--objectId [objectId]`
-: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`--name [name]`
-: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`-f, --force`
-: Don't prompt for confirmation to remove the app.
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `objectId` option to reference the Azure AD application registration to remove. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-## Examples
-
-Remove the Azure AD application registration by its app (client) ID.
-
-```sh
-m365 aad app remove --appId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Remove the Azure AD application registration by its object ID.
-
-```sh
-m365 aad app remove --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Remove the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
-
-```sh
-m365 aad app remove --name "My app" --force
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-role-add.mdx

@@ -1,68 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app role add
-
-Adds role to the specified Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app role add [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`--appObjectId [appObjectId]`
-: Object ID of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`--appName [appName]`
-: Name of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`-n, --name <name>`
-: Name of the role to add
-
-`-d, --description <description>`
-: Description of the role to add
-
-`-m, --allowedMembers <allowedMembers>`
-: Types of members that can be added to the group. Allowed values: `usersGroups`, `applications`, `both`
-
-`-c, --claim <claim>`
-: Claim value
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `appObjectId` option to reference the Azure AD application registration for which to add the role. If you use `appId` or `appName`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-## Examples
-
-Add role to the Azure AD application registration specified by its object ID
-
-```sh
-m365 aad app role add --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-Add role to the Azure AD application registration specified by its app (client) ID
-
-```sh
-m365 aad app role add --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-Add role to the Azure AD application registration specified by its name
-
-```sh
-m365 aad app role add --appName "My app" --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-## Response
-
-The command won't return a response on success.