@pnp/cli-microsoft365 7.5.0-beta.23612bc → 7.5.0-beta.940b241

package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-remove.mdx

@@ -0,0 +1,107 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra administrativeunit member remove
+
+Removes a member (user, group, or device) from an administrative unit
+
+## Usage
+
+```sh
+m365 entra administrativeunit member remove [options]
+```
+
+## options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the member to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--userId [userId]`
+: The id of the user to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--userName [userName]`
+: The user principal name (UPN) of the user to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--groupId [groupId]`
+: The id of the group to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--groupName [groupName]`
+: The name of the group to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--deviceId [deviceId]`
+: The id of the device to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--deviceName [deviceName]`
+: The name of the device to be removed. Specify either `id`, `userId`, `userName`, `groupId`, `groupName`, `deviceId` or `deviceName`.
+
+`--administrativeUnitId [administrativeUnitId]`
+: The id of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName` but not both.
+
+`--administrativeUnitName [administrativeUnitName]`
+: The name of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName` but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Global Administrator** or **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Remove a member specified by id from an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit member remove --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove a user specified by id from an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit member remove --userId 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove a group specified by id from an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit member remove --groupId b2307a39-e878-458b-bc90-03bc578531d6 --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove a device specified by id from an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit member remove --deviceId 810c84a8-4a9e-49e6-bf7d-12d183f40d01 --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove a user specified by UPN from an administrative unit specified by name
+
+```sh
+m365 entra administrativeunit member remove --userName john.doe@contoso.com --administrativeUnitName 'Marketing Division'
+```
+
+Remove a group specified by name from an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit member remove --groupName 'Marketing Group' --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove a device specified by name from an administrative unit specified by name
+
+```sh
+m365 entra administrativeunit member remove --deviceName 'JohnDoe-PC' --administrativeUnitName 'Marketing Division'
+```
+
+## Response
+
+The command won't return a response on success
+
+## More information
+
+- [Administrative units](https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units)

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

@@ -16,6 +16,7 @@ m365 entra app add [options]
 
 ```sh
 m365 aad app add [options]
+m365 entra appregistration add [options]
 ```
 
 ## Options
@@ -109,7 +110,7 @@ After creating the Entra app registration, this command returns the app ID and o
 
 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.
+When specifying `--grantAdminConsent` option, an enterprise application will be created for the app registration.
 
 ## Examples
 

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

@@ -16,6 +16,7 @@ m365 entra app get [options]
 
 ```sh
 m365 aad app get [options]
+m365 entra appregistration get [options]
 ```
 
 ## Options

package/docs/docs/cmd/entra/app/app-list.mdx

@@ -16,6 +16,7 @@ m365 entra app list [options]
 
 ```sh
 m365 aad app list [options]
+m365 entra appregistration list [options]
 ```
 
 ## Options

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

@@ -16,6 +16,7 @@ m365 entra app permission add [options]
 
 ```sh
 m365 aad app permission add [options]
+m365 entra appregistration permission add [options]
 ```
 
 ## Options

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

@@ -0,0 +1,105 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra app permission list
+
+Lists the application and delegated permissions for a specified Entra Application Registration
+
+## Usage
+
+```sh
+m365 entra app permission list [options]
+```
+
+## Alias
+
+```sh
+m365 aad app permission list [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --appId [appId]`
+: Client ID of the Application Registration to retrieve the permissions for. Specify `appId` or `appObjectId` but not both.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Application Registration to retrieve the permissions for. Specify `appId` or `appObjectId` but not both.
+
+`--type [type]`
+: The type of permissions to retrieve. Allowed values: `delegated`, `application`, `all`. Defaults to `all`.
+```
+
+<Global />
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Entra application registration to get. If you use `appId`, this command will first need to find the corresponding object ID for that application.
+
+## Examples
+
+Retrieves all permissions for an Entra app registration
+
+```sh
+m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690'
+```
+
+Retrieves all delegated permissions for an Entra app registration
+
+```sh
+m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --type delegated
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "resource": "Microsoft Graph",
+      "resourceId": "00000003-0000-0000-c000-000000000000",
+      "permission": "User.Read",
+      "type": "Delegated"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  resource                      resourceId                            permission                         type
+  ----------------------------  ------------------------------------  ---------------------------------  -----------
+  Microsoft Graph               00000003-0000-0000-c000-000000000000  User.Read                          Delegated
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  resource,resourceId,permission,type
+  Microsoft Graph,00000003-0000-0000-c000-000000000000,User.Read,Delegated
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra app permission list --appId "2bf26ae1-9be3-425f-a393-5fe8390e3a36"
+
+  Date: 27/12/2023
+
+  Property | Value
+  ---------|-------
+  resource | Microsoft Graph
+  resourceId | 00000003-0000-0000-c000-000000000000
+  permission | User.Read
+  type | Delegated
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -14,6 +14,7 @@ m365 entra app remove [options]
 
 ```sh
 m365 aad app remove [options]
+m365 entra appregistration remove [options]
 ```
 
 ## Options

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

@@ -14,6 +14,7 @@ m365 entra app role add [options]
 
 ```sh
 m365 aad app role add [options]
+m365 entra appregistration role add [options]
 ```
 
 ## Options

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

@@ -16,6 +16,7 @@ m365 entra app role list [options]
 
 ```sh
 m365 aad app role list [options]
+m365 entra appregistration role list [options]
 ```
 
 ## Options

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

@@ -14,6 +14,7 @@ m365 entra app role remove [options]
 
 ```sh
 m365 aad app role remove [options]
+m365 entra appregistration role remove [options]
 ```
 
 ## Options

package/docs/docs/cmd/entra/app/app-set.mdx

@@ -14,6 +14,7 @@ m365 entra app set [options]
 
 ```sh
 m365 aad app set [options]
+m365 entra appregistration set [options]
 ```
 
 ## Options

package/docs/docs/cmd/entra/{sp/sp-add.mdx → enterpriseapp/enterpriseapp-add.mdx}

@@ -2,33 +2,34 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# entra sp add
+# entra enterpriseapp add
 
-Adds a service principal to a registered Entra app
+Creates an enterprise application (or service principal) for a registered Entra app
 
 ## Usage
 
 ```sh
-m365 entra sp add [options]
+m365 entra enterpriseapp add [options]
 ```
 
 ## Alias
 
 ```sh
 m365 aad sp add [options]
+m365 entra sp add [options]
 ```
 
 ## Options
 
 ```md definition-list
 `--appId [appId]`
-: ID of the application to which the service principal should be added
+: ID of the app for which the enterprise application should be created
 
 `--appName [appName]`
-: Display name of the application to which the service principal should be added
+: Display name of the app for which the enterprise application should be created
 
 `--objectId [objectId]`
-: ObjectId of the application to which the service principal should be added
+: ObjectId of the app for which the enterprise application should be created
 ```
 
 <Global />
@@ -37,26 +38,26 @@ m365 aad sp add [options]
 
 Specify either the `appId`, `appName` or `objectId`. If you specify more than one option value, the command will fail with an error.
 
-If you register an application in the portal, an application object as well as a service principal object are automatically created in your home tenant. If you register an application using CLI for Microsoft 365 or the Microsoft Graph, you'll need to create the service principal separately. To register/create an application using the CLI for Microsoft 365, use the [m365 entra app add](../app/app-add.mdx) command.
+If you register an application in the portal, an application object as well as an enterprise application object are automatically created in your home tenant. If you register an application using CLI for Microsoft 365 or the Microsoft Graph, you'll need to create the enterprise application separately. To register/create an application using the CLI for Microsoft 365, use the [m365 entra app add](../app/app-add.mdx) command.
 
 ## Examples
 
-Adds a service principal to a registered Entra app with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
+Creates an enterprise application for a registered Entra app with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
 
 ```sh
-m365 entra sp add --appId b2307a39-e878-458b-bc90-03bc578531d6
+m365 entra enterpriseapp add --appId b2307a39-e878-458b-bc90-03bc578531d6
 ```
 
-Adds a service principal to a registered Entra app with appName _Microsoft Graph_.
+Creates an enterprise application for a registered Entra app with appName _Microsoft Graph_.
 
 ```sh
-m365 entra sp add --appName "Microsoft Graph"
+m365 entra enterpriseapp add --appName "Microsoft Graph"
 ```
 
-Adds a service principal to a registered Entra app with objectId _b2307a39-e878-458b-bc90-03bc578531d6_.
+Creates an enterprise application for a registered Entra app with objectId _b2307a39-e878-458b-bc90-03bc578531d6_.
 
 ```sh
-m365 entra sp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
+m365 entra enterpriseapp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
 ```
 
 ## Response
@@ -171,7 +172,7 @@ m365 entra sp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
   <TabItem value="Markdown">
 
   ```md
-  # entra sp add --appId "8da75b6a-4272-4b17-8ee1-20ba66e2b06f"
+  # entra enterpriseapp add --appId "8da75b6a-4272-4b17-8ee1-20ba66e2b06f"
 
   Date: 2023-06-02
 
@@ -195,5 +196,5 @@ m365 entra sp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
 
 ## More information
 
-- Application and service principal objects in Entra ID (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Application and enterprise application objects in Entra ID (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
 - Create servicePrincipal: [https://learn.microsoft.com/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0)

package/docs/docs/cmd/entra/{sp/sp-get.mdx → enterpriseapp/enterpriseapp-get.mdx}

@@ -2,33 +2,34 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# entra sp get
+# entra enterpriseapp get
 
-Gets information about the specific service principal
+Gets information about an enterprise application (or service principal)
 
 ## Usage
 
 ```sh
-m365 entra sp get [options]
+m365 entra enterpriseapp get [options]
 ```
 
 ## Alias
 
 ```sh
 m365 aad sp get [options]
+m365 entra sp get [options]
 ```
 
 ## Options
 
 ```md definition-list
 `-i, --appId [appId]`
-: ID of the application for which the service principal should be retrieved
+: ID of the application for which the enterprise application should be retrieved
 
 `-n, --appDisplayName [appDisplayName]`
-: Display name of the application for which the service principal should be retrieved
+: Display name of the application for which the enterprise application should be retrieved
 
 `--appObjectId [appObjectId]`
-: ObjectId of the application for which the service principal should be retrieved
+: ObjectId of the application for which the enterprise application should be retrieved
 ```
 
 <Global />
@@ -39,22 +40,22 @@ Specify either the `appId`, `appObjectId` or `appDisplayName`. If you specify mo
 
 ## Examples
 
-Return details about the service principal with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
+Return details about the enterprise application with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
 
 ```sh
-m365 entra sp get --appId b2307a39-e878-458b-bc90-03bc578531d6
+m365 entra enterpriseapp get --appId b2307a39-e878-458b-bc90-03bc578531d6
 ```
 
-Return details about the _Microsoft Graph_ service principal.
+Return details about the _Microsoft Graph_ enterprise application.
 
 ```sh
-m365 entra sp get --appDisplayName "Microsoft Graph"
+m365 entra enterpriseapp get --appDisplayName "Microsoft Graph"
 ```
 
-Return details about the service principal with ObjectId _b2307a39-e878-458b-bc90-03bc578531dd_.
+Return details about the enterprise application with ObjectId _b2307a39-e878-458b-bc90-03bc578531dd_.
 
 ```sh
-m365 entra sp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
+m365 entra enterpriseapp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
 ```
 
 ## Response
@@ -197,7 +198,7 @@ m365 entra sp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
   <TabItem value="Markdown">
 
   ```md
-  # entra sp get --appId "ac7c9b4b-83b0-4a5e-ace2-a3530162c8f8"
+  # entra enterpriseapp get --appId "ac7c9b4b-83b0-4a5e-ace2-a3530162c8f8"
 
   Date: 2023-06-02
 
@@ -223,5 +224,5 @@ m365 entra sp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
 
 ## More information
 
-- Application and service principal objects in Entra ID (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Application and enterprise application objects in Entra ID (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
 - Get servicePrincipal: [https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0)

package/docs/docs/cmd/entra/{sp/sp-list.mdx → enterpriseapp/enterpriseapp-list.mdx}

@@ -2,46 +2,47 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# entra sp list
+# entra enterpriseapp list
 
-Lists the service principals in the directory
+Lists the enterprise applications (or service principals) in Entra ID
 
 ## Usage
 
 ```sh
-m365 entra sp list [options]
+m365 entra enterpriseapp list [options]
 ```
 
 ## Alias
 
 ```sh
 m365 aad sp list [options]
+m365 entra sp list [options]
 ```
 
 ## Options
 
 ```md definition-list
 `--displayName [displayName]`
-: Returns only service principals with the specified name
+: Returns only enterprise applications with the specified name
 
 `--tag [tag]`
-: Returns only service principals with the specified tag
+: Returns only enterprise applications with the specified tag
 ```
 
 <Global />
 
 ## Examples
 
-Return a list of all service principals
+Return a list of all enterprise applications
 
 ```sh
-m365 entra sp list
+m365 entra enterpriseapp list
 ```
 
-Return a list of all service principals that comply with the display name and the tag parameters
+Return a list of all enterprise applications that comply with the display name and the tag parameters
 
 ```sh
-m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzureActiveDirectoryIntegratedApp"
+m365 entra enterpriseapp list --displayName "My custom enterprise application" --tag "WindowsAzureActiveDirectoryIntegratedApp"
 ```
 
 ## Response
@@ -56,7 +57,7 @@ m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzu
       "deletedDateTime": null,
       "accountEnabled": true,
       "alternativeNames": [],
-      "appDisplayName": "My custom service principal",
+      "appDisplayName": "My custom enterprise application",
       "appDescription": null,
       "appId": "a62ef842-f9ef-49cf-9119-31b85ea58445",
       "applicationTemplateId": null,
@@ -65,7 +66,7 @@ m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzu
       "createdDateTime": "2022-11-28T20:32:11Z",
       "description": null,
       "disabledByMicrosoftStatus": null,
-      "displayName": "My custom service principal",
+      "displayName": "My custom enterprise application",
       "homepage": null,
       "loginUrl": null,
       "logoutUrl": null,
@@ -102,13 +103,13 @@ m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzu
       "keyCredentials": [],
       "oauth2PermissionScopes": [
         {
-          "adminConsentDescription": "Allow the application to access My custom service principal on behalf of the signed-in user.",
-          "adminConsentDisplayName": "Access My custom service principal",
+          "adminConsentDescription": "Allow the application to access My custom enterprise application on behalf of the signed-in user.",
+          "adminConsentDisplayName": "Access My custom enterprise application",
           "id": "907a8cea-411a-461a-bb30-261e52febcca",
           "isEnabled": true,
           "type": "User",
-          "userConsentDescription": "Allow the application to access My custom service principal on your behalf.",
-          "userConsentDisplayName": "Access My custom service principal",
+          "userConsentDescription": "Allow the application to access My custom enterprise application on your behalf.",
+          "userConsentDisplayName": "Access My custom enterprise application",
           "value": "user_impersonation"
         }
       ],
@@ -129,7 +130,7 @@ m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzu
   ```text
   id                                      displayName                   tag
   --------------------------------------  ----------------------------  ---------------------------------------
-  a62ef842-f9ef-49cf-9119-31b85ea58445    My custom service principal   WindowsAzureActiveDirectoryIntegratedApp
+  a62ef842-f9ef-49cf-9119-31b85ea58445    My custom enterprise application   WindowsAzureActiveDirectoryIntegratedApp
   ```
 
   </TabItem>
@@ -137,29 +138,29 @@ m365 entra sp list --displayName "My custom service principal" --tag "WindowsAzu
 
   ```csv
   id,accountEnabled,appDisplayName,appId,appOwnerOrganizationId,appRoleAssignmentRequired,createdDateTime,displayName,servicePrincipalType,signInAudience
-  226859cc-86f0-40d3-b308-f43b3a729b6e,1,My custom service principal,a62ef842-f9ef-49cf-9119-31b85ea58445,fd71909b-55e5-44d2-9f78-dc432421d527,,2022-11-28T20:32:11Z,My custom service principal,AzureADMultipleOrgs
+  226859cc-86f0-40d3-b308-f43b3a729b6e,1,My custom enterprise application,a62ef842-f9ef-49cf-9119-31b85ea58445,fd71909b-55e5-44d2-9f78-dc432421d527,,2022-11-28T20:32:11Z,My custom enterprise application,AzureADMultipleOrgs
   ```
     
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # entra sp list
+  # entra enterpriseapp list
 
   Date: 27/4/2023
 
-  ## My custom service principal (226859cc-86f0-40d3-b308-f43b3a729b6e)
+  ## My custom enterprise application (226859cc-86f0-40d3-b308-f43b3a729b6e)
 
   Property | Value
   ---------|-------
   id | 226859cc-86f0-40d3-b308-f43b3a729b6e
   accountEnabled | true
-  appDisplayName | My custom service principal
+  appDisplayName | My custom enterprise application
   appId | a62ef842-f9ef-49cf-9119-31b85ea58445
   appOwnerOrganizationId | fd71909b-55e5-44d2-9f78-dc432421d527
   appRoleAssignmentRequired | false
   createdDateTime | 2022-11-28T20:32:11Z
-  displayName | My custom service principal
+  displayName | My custom enterprise application
   servicePrincipalType | Application
   signInAudience | AzureADMultipleOrg
   ```