@pnp/cli-microsoft365 7.3.0 → 7.4.0-beta.4388d3c

package/docs/docs/cmd/{aad → entra}/app/app-add.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad app add
+# entra app add
 
-Creates new Azure AD app registration
+Creates new Entra app registration
 
 ## Usage
 
+```sh
+m365 entra app add [options]
+```
+
+## Alias
+
 ```sh
 m365 aad app add [options]
 ```
@@ -67,7 +73,7 @@ m365 aad app add [options]
 : When specified, grants application & delegated permissions through admin consent.
 
 `--manifest [manifest]`
-: Azure AD app manifest as retrieved from the Azure Portal to create the app registration from. Specify either `name` or `manifest` but not both.
+: App manifest as retrieved from Entra ID to create the app registration from. Specify either `name` or `manifest` but not both.
 
 `--save`
 : Use to store the information about the created app in a local file.
@@ -77,15 +83,15 @@ m365 aad app add [options]
 
 ## Remarks
 
-You can use this command to create a new Azure AD app registration either by specifying the different configuration settings through the corresponding options or by using the manifest.
+You can use this command to create a new Entra app registration either by specifying the different configuration settings through the corresponding options or by using the manifest.
 
-If you don't use the manifest, you must specify the name of the Azure AD app registration using the `name` option. If you use the manifest, you can skip the `name` option assuming the manifest contains the `displayName` property.
+If you don't use the manifest, you must specify the name of the Entra app registration using the `name` option. If you use the manifest, you can skip the `name` option assuming the manifest contains the `displayName` property.
 
-You can also use the manifest to provision some of the configuration settings of your Azure AD app. All properties specified in the manifest are optional and will set if specified.
+You can also use the manifest to provision some of the configuration settings of your Entra app. All properties specified in the manifest are optional and will set if specified.
 
 If you specify the manifest along with some options, values specified in the options will override settings from the manifest. One exception is the name specified in the `name` option which will be overridden by the `displayName` property from the manifest if specified.
 
-The following properties specified in the manifest retrieved from Azure AD are not supported by this command:
+The following properties specified in the manifest retrieved from Entra ID are not supported by this command:
 
 - accessTokenAcceptedVersion
 - disabledByMicrosoftStatus
@@ -95,94 +101,94 @@ The following properties specified in the manifest retrieved from Azure AD are n
 - orgRestrictions
 - samlMetadataUrl
 
-When specifying the value for the `uri`, you can use the `_appId_` token, to include the ID of the newly generated Azure AD app registration in the Application ID URI, eg. URI `api://caf406b91cd4.ngrok.io/_appId_` will become `api://caf406b91cd4.ngrok.io/ab3bd119-faf7-4db5-ba99-eb7e748f778a` where the last portion is the app ID of the created Azure AD app registration.
+When specifying the value for the `uri`, you can use the `_appId_` token, to include the ID of the newly generated Entra app registration in the Application ID URI, eg. URI `api://caf406b91cd4.ngrok.io/_appId_` will become `api://caf406b91cd4.ngrok.io/ab3bd119-faf7-4db5-ba99-eb7e748f778a` where the last portion is the app ID of the created Entra app registration.
 
 When using the `withSecret` option, this command will automatically generate a secret named `Default` and set it to expire 1 year in the future.
 
-After creating the Azure AD app registration, this command returns the app ID and object ID of the created app registration. If you used the `withSecret` option, it will also return the generated secret.
+After creating the Entra app registration, this command returns the app ID and object ID of the created app registration. If you used the `withSecret` option, it will also return the generated secret.
 
-If you want to store the information about the created Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you create the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the to it, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
+If you want to store the information about the created Entra app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you create the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the to it, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
 
 When specifying `--grantAdminConsent` option, a service principal will be created for the app registration.
 
 ## Examples
 
-Create new Azure AD app registration with the specified name
+Create new Entra app registration with the specified name
 
 ```sh
-m365 aad app add --name 'My AAD app'
+m365 entra app add --name 'My Entra app'
 ```
 
-Create new Azure AD app registration from the manifest retrieved from the Azure Portal stored in a local file named _manifest.json_
+Create new Entra app registration from the manifest retrieved from the Azure Portal stored in a local file named _manifest.json_
 
 ```sh
-m365 aad app add --manifest @manifest.json
+m365 entra app add --manifest @manifest.json
 ```
 
-Create new multitenant Azure AD app registration
+Create new multitenant Entra app registration
 
 ```sh
-m365 aad app add --name 'My AAD app' --multitenant
+m365 entra app add --name 'My Entra app' --multitenant
 ```
 
-Create new Azure AD app registration for a web app with the specified redirect URIs
+Create new Entra app registration for a web app with the specified redirect URIs
 
 ```sh
-m365 aad app add --name 'My AAD app' --redirectUris 'https://myapp.azurewebsites.net,http://localhost:4000' --platform web
+m365 entra app add --name 'My Entra app' --redirectUris 'https://myapp.azurewebsites.net,http://localhost:4000' --platform web
 ```
 
-Create new Azure AD app registration for a desktop app
+Create new Entra app registration for a desktop app
 
 ```sh
-m365 aad app add --name 'My AAD app' --redirectUris 'https://login.microsoftonline.com/common/oauth2/nativeclient' --platform publicClient
+m365 entra app add --name 'My Entra app' --redirectUris 'https://login.microsoftonline.com/common/oauth2/nativeclient' --platform publicClient
 ```
 
-Create new Azure AD app registration with an auto-generated secret (secret returned in the command output)
+Create new Entra app registration with an auto-generated secret (secret returned in the command output)
 
 ```sh
-m365 aad app add --name 'My AAD app' --withSecret
+m365 entra app add --name 'My Entra app' --withSecret
 ```
 
-Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions
+Create new Entra app registration for a daemon app with specified Microsoft Graph application permissions
 
 ```sh
-m365 aad app add --name 'My AAD app' --withSecret --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All,https://graph.microsoft.com/Directory.Read.All'
+m365 entra app add --name 'My Entra app' --withSecret --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All,https://graph.microsoft.com/Directory.Read.All'
 ```
 
-Create new Azure AD app registration for a single-page app with specified Microsoft Graph delegated permissions
+Create new Entra app registration for a single-page app with specified Microsoft Graph delegated permissions
 
 ```sh
-m365 aad app add --name 'My AAD app' --platform spa --redirectUris 'https://myspa.azurewebsites.net,http://localhost:8080' --apisDelegated 'https://graph.microsoft.com/Calendars.Read,https://graph.microsoft.com/Directory.Read.All' --implicitFlow
+m365 entra app add --name 'My Entra app' --platform spa --redirectUris 'https://myspa.azurewebsites.net,http://localhost:8080' --apisDelegated 'https://graph.microsoft.com/Calendars.Read,https://graph.microsoft.com/Directory.Read.All' --implicitFlow
 ```
 
-Create new Azure AD app registration with Application ID URI set to a fixed value
+Create new Entra app registration with Application ID URI set to a fixed value
 
 ```sh
-m365 aad app add --name 'My AAD app' --uri https://contoso.onmicrosoft.com/myapp
+m365 entra app add --name 'My Entra app' --uri https://contoso.onmicrosoft.com/myapp
 ```
 
-Create new Azure AD app registration with Application ID URI set to a value that contains the ID of the app registration, designated with the `_appId_` token and a custom API scope that can be consented by both admins and users
+Create new Entra app registration with Application ID URI set to a value that contains the ID of the app registration, designated with the `_appId_` token and a custom API scope that can be consented by both admins and users
 
 ```sh
-m365 aad app add --name 'My AAD app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
+m365 entra app add --name 'My Entra app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
 ```
 
-Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions, including admin consent
+Create new Entra app registration for a daemon app with specified Microsoft Graph application permissions, including admin consent
 
 ```sh
- m365 aad app add --name 'My AAD app' --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All' --grantAdminConsent
+ m365 entra app add --name 'My Entra app' --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All' --grantAdminConsent
 ```
 
-Create new Azure AD app registration with the specified name. Store information about the created app registration in the _.m365rc.json_ file in the current directory.
+Create new Entra app registration with the specified name. Store information about the created app registration in the _.m365rc.json_ file in the current directory.
 
 ```sh
-m365 aad app add --name 'My AAD app' --save
+m365 entra app add --name 'My Entra app' --save
 ```
 
-Create new Azure AD app registration with a certificate
+Create new Entra app registration with a certificate
 
 ```sh
-m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
+m365 entra app add --name 'My Entra app' --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
 ```
 
 ## Response
@@ -221,7 +227,7 @@ m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate
   <TabItem value="Markdown">
 
   ```md
-  # aad app add --name "My AAD app"
+  # entra app add --name "My Entra app"
 
   Date: 2023-06-01
 
@@ -280,7 +286,7 @@ When we make use of the option `withSecret` the response will differ.
   <TabItem value="Markdown">
 
   ```md
-  # aad app add --name "My AAD app" --withSecret "true"
+  # entra app add --name "My Entra app" --withSecret "true"
 
   Date: 2023-06-01
 

package/docs/docs/cmd/{aad → entra}/app/app-get.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad app get
+# entra app get
 
-Gets an Azure AD app registration
+Gets an Entra app registration
 
 ## Usage
 
+```sh
+m365 entra app get [options]
+```
+
+## Alias
+
 ```sh
 m365 aad app get [options]
 ```
@@ -16,13 +22,13 @@ m365 aad app get [options]
 
 ```md definition-list
 `--appId [appId]`
-: Application (client) ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+: Application (client) ID of the Entra application registration to get. Specify either `appId`, `objectId` or `name`
 
 `--objectId [objectId]`
-: Object ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+: Object ID of the Entra application registration to get. Specify either `appId`, `objectId` or `name`
 
 `--name [name]`
-: Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+: Name of the Entra application registration to get. Specify either `appId`, `objectId` or `name`
 
 `--save`
 : Use to store the information about the created app in a local file
@@ -32,36 +38,36 @@ m365 aad app get [options]
 
 ## Remarks
 
-For best performance use the `objectId` option to reference the Azure AD application registration to get. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
+For best performance use the `objectId` option to reference the Entra application registration to get. 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.
+If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
-If you want to store the information about the Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you get the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the App registration to it if it's not already present, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
+If you want to store the information about the Entra app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you get the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the App registration to it if it's not already present, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
 
 ## Examples
 
-Get the Azure AD application registration by its app (client) ID
+Get the Entra application registration by its app (client) ID
 
 ```sh
-m365 aad app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+m365 entra app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get the Azure AD application registration by its object ID
+Get the Entra application registration by its object ID
 
 ```sh
-m365 aad app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+m365 entra app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get the Azure AD application registration by its name
+Get the Entra application registration by its name
 
 ```sh
-m365 aad app get --name "My app"
+m365 entra app get --name "My app"
 ```
 
-Get the Azure AD application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.
+Get the Entra application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.
 
 ```sh
-m365 aad app get --name "My app" --save
+m365 entra app get --name "My app" --save
 ```
 
 ## Response
@@ -260,7 +266,7 @@ m365 aad app get --name "My app" --save
   <TabItem value="Markdown">
 
   ```md
-  # aad app get --appId "9eb465b4-eed9-4fb2-aa7a-4dfe18a52a4d"
+  # entra app get --appId "9eb465b4-eed9-4fb2-aa7a-4dfe18a52a4d"
 
   Date: 2023-06-01
 

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

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad app list
+# entra app list
 
-Retrieves a list of Azure AD app registrations
+Retrieves a list of Entra app registrations
 
 ## Usage
 
+```sh
+m365 entra app list [options]
+```
+
+## Alias
+
 ```sh
 m365 aad app list [options]
 ```
@@ -18,10 +24,10 @@ m365 aad app list [options]
 
 ## Examples
 
-Retrieve a list of Azure AD app registrations
+Retrieve a list of Entra app registrations
 
 ```sh
-m365 aad app list
+m365 entra app list
 ```
 
 ## Response
@@ -162,7 +168,7 @@ m365 aad app list
   <TabItem value="Markdown">
 
   ```md
-  # aad app list
+  # entra app list
 
   Date: 2023-06-01
 

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

@@ -0,0 +1,68 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra app permission add
+
+Adds the specified application and/or delegated permissions to a specified Entra (Azure AD) app
+
+## Usage
+
+```sh
+m365 entra app permission add [options]
+```
+
+## Alias
+
+```sh
+m365 aad app permission add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --appId [appId]`
+: Client ID of the Entra (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra (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 (Azure AD) app specified by client id
+
+```sh
+m365 entra 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 (Azure AD) app specified by object id
+
+```sh
+m365 entra 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 (Azure AD) app specified by client id and grant admin consent
+
+```sh
+m365 entra 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/entra/app/app-remove.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra app remove
+
+Removes an Entra app registration
+
+## Usage
+
+```sh
+m365 entra app remove [options]
+```
+
+## Alias
+
+```sh
+m365 aad app remove [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Application (client) ID of the Entra application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
+
+`--objectId [objectId]`
+: Object ID of the Entra application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
+
+`--name [name]`
+: Name of the Entra 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 Entra 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 Entra 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 Entra application registration by its app (client) ID.
+
+```sh
+m365 entra app remove --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Remove the Entra application registration by its object ID.
+
+```sh
+m365 entra app remove --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Remove the Entra application registration by its name. Will NOT prompt for confirmation before deleting.
+
+```sh
+m365 entra app remove --name "My app" --force
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,74 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra app role add
+
+Adds role to the specified Entra app registration
+
+## Usage
+
+```sh
+m365 entra app role add [options]
+```
+
+## Alias
+
+```sh
+m365 aad app role add [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Application (client) ID of the Entra application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
+
+`--appName [appName]`
+: Name of the Entra 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 Entra 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 Entra 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 Entra application registration specified by its object ID
+
+```sh
+m365 entra app role add --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
+```
+
+Add role to the Entra application registration specified by its app (client) ID
+
+```sh
+m365 entra app role add --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
+```
+
+Add role to the Entra application registration specified by its name
+
+```sh
+m365 entra app role add --appName "My app" --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/{aad → entra}/app/app-role-list.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad app role list
+# entra app role list
 
-Gets Azure AD app registration roles
+Gets Entra app registration roles
 
 ## Usage
 
+```sh
+m365 entra app role list [options]
+```
+
+## Alias
+
 ```sh
 m365 aad app role list [options]
 ```
@@ -16,41 +22,41 @@ m365 aad app role list [options]
 
 ```md definition-list
 `--appId [appId]`
-: Application (client) ID of the Azure AD application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
+: Application (client) ID of the Entra application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
 
 `--appObjectId [appObjectId]`
-: Object ID of the Azure AD application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
+: Object ID of the Entra application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
 
 `--appName [appName]`
-: Name of the Azure AD application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
+: Name of the Entra application registration for which to retrieve roles. Specify either `appId`, `appObjectId` or `appName`
 ```
 
 <Global />
 
 ## Remarks
 
-For best performance use the `appObjectId` option to reference the Azure AD application registration for which to retrieve roles. If you use `appId` or `appName`, this command will first need to find the corresponding object ID for that application.
+For best performance use the `appObjectId` option to reference the Entra application registration for which to retrieve roles. 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.
+If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
 ## Examples
 
-Get roles for the Azure AD application registration specified by its object ID
+Get roles for the Entra application registration specified by its object ID
 
 ```sh
-m365 aad app role list --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8
+m365 entra app role list --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get roles for the Azure AD application registration specified by its app (client) ID
+Get roles for the Entra application registration specified by its app (client) ID
 
 ```sh
-m365 aad app role list --appId e75be2e1-0204-4f95-857d-51a37cf40be8
+m365 entra app role list --appId e75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get roles for the Azure AD application registration specified by its name
+Get roles for the Entra application registration specified by its name
 
 ```sh
-m365 aad app role list --appName "My app"
+m365 entra app role list --appName "My app"
 ```
 
 ## Response
@@ -95,7 +101,7 @@ m365 aad app role list --appName "My app"
   <TabItem value="Markdown">
 
   ```md
-  # aad app role list --appObjectId "29d99e17-96b7-46aa-816d-b52bfeeafeb9"
+  # entra app role list --appObjectId "29d99e17-96b7-46aa-816d-b52bfeeafeb9"
 
   Date: 2023-06-01