@pnp/cli-microsoft365 11.1.0-beta.317d8bb → 11.1.0-beta.53bc672

package/dist/utils/spo.js

@@ -114,7 +114,7 @@ export const spo = {
         try {
             await auth.storeConnectionInfo();
         }
-        catch (e) {
+        catch {
             if (debug) {
                 await logger.logToStderr('Error while storing connection info');
             }
@@ -123,7 +123,7 @@ export const spo = {
     },
     async getSpoAdminUrl(logger, debug) {
         const spoUrl = await spo.getSpoUrl(logger, debug);
-        return (spoUrl.replace(/(https:\/\/)([^\.]+)(.*)/, '$1$2-admin$3'));
+        return (spoUrl.replace(/(https:\/\/)([^.]+)(.*)/, '$1$2-admin$3'));
     },
     async getTenantId(logger, debug) {
         if (auth.connection.spoTenantId) {
@@ -151,7 +151,7 @@ export const spo = {
         try {
             await auth.storeConnectionInfo();
         }
-        catch (e) {
+        catch {
             if (debug) {
                 await logger.logToStderr('Error while storing connection info');
             }
@@ -749,10 +749,7 @@ export const spo = {
                 }
             }
             else {
-                if (siteDesignId) {
-                    siteDesignId = siteDesignId;
-                }
-                else {
+                if (!siteDesignId) {
                     if (siteDesign) {
                         switch (siteDesign) {
                             case 'Topic':
@@ -1592,10 +1589,12 @@ export const spo = {
         const requestBody = {
             formValues: requestBodyOptions
         };
-        contentTypeName && requestBody.formValues.push({
-            FieldName: 'ContentType',
-            FieldValue: contentTypeName
-        });
+        if (contentTypeName) {
+            requestBody.formValues.push({
+                FieldName: 'ContentType',
+                FieldValue: contentTypeName
+            });
+        }
         const requestOptions = {
             url: `${absoluteListUrl}/items(${itemId})/ValidateUpdateListItem()`,
             headers: {

package/dist/utils/urlUtil.js

@@ -176,7 +176,7 @@ export const urlUtil = {
     getTargetSiteAbsoluteUrl(webUrl, url) {
         const fullUrl = url.startsWith('https://') ? url : urlUtil.getAbsoluteUrl(webUrl, url);
         // Pattern to match SharePoint URLs
-        const urlPattern = /https:\/\/[\w\-]+\.sharepoint\.com\/(teams|sites|personal)\/([\w\-]+)/;
+        const urlPattern = /https:\/\/[\w-]+\.sharepoint\.com\/(teams|sites|personal)\/([\w-]+)/;
         const match = fullUrl.match(urlPattern);
         if (match) {
             // If a match is found, return the matched URL

package/dist/utils/validation.js

@@ -309,7 +309,7 @@ export const validation = {
             return false;
         }
         const hasInvalidProperties = validThemeProperties.map((property) => {
-            return theme.hasOwnProperty(property);
+            return Object.prototype.hasOwnProperty.call(theme, property);
         }).includes(false);
         if (hasInvalidProperties) {
             return false;

package/dist/utils/vivaEngage.js

@@ -19,7 +19,7 @@ export const vivaEngage = {
         };
         const community = await request.get(requestOptions);
         if (!community) {
-            throw `The specified Viva Engage community with ID '${communityId}' does not exist.`;
+            throw new Error(`The specified Viva Engage community with ID '${communityId}' does not exist.`);
         }
         return community;
     },
@@ -32,7 +32,7 @@ export const vivaEngage = {
     async getCommunityByDisplayName(displayName, selectProperties) {
         const communities = await odata.getAllItems(`https://graph.microsoft.com/v1.0/employeeExperience/communities?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'&$select=${selectProperties.join(',')}`);
         if (communities.length === 0) {
-            throw `The specified Viva Engage community '${displayName}' does not exist.`;
+            throw new Error(`The specified Viva Engage community '${displayName}' does not exist.`);
         }
         if (communities.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', communities);
@@ -53,7 +53,7 @@ export const vivaEngage = {
         const communities = await odata.getAllItems(`https://graph.microsoft.com/v1.0/employeeExperience/communities?$select=${properties.join(',')}`);
         const filteredCommunity = communities.find(c => c.groupId === entraGroupId);
         if (!filteredCommunity) {
-            throw `The Microsoft Entra group with id '${entraGroupId}' is not associated with any Viva Engage community.`;
+            throw new Error(`The Microsoft Entra group with id '${entraGroupId}' is not associated with any Viva Engage community.`);
         }
         return filteredCommunity;
     },

package/docs/docs/cmd/booking/business/business-get.mdx

@@ -24,6 +24,24 @@ m365 booking business get [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | Bookings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                       |
+  |-----------------|-----------------------------------|
+  | Microsoft Graph | BookingsAppointment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve the specified Microsoft Bookings business with the specified id.
@@ -186,4 +204,3 @@ m365 booking business get --name 'business name'
   
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/booking/business/business-list.mdx

@@ -16,6 +16,24 @@ m365 booking business list [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | Bookings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                       |
+  |-----------------|-----------------------------------|
+  | Microsoft Graph | BookingsAppointment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns a list of all Microsoft Bookings businesses that are created for the tenant.
@@ -73,4 +91,3 @@ m365 booking business list
   
   </TabItem>
 </Tabs>
-

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

@@ -35,6 +35,25 @@ To use this command you must be either **Global Administrator** or **Privileged
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create an administrative unit with a specific display name

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

@@ -31,6 +31,25 @@ m365 entra administrativeunit get [options]
 
 Using the `--properties` option, you can specify a comma-separated list of administrative unit properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get information about the administrative unit by its id.

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

@@ -25,6 +25,25 @@ m365 entra administrativeunit list [options]
 
 Using the `--properties` option, you can specify a comma-separated list of administrative unit properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve a list of administrative units.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra administrativeunit member add
 
@@ -48,6 +50,25 @@ To use this command you must be either **Global Administrator** or **Privileged
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a single user specified by id to an administrative unit specified by id

package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-get.mdx

@@ -36,6 +36,25 @@ To get the member of a hidden membership in an administrative unit, the `Member.
 
 When the `properties` option includes values with a `/`, for example: `manager/displayName`, an additional `$expand` query parameter will be included on manager.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get information about a member specified by id from an administrative unit specified by id

package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-list.mdx

@@ -39,6 +39,25 @@ To list the members of a hidden membership in an administrative unit, the `Membe
 
 When the `properties` option includes values with a `/`, for example: `manager/displayName`, an additional `$expand` query parameter will be included on manager.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | AdministrativeUnit.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List members of an administrative unit specified by id

package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra administrativeunit member remove
 
@@ -54,6 +56,25 @@ To use this command you must be either **Global Administrator** or **Privileged
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a member specified by id from an administrative unit specified by id

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra administrativeunit remove
 
@@ -33,6 +35,25 @@ To use this command you must be either **Global Administrator** or **Privileged
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | AdministrativeUnit.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove an administrative unit by its id

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

@@ -44,6 +44,25 @@ To use this command you must be either **Global Administrator** or **Privileged
 
 :::
 
+## 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 definition specified by id to a user specified by id for an administrative unit specified by id

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

@@ -43,6 +43,24 @@ Autocomplete values for the `resource` option do not mean allowed values. The au
 
 This command can also be used to assign permissions to system or user-assigned managed identity.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                           |
+  |-----------------|-------------------------------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All, Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                           |
+  |-----------------|-------------------------------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All, Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds SharePoint _Sites.Read.All_ application permissions to Entra application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_

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

@@ -31,6 +31,24 @@ m365 entra approleassignment list [options]
 
 Specify either the `appId`, `appObjectId` or `appDisplayName`. If you specify more than one option value, the command will fail with an error.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List app roles assigned to service principal with Application (client) ID _b2307a39-e878-458b-bc90-03bc578531d6_.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra approleassignment remove
 
@@ -44,6 +46,24 @@ Autocomplete values for the `resource` option do not mean allowed values. The au
 
 This command can also be used to assign permissions to system- or user-assigned managed identity.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All |
+  
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Deletes SharePoint _Sites.Read.All_ application permissions from Entra application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_

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

@@ -59,6 +59,20 @@ Creates an enterprise application for a registered Entra app with the specified
 m365 entra enterpriseapp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
 ```
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+  </TabItem>
+  <TabItem value="Application">
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+  </TabItem>
+</Tabs>
+
 ## Response
 
 <Tabs>

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

@@ -57,6 +57,21 @@ Return details about the enterprise application with the specified ObjectId.
 m365 entra enterpriseapp get --objectId b2307a39-e878-458b-bc90-03bc578531dd
 ```
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+  </TabItem>
+  <TabItem value="Application">
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+  </TabItem>
+</Tabs>
+
 ## Response
 
 <Tabs>

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

@@ -44,6 +44,20 @@ Returns a list of all enterprise applications that comply with the specified dis
 m365 entra enterpriseapp list --displayName "My custom enterprise application" --tag "WindowsAzureActiveDirectoryIntegratedApp"
 ```
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+  </TabItem>
+  <TabItem value="Application">
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+  </TabItem>
+</Tabs>
+
 ## Response
 
 <Tabs>

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

@@ -56,6 +56,20 @@ Delete an enterprise application by object ID.
 m365 entra enterpriseapp remove --objectId b2307a39-e878-458b-bc90-03bc578531dd
 ```
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+  </TabItem>
+  <TabItem value="Application">
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+  </TabItem>
+</Tabs>
+
 ## Response
 
 The command won't return a response on success.

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

@@ -76,6 +76,24 @@ This command allows using unknown options. For a comprehensive list of group pro
 
 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.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Group.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Group.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a security group without any owners or members

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

@@ -31,6 +31,24 @@ m365 entra group get [options]
 
 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.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Group.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Group.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get information about an Entra Group by id.

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

@@ -28,6 +28,24 @@ m365 entra group list [options]
 
 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.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Group.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Group.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists all groups defined in Entra ID.