@pnp/cli-microsoft365 10.1.0-beta.f17d225 → 10.2.0-beta.382f561

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

@@ -22,16 +22,19 @@ m365 entra appregistration get [options]
 
 ```md definition-list
 `--appId [appId]`
-: Application (client) ID of the Entra 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 Entra 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 Entra 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
+: Use to store the information about the created app in a local file.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
 ```
 
 <Global />
@@ -44,24 +47,26 @@ If the command finds multiple Entra application registrations with the specified
 
 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.
 
+Using the `--properties` option, you can specify a comma-separated list of app properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
+
 ## Examples
 
-Get the Entra application registration by its app (client) ID
+Get the Entra application registration by its app (client) ID.
 
 ```sh
 m365 entra app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get the Entra application registration by its object ID
+Get the Entra application registration by its object ID.
 
 ```sh
 m365 entra app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Get the Entra application registration by its name
+Get the Entra application registration by its name with specified properties.
 
 ```sh
-m365 entra app get --name "My app"
+m365 entra app get --name "My app" --properties "appId,displayName"
 ```
 
 Get the Entra application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.

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

@@ -20,16 +20,31 @@ m365 entra appregistration list [options]
 
 ## Options
 
+```md definition-list
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+```
+
 <Global />
 
+## Remarks
+
+Using the `--properties` option, you can specify a comma-separated list of app properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
+
 ## Examples
 
-Retrieve a list of Entra app registrations
+Retrieve a list of Entra app registrations.
 
 ```sh
 m365 entra app list
 ```
 
+Retrieve a list of Entra app registrations with specified properties.
+
+```sh
+m365 entra app list --properties "appId,displayName"
+```
+
 ## Response
 
 <Tabs>

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

@@ -20,22 +20,29 @@ m365 entra group get [options]
 
 `-n, --displayName [displayName]`
 : The display name of the Entra group. Specify either `id` or `displayName` but not both.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
 ```
 
 <Global />
 
+## Remarks
+
+Using the `--properties` option, you can specify a comma-separated list of group properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
+
 ## Examples
 
-Get information about an Entra Group by id
+Get information about an Entra Group by id.
 
 ```sh
 m365 entra group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
-Get information about an Entra Group by its display name
+Get information about an Entra Group by its display name with specified properties.
 
 ```sh
-m365 entra group get --displayName Finance
+m365 entra group get --displayName Finance --properties "mail,displayName"
 ```
 
 ## Response

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

@@ -17,10 +17,17 @@ m365 entra group list [options]
 ```md definition-list
 `--type [type]`
 : Filter the results to only groups of a given type. Allowed values: `microsoft365`, `security`, `distribution`, `mailEnabledSecurity`. By default, all groups are listed.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
 ```
 
 <Global />
 
+## Remarks
+
+Using the `--properties` option, you can specify a comma-separated list of group properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
+
 ## Examples
 
 Lists all groups defined in Entra ID.
@@ -29,10 +36,10 @@ Lists all groups defined in Entra ID.
 m365 entra group list
 ```
 
-List all security groups defined in Entra ID.
+List all security groups defined in Entra ID with specified properties.
 
 ```sh
-m365 entra group list --type security
+m365 entra group list --type security --properties "mail,displayName"
 ```
 
 ## Response

package/docs/docs/cmd/entra/m365group/m365group-conversation-list.mdx

@@ -15,20 +15,29 @@ m365 entra m365group conversation list [options]
 ## Options
 
 ```md definition-list
-`-i, --groupId <groupId>`
-: The ID of the Microsoft 365 group
+`-i, --groupId [groupId]`
+: The ID of the Microsoft 365 Group. Specify either `groupId` or `groupName`, but not both.
+
+`-n, --groupName [groupName]`
+: Display name of the Microsoft 365 Group. Specify either `groupId` or `groupName`, but not both.
 ```
 
 <Global />
 
 ## Examples
 
-Lists conversations for the specified Microsoft 365 group
+Lists conversations for the Microsoft 365 group specified by id.
 
 ```sh
 m365 entra m365group conversation list --groupId '00000000-0000-0000-0000-000000000000'
 ```
 
+Lists conversations for the Microsoft 365 group specified by displayName.
+
+```sh
+m365 entra m365group conversation list --groupName Finance
+```
+
 ## Response
 
 <Tabs>

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

@@ -15,8 +15,11 @@ m365 entra m365group get [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group or Microsoft Teams team to retrieve information for
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
 
 `--includeSiteUrl`
 : Set to retrieve the site URL for the group
@@ -32,6 +35,12 @@ Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-9
 m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
+Get information about the Microsoft 365 Group with displayName _Finance_
+
+```sh
+m365 entra m365group get --displayName Finance
+```
+
 Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site
 
 ```sh
@@ -80,7 +89,12 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
     "securityIdentifier": "S-1-12-1-4288263055-1337657931-1773679776-1830684296",
     "theme": null,
     "visibility": "Public",
-    "onPremisesProvisioningErrors": []
+    "onPremisesProvisioningErrors": [],
+    "allowExternalSenders": false,
+    "autoSubscribeNewMembers": false,
+    "isSubscribedByMail": false,
+    "hideFromOutlookClients": false,
+    "hideFromAddressLists": false
   }
   ```
 
@@ -88,6 +102,8 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   <TabItem value="Text">
 
   ```text
+  allowExternalSenders         : false
+  autoSubscribeNewMembers      : false
   classification               : null
   createdDateTime              : 2023-06-01T20:18:30Z
   creationOptions              : []
@@ -96,8 +112,11 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   displayName                  : Finance
   expirationDateTime           : null
   groupTypes                   : ["Unified"]
+  hideFromAddressLists         : false
+  hideFromOutlookClients       : false
   id                           : ff99b38f-0a4b-4fbb-a034-b86988061e6d
   isAssignableToRole           : null
+  isSubscribedByMail           : false
   mail                         : finance@contoso.onmicrosoft.com
   mailEnabled                  : true
   mailNickname                 : finance
@@ -126,8 +145,8 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   <TabItem value="CSV">
 
   ```csv
-  id,createdDateTime,description,displayName,mail,mailEnabled,mailNickname,renewedDateTime,securityEnabled,securityIdentifier,visibility
-  ff99b38f-0a4b-4fbb-a034-b86988061e6d,2023-06-01T20:18:30Z,"This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.",Finance,finance@contoso.onmicrosoft.com,1,finance,2023-06-01T20:18:30Z,,S-1-12-1-4288263055-1337657931-1773679776-1830684296,Public
+  id,createdDateTime,description,displayName,mail,mailEnabled,mailNickname,renewedDateTime,securityEnabled,securityIdentifier,visibility,allowExternalSenders,autoSubscribeNewMembers,isSubscribedByMail,hideFromOutlookClients,hideFromAddressLists
+  ff99b38f-0a4b-4fbb-a034-b86988061e6d,2023-06-01T20:18:30Z,"This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.",Finance,finance@contoso.onmicrosoft.com,1,finance,2023-06-01T20:18:30Z,,S-1-12-1-4288263055-1337657931-1773679776-1830684296,Public,false,false,false,false,false
   ```
 
   </TabItem>
@@ -153,6 +172,11 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   securityEnabled | false
   securityIdentifier | S-1-12-1-4288263055-1337657931-1773679776-1830684296
   visibility | Public
+  allowExternalSenders | false
+  autoSubscribeNewMembers | false
+  isSubscribedByMail | false
+  hideFromOutlookClients | false
+  hideFromAddressLists | false
   ```
 
   </TabItem>

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

@@ -13,8 +13,11 @@ m365 entra m365group remove [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group to remove
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group to remove. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to remove. Specify either `id` or `displayName`, but not both.
 
 `-f, --force`
 : Don't prompt for confirming removing the group
@@ -47,10 +50,10 @@ Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_. Will prompt for con
 m365 entra m365group remove --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```
 
-Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_ without prompting for confirmation
+Remove group with displayName _Finance_ without prompting for confirmation
 
 ```sh
-m365 entra m365group remove --id 28beab62-7540-4db1-a23f-29a6018a3848 --force
+m365 entra m365group remove --displayName Finance --force
 ```
 
 Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_ without prompting for confirmation and without moving it to the Recycle Bin

package/docs/docs/cmd/entra/m365group/m365group-renew.mdx

@@ -13,8 +13,11 @@ m365 entra m365group renew [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 group to renew
+`-i, --id [id]`
+: The ID of the Microsoft 365 group to renew. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to renew. Specify either `id` or `displayName`, but not both.
 ```
 
 <Global />
@@ -31,6 +34,12 @@ Renew the Microsoft 365 group with id _28beab62-7540-4db1-a23f-29a6018a3848_
 m365 entra m365group renew --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```
 
+Renew the Microsoft 365 group with displayName _Finance_
+
+```sh
+m365 entra m365group renew --displayName Finance
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/entra/m365group/m365group-teamify.mdx

@@ -14,10 +14,13 @@ m365 entra m365group teamify [options]
 
 ```md definition-list
 `-i, --id [id]`
-: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id` or `mailNickname` but not both.
+: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
 
 `--mailNickname [mailNickname]`
-: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id` or `mailNickname` but not both.
+: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
 ```
 
 <Global />
@@ -30,7 +33,13 @@ Creates a new Microsoft Teams team under existing Microsoft 365 group with the s
 m365 entra m365group teamify --id e3f60f99-0bad-481f-9e9f-ff0f572fbd03
 ```
 
-Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified mailNickname.
+Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified displayName.
+
+```sh
+m365 entra m365group teamify --displayName Finance
+```
+
+Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified mailNickname._
 
 ```sh
 m365 entra m365group teamify --mailNickname GroupName

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

@@ -13,7 +13,7 @@ m365 entra m365group user add [options]
 ## Alias
 
 ```sh
-m365 teams user add
+m365 teams user add [options]
 ```
 
 ## Options
@@ -38,7 +38,7 @@ m365 teams user add
 : 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 user: `Owner,Member`. Default `Member`.
+: The role to be assigned to the new user. Allowed values: `Owner`, `Member`. Default `Member`.
 ```
 
 <Global />

package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx

@@ -57,6 +57,12 @@ List specific properties for all group users from a group specified by ID.
 m365 entra m365group user list --groupId 03cba9da-3974-46c1-afaf-79caa2e45bbe --properties "id,jobTitle,companyName,accountEnabled"
 ```
 
+List all group members that are guest users.
+
+```sh
+m365 entra m365group user list --groupDisplayName Developers --filter "userType eq 'Guest'"
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/entra/m365group/m365group-user-remove.mdx

@@ -17,7 +17,7 @@ m365 entra m365group user remove [options]
 : The ID of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
 
 `--groupName [groupName]`
-: The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`..
+: The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
 
 `--teamId [teamId]`
 : The ID of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.

package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx

@@ -32,7 +32,7 @@ m365 entra m365group user set [options]
 : The user principal names of users. You can also pass a comma-separated list of UPNs. Specify only one of the following `ids` or `userNames`.
 
 `-r, --role <role>`
-: Role to set for the given user in the specified Microsoft 365 Group or Microsoft Teams team. Allowed values: `Owner`, `Member`
+: Role to set for the given user in the specified Microsoft 365 Group or Microsoft Teams team. Allowed values: `Owner`, `Member`.
 ```
 
 <Global />
@@ -70,13 +70,13 @@ m365 entra m365group user set --groupId '00000000-0000-0000-0000-000000000000' -
 Demote multiple users specified by the userNames parameter from Owner to Member of the given Microsoft Teams team
 
 ```sh
-m365 entra teams user set --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Member
+m365 teams user set --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Member
 ```
 
 Demote multiple users specified by the ids parameter from Owner to Member in the given Microsoft Teams team
 
 ```sh
-m365 entra teams user set --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
+m365 teams user set --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
 ```
 
 ## Response

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

@@ -0,0 +1,150 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roledefinition get
+
+Gets a specific Microsoft Entra ID role definition.
+
+## Usage
+
+```sh
+m365 entra roledefinition get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the role definition. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: The display name of the role definition. Specify either `id` or `displayName`, but not both.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+```
+
+<Global />
+
+## Examples
+
+Get info about a role specified by the id
+
+```sh
+m365 entra roledefinition get --id 62e90394-69f5-4237-9190-012177145e10
+```
+
+Get limited info about a role specified by the display name
+
+```sh
+m365 entra roledefinition get --displayName 'Custom SharePoint Role' --properties 'description,isEnabled'
+```
+
+## Response
+
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
+    "description": "Can manage all aspects of the SharePoint service.",
+    "displayName": "SharePoint Administrator",
+    "isBuiltIn": true,
+    "isEnabled": true,
+    "resourceScopes": [
+      "/"
+    ],
+    "templateId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
+    "version": "1",
+    "rolePermissions": [
+      {
+        "allowedResourceActions": [
+          "microsoft.azure.serviceHealth/allEntities/allTasks",
+          "microsoft.azure.supportTickets/allEntities/allTasks",
+          "microsoft.backup/oneDriveForBusinessProtectionPolicies/allProperties/allTasks",
+          "microsoft.backup/oneDriveForBusinessRestoreSessions/allProperties/allTasks",
+          "microsoft.backup/restorePoints/sites/allProperties/allTasks",
+          "microsoft.backup/restorePoints/userDrives/allProperties/allTasks",
+          "microsoft.backup/sharePointProtectionPolicies/allProperties/allTasks",
+          "microsoft.backup/sharePointRestoreSessions/allProperties/allTasks",
+          "microsoft.backup/siteProtectionUnits/allProperties/allTasks",
+          "microsoft.backup/siteRestoreArtifacts/allProperties/allTasks",
+          "microsoft.backup/userDriveProtectionUnits/allProperties/allTasks",
+          "microsoft.backup/userDriveRestoreArtifacts/allProperties/allTasks",
+          "microsoft.directory/groups/hiddenMembers/read",
+          "microsoft.directory/groups.unified/basic/update",
+          "microsoft.directory/groups.unified/create",
+          "microsoft.directory/groups.unified/delete",
+          "microsoft.directory/groups.unified/members/update",
+          "microsoft.directory/groups.unified/owners/update",
+          "microsoft.directory/groups.unified/restore",
+          "microsoft.office365.migrations/allEntities/allProperties/allTasks",
+          "microsoft.office365.network/performance/allProperties/read",
+          "microsoft.office365.serviceHealth/allEntities/allTasks",
+          "microsoft.office365.sharePoint/allEntities/allTasks",
+          "microsoft.office365.supportTickets/allEntities/allTasks",
+          "microsoft.office365.usageReports/allEntities/allProperties/read",
+          "microsoft.office365.webPortal/allEntities/standard/read"
+        ],
+        "condition": null
+      }
+    ],
+    "inheritsPermissionsFrom": [
+      {
+        "id": "88d8e3e3-8f55-4a1e-953a-9b9898b8876b"
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  description            : Can manage all aspects of the SharePoint service.
+  displayName            : SharePoint Administrator
+  id                     : f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  inheritsPermissionsFrom: [{"id":"88d8e3e3-8f55-4a1e-953a-9b9898b8876b"}]
+  isBuiltIn              : true
+  isEnabled              : true
+  resourceScopes         : ["/"]
+  rolePermissions        : [{"allowedResourceActions":["microsoft.azure.serviceHealth/allEntities/allTasks","microsoft.azure.supportTickets/allEntities/allTasks","microsoft.office365.webPortal/allEntities/standard/read"],"condition":null}]
+  templateId             : f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  version                : 1
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,description,displayName,isBuiltIn,isEnabled,templateId,version
+  f28a1f50-f6e7-4571-818b-6a12f2af6b6c,Can manage all aspects of the SharePoint service.,SharePoint Administrator,1,1,f28a1f50-f6e7-4571-818b-6a12f2af6b6c,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roledefinition get --id "f28a1f50-f6e7-4571-818b-6a12f2af6b6c"
+
+  Date: 11/15/2024
+
+  ## SharePoint Administrator (f28a1f50-f6e7-4571-818b-6a12f2af6b6c)
+
+  Property | Value
+  ---------|-------
+  id | f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  description | Can manage all aspects of the SharePoint service.
+  displayName | SharePoint Administrator
+  isBuiltIn | true
+  isEnabled | true
+  templateId | f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  version | 1
+  ```
+
+  </TabItem>
+</Tabs>