@pnp/cli-microsoft365 11.7.0-beta.293104a → 11.7.0-beta.71c58f3

package/dist/utils/spfx.js

@@ -1,3 +1,4 @@
+import { Range, coerce, gt, validRange } from 'semver';
 export const spfx = {
     isReactProject(project) {
         return (typeof project.yoRcJson !== 'undefined' &&
@@ -11,6 +12,64 @@ export const spfx = {
             typeof project.yoRcJson['@microsoft/generator-sharepoint'] !== 'undefined' &&
             project.yoRcJson["@microsoft/generator-sharepoint"].framework === 'knockout') ||
             typeof project.packageJson?.dependencies?.['knockout'] !== 'undefined';
+    },
+    getHighestNodeVersion(versionRange) {
+        if (!versionRange) {
+            throw new Error('Node version range was not provided.');
+        }
+        const ranges = versionRange
+            .split('||')
+            .map(range => range.trim())
+            .filter(range => range.length > 0);
+        let highestMajor = null;
+        let exactVersion = null;
+        const simpleVersionPattern = /^\d+(\.\d+(\.\d+)?)?$/;
+        if (ranges.every(r => simpleVersionPattern.test(r))) {
+            const highest = ranges.reduce((best, curr) => gt(coerce(curr), coerce(best)) ? curr : best);
+            const parts = highest.split('.');
+            if (parts.length >= 3) {
+                return highest;
+            }
+            if (parts.length === 2) {
+                return `${highest}.x`;
+            }
+        }
+        for (const rangeString of ranges) {
+            const normalized = validRange(rangeString);
+            if (!normalized) {
+                continue;
+            }
+            const rangeObj = new Range(normalized);
+            let maxMajor = 0;
+            // Analyze the range to find the maximum major version
+            for (const comparatorSet of rangeObj.set) {
+                for (const comparator of comparatorSet) {
+                    if (comparator.operator === '<') {
+                        // Exclusive upper bound: <17.0.0 means max major is 16
+                        maxMajor = Math.max(maxMajor, comparator.semver.major - 1);
+                    }
+                    else if (comparator.operator === '<=') {
+                        // Inclusive upper bound: <=17.0.0 means we can use exactly that version
+                        maxMajor = Math.max(maxMajor, comparator.semver.major);
+                        // Store the exact version for <= comparator
+                        if (highestMajor === null || comparator.semver.major > highestMajor) {
+                            exactVersion = comparator.semver.version;
+                        }
+                    }
+                    else if (comparator.operator === '>=' || comparator.operator === '>') {
+                        // For lower bounds use the major version
+                        maxMajor = Math.max(maxMajor, comparator.semver.major);
+                    }
+                }
+            }
+            // Track the highest major version across all ranges
+            highestMajor = Math.max(highestMajor ?? 0, maxMajor);
+        }
+        if (highestMajor === null) {
+            throw new Error(`Unable to resolve the highest Node version for range '${versionRange}'.`);
+        }
+        // Return exact version if we have a <= comparator, otherwise use .x
+        return exactVersion || `${highestMajor}.x`;
     }
 };
 //# sourceMappingURL=spfx.js.map

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

@@ -30,6 +30,25 @@ m365 entra user groupmembership list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                              |
+  |-----------------|------------------------------------------|
+  | Microsoft Graph | User.ReadBasic.All, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                              |
+  |-----------------|------------------------------------------|
+  | Microsoft Graph | User.ReadBasic.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieves groups that the user is a member of

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

@@ -39,6 +39,25 @@ m365 entra user guest add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | User.Invite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | User.Invite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Invite a user via email and set the display name.

package/docs/docs/cmd/entra/user/user-password-validate.mdx

@@ -29,6 +29,18 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | User.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Validate password _cli365P@ssW0rd_ against the organization's password validation policy.

package/docs/docs/cmd/entra/user/user-recyclebinitem-clear.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user recyclebinitem clear
 
@@ -33,6 +35,25 @@ After running this command, it may take a minute before all deleted users are ef
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes all users from the tenant recycle bin.

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

@@ -16,6 +16,25 @@ m365 entra user recyclebinitem list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions   |
+  |-----------------|---------------|
+  | Microsoft Graph | User.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions   |
+  |-----------------|---------------|
+  | Microsoft Graph | User.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all removed users.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user recyclebinitem remove
 
@@ -36,6 +38,25 @@ After running this command, it may take a minute before the deleted user is effe
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a specific user from the recycle bin.

package/docs/docs/cmd/entra/user/user-recyclebinitem-restore.mdx

@@ -35,6 +35,25 @@ After running this command, it may take a minute before the user will reappear i
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Restore user from the recycle bin.

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

@@ -77,6 +77,25 @@ When multiple values are specified for `--registeredMethods` option, the command
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve registration details for all users.

package/docs/docs/cmd/entra/user/user-session-revoke.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user session revoke
 
@@ -40,6 +42,25 @@ This API doesn't revoke sign-in sessions for external users, because external us
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | User.RevokeSessions.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | User.RevokeSessions.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Revoke sign-in sessions of a user specified by id

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

@@ -30,6 +30,25 @@ m365 entra user signin list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all user's sign-ins in your tenant.

package/docs/docs/cmd/exo/approleassignment/approleassignment-add.mdx

@@ -65,6 +65,25 @@ To use this command you must be at least **Privileged Role Administrator**.
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Exchange |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Exchange |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Assign a role specified by id to a service principal specified by id and scope the assignment to the whole tenant

package/docs/docs/cmd/file/convert/convert-pdf.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # file convert pdf
 
@@ -30,6 +32,25 @@ If you choose to store the converted file in a document library, CLI will store
 
 If the conversion process fails, CLI will attempt to clean up the temporary files (the source file uploaded to your tenant, if you're converting a local file to PDF, and the converted PDF file on your disk if you chose to upload the converted file to your tenant). If removing the temporary files fails, you will need to clean them up yourself. CLI will list the URL and/or path of the files to remove.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Converts local file to PDF and stores the converted file on the disk

package/docs/docs/cmd/file/file-add.mdx

@@ -1,4 +1,6 @@
 import Global from '../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # file add
 
@@ -31,6 +33,25 @@ The `folderUrl` must be an absolute URL to the document library where the file s
 
 By default, the `file add` command will automatically lookup the ID of the site where you want to upload the file based on the specified `folderUrl`. It will do this, by breaking the URL into chunks and incrementally calling Microsoft Graph to retrieve site information. This is necessary, because there is no other way looking at the URL to distinguish where the site URL ends and the document library URL starts. If you want to speed up uploading files, or you use resource-specific consent and your Microsoft Entra app only has access to the specific site, you can use the `siteUrl` option to specify the URL of the site yourself.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Uploads file from the current folder to the root folder of a document library in the root site collection

package/docs/docs/cmd/file/file-copy.mdx

@@ -1,4 +1,6 @@
 import Global from '../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # file copy
 
@@ -31,6 +33,25 @@ m365 file copy [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Sites.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Copy a file by server-relative URL to a document library in another site collection with server relative URL

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

@@ -31,6 +31,25 @@ m365 file list [options]
 
 This command is an improved version of the `spo file list` command. The main difference between the two commands is, that `file list` uses Microsoft Graph and properly supports retrieving files from large folders. Because `file list` uses Microsoft Graph and `spo file list` uses SharePoint REST APIs, the data returned by both commands is different.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | Files.Read, Sites.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | Files.Read.All, Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Return all files from the folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_

package/docs/docs/cmd/file/file-move.mdx

@@ -1,4 +1,6 @@
 import Global from '../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # file move
 
@@ -36,6 +38,25 @@ m365 file move [options]
 - If the source and target locations are within the same document library or drive, the command will utilize the Move DriveItem API, preserving the version history of the file.
 - If the source and target locations are in different document libraries or drives, the command will use a copy-and-delete combination to move the file. Please note that in this case, version history will not be retained.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Sites.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Move a file by server-relative URL to a folder in the same document library

package/docs/docs/cmd/outlook/calendargroup/calendargroup-set.mdx

@@ -0,0 +1,83 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendargroup set
+
+Updates a calendar group for a user.
+
+## Usage
+
+```sh
+m365 outlook calendargroup set [options]
+```
+
+## Options
+
+```md definition-list
+`--id [id]`
+: ID of the calendar group. Specify either `id` or `name`, but not both.
+
+`--name [name]`
+: Name of the calendar group. Specify either `id` or `name`, but not both.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--newName <newName>`
+: New name of the calendar group.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                            |
+  |-----------------|----------------------------------------|
+  | Microsoft Graph | Calendars.ReadWrite, Calendars.ReadWrite.Shared |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Calendars.ReadWrite  |
+
+  </TabItem>
+</Tabs>
+
+:::note
+
+When using delegated permissions, specifying `userId` or `userName` for a different user requires the `Calendars.ReadWrite.Shared` scope. When the specified user matches the signed-in user, no shared scope is needed.
+
+:::
+
+## Examples
+
+Update the calendar group specified by name for the current user.
+
+```sh
+m365 outlook calendargroup set --name "Personal Evts" --newName "Personal Events"
+```
+
+Update the calendar group specified by id for a user.
+
+```sh
+m365 outlook calendargroup set --id "AAMkADIxYjJiYm" --newName "Personal Events" --userId "44288f7d-7710-4293-8c8e-36f310ed2e6a"
+```
+
+Update the calendar group specified by name for a user specified by email.
+
+```sh
+m365 outlook calendargroup set --name "Personal Evts" --newName "Personal Events" --userName "john.doe@contoso.com"
+```
+
+## Response
+
+The command won't return a response on success.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "11.7.0-beta.293104a",
+  "version": "11.7.0-beta.71c58f3",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -253,6 +253,7 @@
     "van Brug, Herco <hercovanbrug@hotmail.com>",
     "Van de Voorde, Tim <tim.vdv1995@hotmail.com>",
     "van Dijk, Mark <mark@ichicraft.com>",
+    "Van Horn, Matt <mvanhorn@users.noreply.github.com>",
     "van Hunen, Erwin <erwin.van.hunen@outlook.com>",
     "van Iersel, Cas <cvaniersel@portiva.nl>",
     "van Rousselt, Rick <rick.vanrousselt@outlook.com>",