@pnp/cli-microsoft365 11.0.0 → 11.1.0-beta.111c36f

package/dist/utils/roleDefinition.js

@@ -17,7 +17,7 @@ export const roleDefinition = {
         }
         const roleDefinitions = await odata.getAllItems(url);
         if (roleDefinitions.length === 0) {
-            throw `The specified role definition '${displayName}' does not exist.`;
+            throw new Error(`The specified role definition '${displayName}' does not exist.`);
         }
         if (roleDefinitions.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', roleDefinitions);
@@ -61,7 +61,7 @@ export const roleDefinition = {
         }
         const roleDefinitions = await odata.getAllItems(url);
         if (roleDefinitions.length === 0) {
-            throw `The specified role definition '${displayName}' does not exist.`;
+            throw new Error(`The specified role definition '${displayName}' does not exist.`);
         }
         if (roleDefinitions.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', roleDefinitions);

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/app/app-add.mdx

@@ -120,6 +120,24 @@ If you want to store the information about the created Entra app registration, u
 
 When specifying `--grantAdminConsent` option, an enterprise application will be created for the app registration.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | Application.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create new Entra app registration with the specified name

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

@@ -49,6 +49,24 @@ If you want to store the information about the Entra app registration, use the `
 
 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.
 
+## 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
 
 Get the Entra application registration by its app (client) ID.
@@ -288,4 +306,4 @@ m365 entra app get --name "My app" --save
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

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

@@ -31,6 +31,24 @@ m365 entra appregistration list [options]
 
 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.
 
+## 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
 
 Retrieve a list of Entra app registrations.
@@ -202,4 +220,3 @@ m365 entra app list --properties "appId,displayName"
 
   </TabItem>
 </Tabs>
-

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra app remove
 
@@ -40,6 +42,24 @@ For best performance use the `objectId` option to reference the Entra applicatio
 
 If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | Application.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove the Entra application registration by its app (client) ID.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra app set
 
@@ -63,6 +65,24 @@ If the command finds multiple Entra application registrations with the specified
 
 When a certificate is specified it will be added to the list of certificates of the app without changing existing certificates.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | Application.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update the app URI of the Entra application registration specified by its object 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_