@pnp/cli-microsoft365 11.0.0-beta.1f852eb → 11.0.0-beta.3143306

package/dist/utils/spe.js

@@ -1,58 +1,24 @@
-import request from '../request.js';
 import { formatting } from './formatting.js';
 import { cli } from '../cli/cli.js';
-import config from '../config.js';
 import { odata } from './odata.js';
 const graphResource = 'https://graph.microsoft.com';
 export const spe = {
-    /**
-     * Get all container types.
-     * @param spoAdminUrl The URL of the SharePoint Online admin center site (e.g. https://contoso-admin.sharepoint.com)
-     * @returns Array of container types
-     */
-    async getAllContainerTypes(spoAdminUrl) {
-        const requestOptions = {
-            url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
-            headers: {
-                accept: 'application/json;odata=nometadata'
-            },
-            responseType: 'json',
-            data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="46" ObjectPathId="45" /><Method Name="GetSPOContainerTypes" Id="47" ObjectPathId="45"><Parameters><Parameter Type="Enum">1</Parameter></Parameters></Method></Actions><ObjectPaths><Constructor Id="45" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /></ObjectPaths></Request>`
-        };
-        const json = await request.post(requestOptions);
-        const response = json[0];
-        if (response.ErrorInfo) {
-            throw new Error(response.ErrorInfo.ErrorMessage);
-        }
-        const containerTypes = json[json.length - 1];
-        // Format the response to remove CSOM GUIDs and convert them to real GUIDs
-        containerTypes.forEach(ct => {
-            delete ct._ObjectType_;
-            ct.AzureSubscriptionId = formatting.extractCsomGuid(ct.AzureSubscriptionId);
-            ct.ContainerTypeId = formatting.extractCsomGuid(ct.ContainerTypeId);
-            ct.OwningAppId = formatting.extractCsomGuid(ct.OwningAppId);
-            ct.OwningTenantId = formatting.extractCsomGuid(ct.OwningTenantId);
-        });
-        return containerTypes;
-    },
     /**
      * Get the ID of a container type by its name.
-     * @param spoAdminUrl SharePoint Online admin center URL (e.g. https://contoso-admin.sharepoint.com)
      * @param name Name of the container type to search for
      * @returns ID of the container type
      */
-    async getContainerTypeIdByName(spoAdminUrl, name) {
-        const allContainerTypes = await this.getAllContainerTypes(spoAdminUrl);
-        const containerTypes = allContainerTypes.filter(ct => ct.DisplayName.toLowerCase() === name.toLowerCase());
+    async getContainerTypeIdByName(name) {
+        const containerTypes = await odata.getAllItems(`${graphResource}/beta/storage/fileStorage/containerTypes?$select=id,name&$filter=name eq '${formatting.encodeQueryParameter(name)}'`);
         if (containerTypes.length === 0) {
             throw new Error(`The specified container type '${name}' does not exist.`);
         }
         if (containerTypes.length > 1) {
-            const containerTypeKeyValuePair = formatting.convertArrayToHashTable('ContainerTypeId', containerTypes);
+            const containerTypeKeyValuePair = formatting.convertArrayToHashTable('id', containerTypes);
             const containerType = await cli.handleMultipleResultsFound(`Multiple container types with name '${name}' found.`, containerTypeKeyValuePair);
-            return containerType.ContainerTypeId;
+            return containerType.id;
         }
-        return containerTypes[0].ContainerTypeId;
+        return containerTypes[0].id;
     },
     /**
      * Get the ID of a container by its name.

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

@@ -31,7 +31,7 @@ m365 entra appregistration add [options]
 : Comma-separated list of redirect URIs. Requires `platform` to be specified.
 
 `-p, --platform [platform]`
-: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`. Requires `redirectUris` to be specified.
+: Platform for which the app should be configured. Allowed values `spa`, `web`, `publicClient`, `apple`, `android`.
 
 `--implicitFlow`
 : Specify, to indicate that the authorization endpoint should return ID and access tokens.
@@ -75,6 +75,12 @@ m365 entra appregistration add [options]
 `--manifest [manifest]`
 : App manifest as retrieved from Entra ID to create the app registration from. Specify either `name` or `manifest` but not both.
 
+`--bundleId [bundleId]`
+: Specify a bundle Id to add the iOS / macOS or Android platform to the application. Required when platform is `apple` or `android`.
+
+`--signatureHash [signatureHash]`
+: A required hash when specifying a bundle Id and platform `android`.
+
 `--save`
 : Use to store the information about the created app in a local file.
 

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

@@ -14,28 +14,21 @@ m365 entra group member add [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
-
-`-n, --groupDisplayName [groupDisplayName]`
-: (deprecated. Use option `groupName` instead) The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
-
-`--groupName [groupName]`
-: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
-
-`--ids [ids]`
-: (deprecated. Use option `userIds` instead) Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids`, `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
+: The ID of the Microsoft Entra group. Specify `groupId` or `groupName` but not both.
 
+`-n, --groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId` or `groupName` but not both.
 `--userIds [userIds]`
-: Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids`, `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
+: Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
 
 `--userNames [userNames]`
-: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids`, `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
+: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
 
 `--subgroupIds [subgroupIds]`
-: Comma-separated list of Microsoft Entra group IDs to add. Specify either `ids`, `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
+: Comma-separated list of Microsoft Entra group IDs to add. Specify either `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
 
 `--subgroupNames [subgroupNames]`
-: Comma-separated list of Microsoft Entra group titles to add. Specify either `ids`, `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
+: Comma-separated list of Microsoft Entra group titles to add. Specify either `userIds`,`userNames`, `subgroupIds`, or `subgroupNames` but not multiple.
 
 `-r, --role <role>`
 : The role to be assigned to the new users. Valid values: `Owner`, `Member`.
@@ -45,12 +38,6 @@ m365 entra group member add [options]
 
 ## Examples
 
-Add a single member specified by ID as a member to a group specified by display name.
-
-```sh
-m365 entra group member add --groupDisplayName Developers --userIds 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
-```
-
 Add a single member specified by ID as a member to a group specified by group name.
 
 ```sh
@@ -63,12 +50,6 @@ Add multiple members specified by ID as members to a group specified by ID.
 m365 entra group member add --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userIds "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
 ```
 
-Add a single member specified by UPN as an owner to a group specified by display name.
-
-```sh
-m365 entra group member add --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
-```
-
 Add a single member specified by UPN as an owner to a group specified by group name.
 
 ```sh

package/docs/docs/cmd/entra/group/group-member-set.mdx

@@ -14,22 +14,16 @@ m365 entra group member set [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
+: The ID of the Entra ID group. Specify `groupId`, or `groupName` but not both.
 
-`-n, --groupDisplayName [groupDisplayName]`
-: (deprecated. Use option `groupName` instead) The display name of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
-
-`--groupName [groupName]`
-: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
-
-`--ids [ids]`
-: (deprecated. Use option `userIds` instead) Comma-separated list of user IDs. Specify either `ids`, `userIds` or `userNames` but not multiple.
+`-n, --groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId`, `groupName` but not both.
 
 `--userIds [userIds]`
-: Comma-separated list of user IDs. Specify either `ids`, `userIds` or `userNames` but not multiple.
+: Comma-separated list of user IDs. Specify either `userIds` or `userNames` but not multiple.
 
 `--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.
+: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `userIds` or `userNames` but not both.
 
 `-r, --role <role>`
 : The new role to be assigned to the members. Valid values: `Owner`, `Member`.
@@ -39,12 +33,6 @@ m365 entra group member set [options]
 
 ## Examples
 
-Update a single member specified by ID to a member of a group specified by display name
-
-```sh
-m365 entra group member set --groupDisplayName Developers --userIds 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
-```
-
 Update a single member specified by ID to a member of a group specified by group name
 
 ```sh
@@ -57,12 +45,6 @@ Update multiple members specified by ID to members of a group specified by ID
 m365 entra group member set --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userIds "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
 ```
 
-Update a single member specified by UPN to an owner of a group specified by display name
-
-```sh
-m365 entra group member set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
-```
-
 Update a single member specified by UPN to an owner of a group specified by group name
 
 ```sh

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

@@ -21,9 +21,6 @@ m365 entra m365group get [options]
 `-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`
-: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for the group.
-
 `--withSiteUrl`
 : Set to retrieve the site URL for the group.
 ```

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

@@ -21,9 +21,6 @@ m365 entra m365group list [options]
 `-m, --mailNickname [displayName]`
 : Retrieve only groups with mailNickname starting with the specified value.
 
-`--includeSiteUrl`
-: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for each group.
-
 `--withSiteUrl`
 : Set to retrieve the site URL for each group.
 

package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx

@@ -27,9 +27,6 @@ m365 entra pim role assignment eligibility list [options]
 `--groupName [groupName]`
 : Display name of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
 
-`--includePrincipalDetails`
-: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were eligible for a role.
-
 `--withPrincipalDetails`
 : An optional flag to include details of the principals that were eligible for a role.
 ```

package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx

@@ -30,9 +30,6 @@ m365 entra pim role assignment list [options]
 `-s, --startDateTime [startDateTime]`
 : An optional ISO 8601 formatted date filter to search from.
 
-`--includePrincipalDetails`
-: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
-
 `--withPrincipalDetails`
 : An optional flag to include details of the principals that were assigned a role.
 ```

package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx

@@ -33,9 +33,6 @@ m365 entra pim role request list [options]
 `-s, --status [status]`
 : An optional value to filter the list of requests. Allowed values are: `Canceled`, `Denied`, `Failed`, `Granted`, `PendingAdminDecision`, `PendingApproval`, `PendingProvisioning`, `PendingScheduleCreation`, `Provisioned`, `Revoked`, and `ScheduleCreated`.
 
-`--includePrincipalDetails`
-: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
-
 `--withPrincipalDetails`
 : An optional flag to include details of the principals that were assigned a role.
 ```

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

@@ -0,0 +1,163 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roleassignment add
+
+Assign a Entra ID role to a user and specify the scope for which the user has been granted access
+
+## Usage
+
+```sh
+m365 entra roleassignment add [options]
+```
+
+## Options
+
+```md definition-list
+`--roleDefinitionId [roleDefinitionId]`
+: Id of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--roleDefinitionName [roleDefinitionName]`
+: Name of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--principal <principal>`
+: Id of a user, group or service principal or user principal name or group mail nickname to which the assignment is granted.
+
+`--userId [userId]`
+: Id of a user to which the assignment is scoped.
+
+`--userName [userName]`
+: User principal name of a user to which the assignment is scoped.
+
+`--administrativeUnitId [administrativeUnitId]`
+: Id of an administrative unit to which the assignment is scoped.
+
+`--administrativeUnitName [administrativeUnitName]`
+: Name of an administrative unit to which the assignment is scoped.
+
+`--applicationId [applicationId]`
+: Id of an application to which the assignment is scoped.
+
+`applicationObjectId [applicationObjectId]`
+: Object Id of an application to which the assignment is scoped.
+
+`--applicationName [applicationName]`
+: Name of an application to which the assignment is scoped.
+
+`--servicePrincipalId [servicePrincipalId]`
+: Id of a service principal to which the assignment is scoped.
+
+`--servicePrincipalName [servicePrincipalName]`
+: Name of a service principal to which the assignment is scoped.
+
+`--groupId [groupId]`
+: Id of a group to which the assignment is scoped.
+
+`--groupName [groupName]`
+: Name of a group to which the assignment is scoped.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                        |
+  |-----------------|------------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Directory |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                        |
+  |-----------------|------------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Directory |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Assign a role specified by name to a user specified by id and scope the assignment to the whole tenant
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'SharePoint Administrator' --principal 7a2ca997-9461-402e-9882-58088a370889
+```
+
+Assign a role specified by id to a user specified by UPN and scope the assignment to a service principal specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionId 777b752-f9b7-4205-a2b1-5db0d6a0ccfc --principal john.doe@contoso.com --servicePrincipalId a4738dd8-fc0f-4646-87fb-47539f5c651b
+```
+
+Assign a role specified by name to a group specified by mail nickname and scope the assignment to an administrative unit specified by name
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'User Administrator' --principal 'contoso-group' --administrativeUnitName 'Marketing'
+```
+
+Assign a role specified by name to a service principal specified by id and scope the assignment to an application specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'Application Administrator' --principal ab2ca997-9461-402e-9882-58088a370889 --applicationId 47539fd8-fc0f-4646-87fb-a4738d5c651b
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1",
+    "principalId": "3844129d-f748-4c03-8165-4412ee9b4ceb",
+    "directoryScopeId": "/",
+    "roleDefinitionId": "92b086b3-e367-4ef2-b869-1de128fb986e"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryScopeId: /
+  id              : s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId     : 3844129d-f748-4c03-8165-4412ee9b4ceb
+  roleDefinitionId: 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,directoryScopeId,roleDefinitionId
+  s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1,3844129d-f748-4c03-8165-4412ee9b4ceb,/,92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roleassignment add --roleDefinitionId "92b086b3-e367-4ef2-b869-1de128fb986e" --principal "3844129d-f748-4c03-8165-4412ee9b4ceb"
+
+  Date: 7/3/2025
+
+  ## s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+
+  Property | Value
+  ---------|-------
+  id | s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId | 3844129d-f748-4c03-8165-4412ee9b4ceb
+  directoryScopeId | /
+  roleDefinitionId | 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/api/rbacapplication-post-roleassignments

package/docs/docs/cmd/flow/environment/environment-get.mdx

@@ -16,7 +16,10 @@ m365 flow environment get [options]
 
 ```md definition-list
 `-n, --name [name]`
-: The name of the environment to get information about. When not specified, the default environment is retrieved.
+: The name of the environment to get information about. When not specified, the default environment is retrieved. Specify either `name` or `default`, but not both.
+
+`--default`
+: Indicates that the default environment should be retrieved. Specify either `name` or `default`, but not both.
 ```
 
 <Global />
@@ -42,13 +45,11 @@ m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 Get information about the default Microsoft Flow environment.
 
 ```sh
-m365 flow environment get
+m365 flow environment get --default
 ```
 
 ## Response
 
-### Standard response
-
 <Tabs>
   <TabItem value="JSON">
 
@@ -153,7 +154,7 @@ m365 flow environment get
   <TabItem value="Markdown">
 
   ```md
-  # flow environment get
+  # flow environment get --default
 
   Date: 8/2/2023
 

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

@@ -21,9 +21,6 @@ m365 flow list [options]
 `--sharingStatus [sharingStatus]`
 : List a specific type of flows. Valid values: `ownedByMe`, `personal`, `sharedWithMe`, `all`. Defaults to `ownedByMe`. Don't specify this option when using asAdmin.
 
-`--includeSolutions`
-: (deprecated. Use option `withSolutions` instead) Include flows from solutions.
-
 `--withSolutions`
 : Include flows from solutions.
 

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -24,9 +24,6 @@ m365 flow run get [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located.
 
-`--includeTriggerInformation`
-: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.
-
 `--withTrigger`
 : If specified, include information about the trigger details.
 

package/docs/docs/cmd/graph/subscription/subscription-add.mdx

@@ -39,9 +39,6 @@ m365 graph subscription add [options]
 `--latestTLSVersion [latestTLSVersion]`
 : The latest version of TLS that the notification endpoint supports. Allowed values are `v1_0`, `v1_1`, `v1_2`, `v1_3`. Default is `v1_2`.
 
-`--includeResourceData`
-: (deprecated. Use option `withResourceData` instead) When set, the change notifications will include the changed resource data.
-
 `--withResourceData`
 : When set, the change notifications will include the changed resource data.
 

package/docs/docs/cmd/outlook/mail/mail-searchfolder-add.mdx

@@ -0,0 +1,147 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook mail searchfolder add
+
+Creates a new mail search folder in the user's mailbox
+
+## Usage
+
+```sh
+m365 outlook mail searchfolder add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --userId [userId]`
+: The id of the user in whose mailbox the search folder should be created. Specify either `userId` or `userName`, but not both.
+
+`-n, --userName [userName]`
+: The UPN of the user in whose mailbox the search folder should be created. Specify either `userId` or `userName`, but not both.
+
+`--folderName <folderName>`
+: The name of the mail search folder.
+
+`--sourceFolderIds <sourceFolderIds>`
+: Comma-separated list of mail folders that should be searched.
+
+`--includeNestedFolders`
+: The nested mail folders will be searched if specified.
+
+`--messageFilter <messageFilter>`
+: The OData query to filter the messages.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Mail.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Mail.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Create a mail search folder in the user's mailbox specified by id for messages from the inbox that contain specific subject
+
+```sh
+m365 outlook mail searchfolder add --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --folderName 'CLI m365' --sourceFolderIds 'AQMkADYAAAIBDAAAAA==' --messageFilter "contains(subject, 'CLI for Microsoft 365')"
+```
+
+Create a mail search folder in the user's mailbox specified by UPN for incoming and outgoing messages from a specific year that contain specific text in a message body, search for messages inside all subfolders
+
+```sh
+m365 outlook mail searchfolder add --userName john.doe@contoso.com --folderName 'Power Platform Community' --sourceFolderIds 'AQMkADYAAAIBDAAAAA==,AQMkADYAAAIBDBBBBB==' --includeNestedFolders --messageFilter "contains(body/content,'Power Platform') AND receivedDateTime ge 2024-01-01 AND receivedDateTime le 2024-12-31"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQABco84sgAAAA==",
+    "displayName": "Microsoft Entra",
+    "parentFolderId": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEEAAAA",
+    "childFolderCount": 0,
+    "unreadItemCount": 27,
+    "totalItemCount": 41,
+    "sizeInBytes": null,
+    "isHidden": false,
+    "isSupported": true,
+    "includeNestedFolders": false,
+    "sourceFolderIds": [
+      "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEMAAAA"
+    ],
+    "filterQuery": "contains(subject,'Microsoft Entra ID')"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  childFolderCount    : 0
+  displayName         : Microsoft Entra
+  filterQuery         : contains(subject,'Microsoft Entra ID')
+  id                  : AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQABco88nAAAAA==
+  includeNestedFolders: false
+  isHidden            : false
+  isSupported         : true
+  parentFolderId      : AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEEAAAA
+  sizeInBytes         : null
+  sourceFolderIds     : ["AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEMAAAA"]
+  totalItemCount      : 41
+  unreadItemCount     : 27
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,parentFolderId,childFolderCount,unreadItemCount,totalItemCount,sizeInBytes,isHidden,isSupported,includeNestedFolders,filterQuery
+  AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQABco88ngAAAA==,Microsoft Entra,AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEEAAAA,0,27,41,,,1,,"contains(subject,'Microsoft Entra ID')"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook mail searchfolder add --debug "false" --verbose "false" --userName "john.doe@contoso.com" --folderName "Microsoft Entra4" --messageFilter "contains(subject,'Microsoft Entra ID')" --sourceFoldersIds "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEMAAAA"
+
+  Date: 9/6/2024
+
+  ## Microsoft Entra (AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQABco88oAAAAA==)
+
+  Property | Value
+  ---------|-------
+  id | AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQABco88oAAAAA==
+  displayName | Microsoft Entra
+  parentFolderId | AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YHqjbDnRgQAAAgEEAAAA
+  childFolderCount | 0
+  unreadItemCount | 27
+  totalItemCount | 41
+  isHidden | false
+  isSupported | true
+  includeNestedFolders | false
+  filterQuery | contains(subject,'Microsoft Entra ID')
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/pa/environment/environment-get.mdx

@@ -16,7 +16,10 @@ m365 pa environment get [options]
 
 ```md definition-list
 `-n, --name [name]`
-: The name of the environment. When not specified, the default environment is retrieved.
+: The name of the environment. When not specified, the default environment is retrieved. Specify either `name` or `default`, but not both.
+
+`--default`
+: Indicates that the default environment should be retrieved. Specify either `name` or `default`, but not both.
 ```
 
 <Global />
@@ -36,7 +39,7 @@ If the environment with the name you specified doesn't exist, you will get the `
 Get information about the default Power Apps environment.
 
 ```sh
-m365 pa environment get
+m365 pa environment get --default
 ```
 
 Get information about the Power Apps environment with the specified name.

package/docs/docs/cmd/pp/copilot/copilot-get.mdx

@@ -12,12 +12,6 @@ Get information about the specified copilot
 m365 pp copilot get [options]
 ```
 
-## Alias
-
-```sh
-m365 pp chatbot get [options]
-```
-
 ## Options
 
 ```md definition-list