@pnp/cli-microsoft365 7.5.0-beta.494c631 → 7.5.0-beta.5db13e8

package/docs/docs/cmd/cli/cli-consent.mdx

@@ -16,25 +16,25 @@ m365 cli consent [options]
 
 ```md definition-list
 `-s, --service <service>`
-: Service for which to consent permissions. Allowed values: `yammer`
+: Service for which to consent permissions. Allowed values: `VivaEngage`, (deprecated)`yammer`.
 ```
 
 <Global />
 
 ## Remarks
 
-Using the `cli consent` command you can consent additional permissions for the Azure AD application used by the CLI for Microsoft 365. This is for example necessary to use Yammer commands, which require the Yammer API permission that isn't granted to the CLI by default.
+Using the `cli consent` command you can consent additional permissions for the Azure AD application used by the CLI for Microsoft 365. This is for example necessary to use Viva Engage commands, which require the Viva Engage API permission that isn't granted to the CLI by default.
 
 After executing the command, the CLI for Microsoft 365 will present you with a URL that you need to open in the web browser in order to consent the permissions for the selected Microsoft 365 service.
 
-To simplify things, rather than wondering which permissions you should grant for which CLI commands, this command allows you to easily grant all the necessary permissions for using commands for the specified Microsoft 365 service, like Yammer.
+To simplify things, rather than wondering which permissions you should grant for which CLI commands, this command allows you to easily grant all the necessary permissions for using commands for the specified Microsoft 365 service, like Viva Engage.
 
 ## Examples
 
-Consent permissions to the Yammer API
+Consent permissions to the Viva Engage API
 
 ```sh
-m365 cli consent --service yammer
+m365 cli consent --service VivaEngage
 ```
 
 ## Response
@@ -43,28 +43,28 @@ m365 cli consent --service yammer
   <TabItem value="JSON">
 
   ```json
-  "To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation"
+  "To consent permissions for executing VivaEngage commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation"
   ```
 
   </TabItem>
   <TabItem value="Text">
 
   ```text
-  To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
+  To consent permissions for executing VivaEngage commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
+  To consent permissions for executing VivaEngage commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
+  To consent permissions for executing VivaEngage commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
   ```
 
   </TabItem>

package/docs/docs/cmd/connection/connection-list.mdx

@@ -0,0 +1,100 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# connection list
+
+Show the list of available connections
+
+## Usage
+
+```sh
+m365 connection list [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+If you are logged in to Microsoft 365 with multiple identities, this command will show you a list of users and/or applications used to sign in.  
+
+## Examples
+
+Show the list of available identities used to sign in to Microsoft 365
+
+```sh
+m365 connection list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "name": "028de82d-7fd9-476e-a9fd-be9714280ff3",
+      "connectedAs": "alexw@contoso.com",
+      "authType": "DeviceCode",
+      "active": true
+    },
+    {
+      "name": "acd6df42-10a9-4315-8928-53334f1c9d01",
+      "connectedAs": "Contoso Application",
+      "authType": "Secret",
+      "active": false
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  name                                  connectedAs          authType    active
+  ------------------------------------  -------------------  ----------  ------
+  028de82d-7fd9-476e-a9fd-be9714280ff3  alexw@contoso.com    DeviceCode  true
+  acd6df42-10a9-4315-8928-53334f1c9d01  Contoso Application  Secret      false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,connectedAs,authType,active
+  028de82d-7fd9-476e-a9fd-be9714280ff3,alexw@contoso.com,DeviceCode,true
+  acd6df42-10a9-4315-8928-53334f1c9d01,Contoso Application,Secret,false
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # connection list
+
+  Date: 7/2/2023
+
+  ## 028de82d-7fd9-476e-a9fd-be9714280ff3
+
+  Property | Value
+  ---------|-------
+  name | 028de82d-7fd9-476e-a9fd-be9714280ff3
+  connectedAs | alexw@contoso.com
+  authType | DeviceCode
+  active | true
+
+  ## acd6df42-10a9-4315-8928-53334f1c9d01
+
+  Property | Value
+  ---------|-------
+  name | acd6df42-10a9-4315-8928-53334f1c9d01
+  connectedAs | Contoso Application
+  authType | Secret
+  active | false
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/connection/connection-remove.mdx

@@ -0,0 +1,45 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# connection remove
+
+Remove the specified connection
+
+## Usage
+
+```sh
+m365 connection remove [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the connection to remove.
+
+`-f, --force`
+: Don't prompt for confirmation to remove the connection.
+```
+
+<Global />
+
+## Remarks
+
+The value for `--name` can be found by running [m365 connection list](connection-list.mdx). 
+
+## Examples
+
+Remove an existing connection
+
+```sh
+m365 connection remove --name '0bb7cb89-7fae-4775-a01a-c372cc167371'
+```
+
+Remove an existing connection without prompting for confirmation
+
+```sh
+m365 connection remove --name '0bb7cb89-7fae-4775-a01a-c372cc167371' --force
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/connection/connection-set.mdx

@@ -0,0 +1,39 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# connection set
+
+Rename the specified connection
+
+## Usage
+
+```sh
+m365 connection set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the connection to update.
+
+`--newName <newName>`
+: The new name of the connection.
+```
+
+<Global />
+
+## Remarks
+
+The value for `--name` can be found by running [m365 connection list](connection-list.mdx). You can update the name of a connection to any value to make switching connections easier. 
+
+## Examples
+
+Update an existing connection
+
+```sh
+m365 connection set --name '0bb7cb89-7fae-4775-a01a-c372cc167371' --newName 'myworkaccount'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/connection/connection-use.mdx

@@ -0,0 +1,98 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# connection use
+
+Activate the specified Microsoft 365 tenant connection
+
+## Usage
+
+```sh
+m365 connection use [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the connection to switch to.
+```
+
+<Global />
+
+## Remarks
+
+The value for `--name` can be found by running [m365 connection list](connection-list.mdx). You can update the name of a connection by running [m365 connection set](connection-set.mdx). 
+
+## Examples
+
+Switch to a different connection
+
+```sh
+m365 connection use --name '6e70c8ea-571d-4daf-bc48-9e1b49ac3390'
+```
+
+Switch to another connection by a custom connection name
+
+```sh
+m365 connection use --name 'myworkaccount'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "connectedAs": "alexw@contoso.com",
+    "connectedName": "028de82d-7fd9-476e-a9fd-be9714280ff3",
+    "authType": "DeviceCode",
+    "appId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
+    "appTenant": "common",
+    "cloudType": "Public"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appId      : 31359c7f-bd7e-475c-86db-fdb8c937548e
+  appTenant  : common
+  authType   : DeviceCode
+  cloudType  : Public
+  connectionName : 028de82d-7fd9-476e-a9fd-be9714280ff3
+  connectedAs: alexw@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  connectionName,connectedAs,authType,appId,appTenant,cloudType
+  alexw@contoso.com,028de82d-7fd9-476e-a9fd-be9714280ff3,DeviceCode,31359c7f-bd7e-475c-86db-fdb8c937548e,common,Public
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # connection use
+
+  Date: 7/2/2023
+
+  Property | Value
+  ---------|-------
+  connectedAs | alexw@contoso.com
+  connectionName | 028de82d-7fd9-476e-a9fd-be9714280ff3
+  authType | DeviceCode
+  appId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+  appTenant | common
+  cloudType | Public
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -1,6 +1,4 @@
 import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
 
 # entra administrativeunit member add
 
@@ -94,6 +92,10 @@ Add a single device specified by name to an administrative unit specified by nam
 m365 entra administrativeunit member add --administrativeUnitName 'Marketing Division' --deviceName 'JohnDoe-PC'
 ```
 
+## 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
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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
@@ -60,9 +61,9 @@ m365 entra app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f69
 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
+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' --grantAdminConsent
 ```
 
 ## Response
 
-The command won't return a response on success.
+The command won't return a response on success.

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