@pnp/cli-microsoft365 7.8.0-beta.5ca5055 → 7.8.0-beta.a83837a

package/dist/utils/urlUtil.js

@@ -197,6 +197,14 @@ export const urlUtil = {
             const rootUrl = new URL(fullUrl);
             return rootUrl.origin;
         }
+    },
+    /**
+     * Removes trailing slashes from the URL.
+     * @param url The URL to process.
+     * @returns The URL without trailing slashes.
+     */
+    removeTrailingSlashes(url) {
+        return url.replace(/\/+$/, '');
     }
 };
 //# sourceMappingURL=urlUtil.js.map

package/dist/utils/validation.js

@@ -1,6 +1,8 @@
 export const validation = {
-    isValidGuidArray(guids) {
-        return guids.every(guid => this.isValidGuid(guid));
+    isValidGuidArray(guidsString) {
+        const guids = guidsString.split(',').map(guid => guid.trim());
+        const invalidGuids = guids.filter(guid => !this.isValidGuid(guid));
+        return invalidGuids.length > 0 ? invalidGuids.join(', ') : true;
     },
     isValidGuid(guid) {
         if (!guid) {
@@ -21,9 +23,10 @@ export const validation = {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+(@thread\.v2|@unq\.gbl\.spaces)$/i);
         return guidRegEx.test(guid);
     },
-    isValidUserPrincipalNameArray(upns) {
-        const invalidGuid = upns.find(upn => !this.isValidUserPrincipalName(upn));
-        return invalidGuid || true;
+    isValidUserPrincipalNameArray(upnsString) {
+        const upns = upnsString.split(',').map(upn => upn.trim());
+        const invalidUPNs = upns.filter(upn => !this.isValidUserPrincipalName(upn));
+        return invalidUPNs.length > 0 ? invalidUPNs.join(', ') : true;
     },
     isValidUserPrincipalName(upn) {
         const upnRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/i);

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

@@ -23,10 +23,13 @@ m365 entra appregistration permission add [options]
 
 ```md definition-list
 `-i, --appId [appId]`
-: Client ID of the Microsoft Entra app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+: Client ID of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
+
+`-n, --appName [appName]`
+: Display name of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `--appObjectId [appObjectId]`
-: Object ID of the Microsoft Entra app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+: Object ID of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `-a, --applicationPermissions [applicationPermissions]`
 : Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
@@ -58,10 +61,10 @@ Grant multiple delegated API permissions to a Microsoft Entra app specified by o
 m365 entra app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
 ```
 
-Grant multiple app-only permissions to a Microsoft Entra app specified by client id and grant admin consent.
+Grant multiple app-only permissions to a Microsoft Entra app specified by app display name 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' --grantAdminConsent
+m365 entra app permission add --appName 'Contoso App' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grantAdminConsent
 ```
 
 ## Response

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

@@ -22,10 +22,13 @@ m365 aad app permission list [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.
+: Client ID of the Entra application registration to retrieve the permissions for. Specify either `appId`, `appName` or `appObjectId`.
+
+`-n, --appName [appName]`
+: Display name of the Entra application registration to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `--appObjectId [appObjectId]`
-: Object ID of the Application Registration to retrieve the permissions for. Specify `appId` or `appObjectId` but not both.
+: Object ID of the Entra application registration to retrieve the permissions for. Specify either `appId`, `appName` or `appObjectId`.
 
 `--type [type]`
 : The type of permissions to retrieve. Allowed values: `delegated`, `application`, `all`. Defaults to `all`.
@@ -39,16 +42,22 @@ For best performance use the `objectId` option to reference the Entra applicatio
 
 ## Examples
 
-Retrieves all permissions for an Entra app registration
+Retrieves all permissions for an Entra application registration specified by client id.
 
 ```sh
 m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690'
 ```
 
-Retrieves all delegated permissions for an Entra app registration
+Retrieves all permissions for an Entra application registration by specified by app display name.
+
+```sh
+m365 entra app permission list --appName 'Contoso App'
+```
+
+Retrieves all delegated permissions for an Entra application registration specified by object id.
 
 ```sh
-m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --type delegated
+m365 entra app permission list --appObjectId '64381cda-d40d-4fb0-bce2-bece391546a2' --type delegated
 ```
 
 ## Response

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

@@ -22,37 +22,37 @@ m365 aad m365group add [options]
 
 ```md definition-list
 `-n, --displayName <displayName>`
-: Display name for the Microsoft 365 Group
-
-`-d, --description <description>`
-: Description for the Microsoft 365 Group
+: Display name for the Microsoft 365 Group.
 
 `-m, --mailNickname <mailNickname>`
-: Name to use in the group e-mail (part before the `@`)
+: Name to use in the group e-mail (part before the `@`).
+
+`-d, --description [description]`
+: Description for the Microsoft 365 Group.
 
 `--owners [owners]`
-: Comma-separated list of Microsoft 365 Group owners
+: Comma-separated list of Microsoft 365 Group owners.
 
 `--members [members]`
-: Comma-separated list of Microsoft 365 Group members
+: Comma-separated list of Microsoft 365 Group members.
 
 `--visibility [visibility]`
 : Specifies the group join policy and group content visibility for groups. Allowed values: `Private`, `Public`, or `HiddenMembership`. Defaults to `Public`.
 
 `--allowMembersToPost [allowMembersToPost]`
-: Set if only group members should be able to post conversations to the group
+: Set if only group members should be able to post conversations to the group.
 
 `--hideGroupInOutlook [hideGroupInOutlook]`
-: Set to hide the group in Outlook experiences
+: Set to hide the group in Outlook experiences.
 
 `--subscribeNewGroupMembers [subscribeNewGroupMembers]`
-: Set to subscribe all new group members to receive group conversation emails when new messages are posted in the group
+: Set to subscribe all new group members to receive group conversation emails when new messages are posted in the group.
 
 `--welcomeEmailDisabled [welcomeEmailDisabled]`
-: Set to not send welcome emails to new group members
+: Set to not send welcome emails to new group members.
 
 `-l, --logoPath [logoPath]`
-: Local path to the image file to use as group logo
+: Local path to the image file to use as group logo.
 ```
 
 <Global />
@@ -74,25 +74,25 @@ HiddenMembership | Owner permission is needed to join the group. Guest users can
 
 ## Examples
 
-Create a public Microsoft 365 Group
+Create a public Microsoft 365 Group.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance
+m365 entra m365group add --displayName Finance --mailNickname finance
 ```
 
-Create a private Microsoft 365 Group
+Create a private Microsoft 365 Group.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --visibility Private
+m365 entra m365group add --displayName Finance --mailNickname finance --visibility Private
 ```
 
-Create a public Microsoft 365 Group and set specified users as its owners
+Create a public Microsoft 365 Group with description and set specified users as its owners.
 
 ```sh
 m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
-Create a public Microsoft 365 Group and set specified users as its members
+Create a public Microsoft 365 Group with description and set specified users as its members.
 
 ```sh
 m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
@@ -101,31 +101,31 @@ m365 entra m365group add --displayName Finance --description "This is the Contos
 Create a public Microsoft 365 Group and allow only group members to be able to post conversations to the group.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --allowMembersToPost
+m365 entra m365group add --displayName Finance --mailNickname finance --allowMembersToPost
 ```
 
 Create a public Microsoft 365 Group and hide it from the Outlook experiences (web and client).
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --hideGroupInOutlook
+m365 entra m365group add --displayName Finance --mailNickname finance --hideGroupInOutlook
 ```
 
 Create a public Microsoft 365 Group and subscribe all new group members to receive group conversation emails when new messages are posted in the group.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --subscribeNewGroupMembers
+m365 entra m365group add --displayName Finance --mailNickname finance --subscribeNewGroupMembers
 ```
 
 Create a public Microsoft 365 Group and set to not send welcome emails to new group members.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --welcomeEmailDisabled
+m365 entra m365group add --displayName Finance --mailNickname finance --welcomeEmailDisabled
 ```
 
-Create a public Microsoft 365 Group and set its logo
+Create a public Microsoft 365 Group and set its logo.
 
 ```sh
-m365 entra m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --logoPath images/logo.png
+m365 entra m365group add --displayName Finance --mailNickname finance --logoPath images/logo.png
 ```
 
 ## Response

package/docs/docs/cmd/outlook/message/message-list.mdx

@@ -20,28 +20,40 @@ m365 outlook message list [options]
 
 `--folderId [folderId]`
 : ID of the folder from which to list messages.
+
+`--startTime [startTime]`
+: Time indicating the inclusive start of a time range when the message was received. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
+`--endTime [endTime]`
+: Time indicating the exclusive end of a time range when the message was received. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
+`--userId [userId]`
+: The Microsoft Entra user ID. Specify either `userId` or `userName`, not both. This option is required when using application permissions.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId` or `userName`, not both. This option is required when using application permissions.
 ```
 
 <Global />
 
 ## Examples
 
-List all messages in the folder with the specified name.
+List all messages from a folder with the specified name received within a specific time frame.
 
 ```sh
-m365 outlook message list --folderName Archive
+m365 outlook message list --folderName Archive --startTime 2023-12-16T18:28:48.6964197Z --endTime 2024-02-01
 ```
 
-List all messages in the folder with the specified ID.
+List all messages from a specific folder of a user specified by ID.
 
 ```sh
-m365 outlook message list --folderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAFNAAA=
+m365 outlook message list --folderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAFNAAA= --userId 48d31887-5fad-4d73-a9f5-3c356e68a038
 ```
 
-List all messages in the folder with the specified well-known name.
+List all messages from a folder of a user specified by UPN.
 
 ```sh
-m365 outlook message list --folderName inbox
+m365 outlook message list --folderName inbox --userName john@contoso.com
 ```
 
 ## Response

package/docs/docs/cmd/spo/listitem/listitem-batch-remove.mdx

@@ -0,0 +1,70 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo listitem batch remove
+
+Removes items from a list in batch
+
+## Usage
+
+```sh
+m365 spo listitem batch remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the SharePoint site.
+
+`-l, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`-p, --filePath [filePath]`
+: The absolute or relative path to a flat CSV file containing the list items. Specify `filePath` or `ids`, but not both.
+
+`-i, --ids [ids]`
+: Comma separated list of list item IDs. Specify `filePath` or `ids`, but not both.
+
+`-r, --recycle`
+: Recycle the list items. Otherwise, they will be permanently deleted.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+A sample CSV can be found below. The first line of the CSV-file should contain the internal column name of the ID-column.
+
+```csv
+ID
+123
+234
+345
+```
+
+## Examples
+
+Remove a list of IDs from a list with a csv
+
+```sh	
+m365 spo listitem batch remove --filePath ./IDlist.csv --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List"
+```
+
+Remove a list of IDs from a list by specifying the IDs
+
+```sh
+m365 spo listitem batch remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --ids "123,234,345"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-remove.mdx

@@ -14,63 +14,53 @@ m365 spo site remove [options]
 
 ```md definition-list
 `-u, --url <url>`
-: URL of the site to remove
+: URL of the site.
 
 `--skipRecycleBin`
-: Set to directly remove the site without moving it to the Recycle Bin
+: Set to directly remove the site without moving it to the recycle bin.
 
 `--fromRecycleBin`
-: Set to remove the site from the Recycle Bin
+: Set to remove the site from the recycle bin.
 
 `--wait`
-: Wait for the site to be removed before completing the command
+: (deprecated) Wait for the site to be removed before completing the command.
 
 `-f, --force`
-: Don't prompt for confirming removing the site
+: Don't prompt for confirmation.
 ```
 
 <Global />
 
 ## Remarks
 
-Deleting a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully deleted, you should use the `--wait` flag. When using this flag, the `spo site remove` command will keep running until it received confirmation from Microsoft 365 that the site has been fully deleted.
-
-If the site which you have selected to remove is groupified (Modern Team Site) and group exists, flags `--skipRecycleBin` and `--wait` will not be applicable. If the linked group still exists in the deleted groups, the site won't be removed. If the linked group is permanently deleted, the site will be removed like any classic site (except that flag `--wait` only will still not be applicable).
-
 If the argument `--fromRecycleBin` is passed, the selected site will be permanently removed even if it's a groupified one.
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be a Global or SharePoint administrator.
 
 :::
 
 ## Examples
 
-Remove the specified site and place it in the Recycle Bin
+Remove the specified site and place it in the recycle bin.
 
 ```sh
 m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite
 ```
 
-Remove the site without moving it to the Recycle Bin
+Remove the site without moving it to the recycle bin.
 
 ```sh
 m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --skipRecycleBin
 ```
 
-Remove the previously deleted site from the Recycle Bin
+Remove the previously deleted site from the recycle bin.
 
 ```sh
 m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --fromRecycleBin
 ```
 
-Remove the site without moving it to the Recycle Bin and wait for completion
-
-```sh
-m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --wait --skipRecycleBin
-```
-
 ## Response
 
 The command won't return a response on success.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.8.0-beta.5ca5055",
+  "version": "7.8.0-beta.a83837a",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",