@pnp/cli-microsoft365 7.5.0-beta.494c631 → 7.5.0-beta.940b241

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
   ```

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

@@ -0,0 +1,231 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra group add
+
+Creates a Microsoft Entra group
+
+## Usage
+
+```sh
+m365 entra group add [options]
+```
+
+## Alias
+
+```sh
+m365 aad group add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --displayName <displayName>`
+: The name for the group. The maximum length is 256 characters.
+
+`-d, --description [description]`
+: The description for the group.
+
+`-t, --type <type>`
+: The group type. Valid values: `microsoft365` or `security`.
+
+`-m, --mailNickname [mailNickname]`
+: The mail alias for the group (part before the @). Maximum length is 64 characters.
+
+`--ownerIds [ownerIds]`
+: Comma-separated list of IDs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
+
+`--ownerUserNames [ownerUserNames]`
+: Comma-separated list of UPNs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
+
+`--memberIds [memberIds]`
+: Comma-separated list of IDs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
+
+`--memberUserNames [memberUserNames]`
+: Comma-separated list of UPNs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
+
+`--visibility [visibility]`
+: Specifies the group join policy and group content visibility for Microsoft 365 groups. Possible values are: `Private`, `Public`, or `HiddenMembership`. Defaults to `Public`. Specify only when creating a group of type `microsoft365`.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+The `visibility` option affects the behavior of the group.
+
+With the `Public` visibility:
+- Anyone can join the group without needing owner permission. 
+- Anyone can view the attributes of the group. 
+- Anyone can see the members of the group.
+
+With the `Private` visibilty:
+- Owner permission is needed to join the group.
+- Anyone can view the attributes of the group.
+- Anyone can see the members of the group.
+
+With the `HiddenMembership` visibility:
+- Owner permission is needed to join the group.
+- Guest users cannot view the attributes of the group.
+- Non-members cannot see the members of the group. This setting doesn't affect visibility of group owners.
+- Administrators (global, company, user, and helpdesk) can view the membership of the group.
+- The group appears in the global address book (GAL).
+
+:::
+
+:::note
+
+The `HiddenMembership` visibility can be set only for Microsoft 365 groups when the groups are created. It can't be updated later.
+
+:::
+
+This command allows using unknown options. For a comprehensive list of group properties, please refer to the [Graph documentation page](https://learn.microsoft.com/graph/api/resources/group?view=graph-rest-1.0#properties).
+
+If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+## Examples
+
+Create a security group without any owners or members
+
+```sh
+m365 entra group add --displayName Developers --type security
+```
+
+Create a private Microsoft 365 group with owners and members and a custom mail address
+
+```sh
+m365 entra group add --displayName Developers --type microsoft365 --mailNickname devs --ownerUserNames john.doe@contoso.com --memberUserNames "john.doe@contoso.com,adele.vance@contoso.com" --visibility Private
+```
+
+Create a public Microsoft 365 group without any owners or members
+
+```sh
+m365 entra group add --displayName Developers --type microsoft365 --description "This group is for all developers in the company." --visibility Public
+```
+
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "ae0e8388-cd70-427f-9503-c57498ee3337",
+    "deletedDateTime": null,
+    "classification": null,
+    "createdDateTime": "2024-01-10T11:33:18Z",
+    "creationOptions": [],
+    "description": "This group is for all developers in the company.",
+    "displayName": "Developers",
+    "expirationDateTime": null,
+    "groupTypes": [
+      "Unified"
+    ],
+    "isAssignableToRole": null,
+    "mail": "devs@contoso.com",
+    "mailEnabled": true,
+    "mailNickname": "devs",
+    "membershipRule": null,
+    "membershipRuleProcessingState": null,
+    "onPremisesDomainName": null,
+    "onPremisesLastSyncDateTime": null,
+    "onPremisesNetBiosName": null,
+    "onPremisesSamAccountName": null,
+    "onPremisesSecurityIdentifier": null,
+    "onPremisesSyncEnabled": null,
+    "preferredDataLocation": null,
+    "preferredLanguage": null,
+    "proxyAddresses": [
+      "SMTP:devs@contoso.com"
+    ],
+    "renewedDateTime": "2024-01-10T11:33:18Z",
+    "resourceBehaviorOptions": [],
+    "resourceProvisioningOptions": [],
+    "securityEnabled": true,
+    "securityIdentifier": "S-1-12-1-2920186760-1115671920-1959068565-926150296",
+    "theme": null,
+    "visibility": "Public",
+    "onPremisesProvisioningErrors": [],
+    "serviceProvisioningErrors": []
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  classification               : null
+  createdDateTime              : 2024-01-10T11:36:31Z
+  creationOptions              : []
+  deletedDateTime              : null
+  description                  : This group is for all developers in the company.
+  displayName                  : Developers
+  expirationDateTime           : null
+  groupTypes                   : ["Unified"]
+  id                           : f7bce6b2-c017-4a00-ba0c-fbbe458364aa
+  isAssignableToRole           : null
+  mail                         : dev@contoso.com
+  mailEnabled                  : true
+  mailNickname                 : devs
+  membershipRule               : null
+  membershipRuleProcessingState: null
+  onPremisesDomainName         : null
+  onPremisesLastSyncDateTime   : null
+  onPremisesNetBiosName        : null
+  onPremisesProvisioningErrors : []
+  onPremisesSamAccountName     : null
+  onPremisesSecurityIdentifier : null
+  onPremisesSyncEnabled        : null
+  preferredDataLocation        : null
+  preferredLanguage            : null
+  proxyAddresses               : ["SMTP:devs@contoso.com"]
+  renewedDateTime              : 2024-01-10T11:36:31Z
+  resourceBehaviorOptions      : []
+  resourceProvisioningOptions  : []
+  securityEnabled              : true
+  securityIdentifier           : S-1-12-1-4156352178-1241563159-3204123834-2858713925
+  serviceProvisioningErrors    : []
+  theme                        : null
+  visibility                   : Public
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,classification,createdDateTime,description,displayName,expirationDateTime,isAssignableToRole,mail,mailEnabled,mailNickname,membershipRule,membershipRuleProcessingState,onPremisesDomainName,onPremisesLastSyncDateTime,onPremisesNetBiosName,onPremisesSamAccountName,onPremisesSecurityIdentifier,onPremisesSyncEnabled,preferredDataLocation,preferredLanguage,renewedDateTime,securityEnabled,securityIdentifier,theme,visibility
+  4c63e8cd-eb2b-4b0d-9251-d709cc75cf5e,,,2024-01-10T11:37:02Z,This group is for all developers in the company.,Developers,,,devs@contoso.com,1,devs,,,,,,,,,,,2024-01-10T11:37:02Z,1,S-1-12-1-1281616077-1259203371-165106066-1590654412,,Public
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra group add --displayName "Developers" --type "microsoft365" --description "This group is for all developers in the company." --visibility "Public" --mailNickname "devs"
+
+  Date: 1/10/2024
+
+  ## Developers (b3fd8e8f-eced-45c7-a366-178bc5c1db37)
+
+  Property | Value
+  ---------|-------
+  id | b3fd8e8f-eced-45c7-a366-178bc5c1db37
+  createdDateTime | 2024-01-10T11:37:39Z
+  description | This group is for all developers in the company.
+  displayName | Developers
+  mail | devs@contoso.com
+  mailEnabled | true
+  mailNickname | devs
+  renewedDateTime | 2024-01-10T11:37:39Z
+  securityEnabled | true
+  securityIdentifier | S-1-12-1-3019738767-1170730221-2333566627-937148869
+  visibility | Public
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/entra/group/group-user-add.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra group user add
+
+Adds a user to a Microsoft Entra ID group
+
+## Usage
+
+```sh
+m365 entra group user add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --groupId [groupId]`
+: The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+
+`-n, --groupDisplayName [groupDisplayName]`
+: The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+
+`--ids [ids]`
+: Entra ID IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
+
+`--userNames [userNames]`
+: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
+
+`-r, --role <role>`
+: The role to be assigned to the new users. Valid values: `Owner`, `Member`.
+```
+
+<Global />
+
+## Examples
+
+Add a single user specified by ID as a member to a group specified by display name
+
+```sh
+m365 entra group user add --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
+Add multiple users specified by ID as members to a group specified by ID
+
+```sh
+m365 entra group user add --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
+```
+
+Add a single user specified by UPN as an owner to a group specified by display name
+
+```sh
+m365 entra group user add --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
+```
+
+Adds multiple users specified by UPN as owners to a group specified by ID
+
+```sh
+m365 entra group user add --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Owner
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/entra/m365group/m365group-report-activitygroupcounts.mdx

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # entra m365group report activitygroupcounts
 
-Get the daily total number of groups and how many of them were active based on email conversations, Yammer posts, and SharePoint file activities.
+Get the daily total number of groups and how many of them were active based on email conversations, Viva Engage posts, and SharePoint file activities.
 
 ## Usage
 

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

@@ -33,11 +33,11 @@ m365 aad oauth2grant add [options]
 
 ## Remarks
 
-Before you can grant service principal OAuth2 permissions, you need its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command.
+Before you can grant service principal OAuth2 permissions, you need its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command.
 
-The resource for which you want to grant permissions is designated using its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command, the same way you would retrieve the `objectId` of the service principal.
+The resource for which you want to grant permissions is designated using its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command, the same way you would retrieve the `objectId` of the service principal.
 
-When granting OAuth2 permissions, you have to specify which permission scopes you want to grant the service principal. You can get the list of available permission scopes either from the resource documentation or from the `appRoles` property when retrieving information about the service principal using the [entra sp get](../sp/sp-get.mdx) command. Multiple permission scopes can be specified separated by a space.
+When granting OAuth2 permissions, you have to specify which permission scopes you want to grant the service principal. You can get the list of available permission scopes either from the resource documentation or from the `appRoles` property when retrieving information about the service principal using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command. Multiple permission scopes can be specified separated by a space.
 
 When granting OAuth2 permissions, the values of the `clientId` and `resourceId` properties form a unique key. If a grant for the same `clientId`-`resourceId` pair already exists, running the `entra oauth2grant add` command will fail with an error. If you want to change permissions on an existing OAuth2 grant use the [entra oauth2grant set](./oauth2grant-set.mdx) command instead.
 

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

@@ -29,7 +29,7 @@ m365 aad oauth2grant list [options]
 
 ## Remarks
 
-In order to list existing OAuth2 permissions granted to a service principal, you need its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command.
+In order to list existing OAuth2 permissions granted to a service principal, you need its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command.
 
 When using the text output type (default), the command lists only the values of the `objectId`, `resourceId` and `scope` properties of the OAuth grant. When setting the output type to JSON, all available properties are included in the command output.