@pnp/cli-microsoft365 11.1.0-beta.8311bbf → 11.1.0-beta.871ff4d

package/dist/m365/spo/commands/web/web-alert-remove.js

@@ -0,0 +1,59 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import { validation } from '../../../../utils/validation.js';
+import { formatting } from '../../../../utils/formatting.js';
+import request from '../../../../request.js';
+import { cli } from '../../../../cli/cli.js';
+const options = globalOptionsZod
+    .extend({
+    webUrl: zod.alias('u', z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint URL.`
+    }))),
+    id: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })),
+    force: zod.alias('f', z.boolean().optional())
+})
+    .strict();
+class SpoWebAlertRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.WEB_ALERT_REMOVE;
+    }
+    get description() {
+        return 'Removes an alert from a SharePoint list';
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        if (!args.options.force) {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove the alert with id '${args.options.id}' from site '${args.options.webUrl}'?` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Removing alert with ID '${args.options.id}' from site '${args.options.webUrl}'...`);
+            }
+            const requestOptions = {
+                url: `${args.options.webUrl}/_api/web/Alerts/DeleteAlert('${formatting.encodeQueryParameter(args.options.id)}')`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            await request.delete(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoWebAlertRemoveCommand();
+//# sourceMappingURL=web-alert-remove.js.map

package/dist/m365/spo/commands/web/web-reindex.js

@@ -67,24 +67,19 @@ class SpoWebReindexCommand extends SpoCommand {
         }
     }
     async reindexLists(webUrl, requestDigest, logger, webIdentityResp) {
-        try {
-            if (this.debug) {
-                await logger.logToStderr(`Retrieving information about lists...`);
-            }
-            const requestOptions = {
-                url: `${webUrl}/_api/web/lists?$select=NoCrawl,Title,RootFolder/Properties,RootFolder/ServerRelativeUrl&$expand=RootFolder/Properties`,
-                headers: {
-                    'accept': 'application/json;odata=nometadata'
-                },
-                responseType: 'json'
-            };
-            const lists = await request.get(requestOptions);
-            const promises = lists.value.map(l => this.reindexList(l, webUrl, requestDigest, webIdentityResp, logger));
-            await Promise.all(promises);
-        }
-        catch (err) {
-            throw err;
+        if (this.debug) {
+            await logger.logToStderr(`Retrieving information about lists...`);
         }
+        const requestOptions = {
+            url: `${webUrl}/_api/web/lists?$select=NoCrawl,Title,RootFolder/Properties,RootFolder/ServerRelativeUrl&$expand=RootFolder/Properties`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const lists = await request.get(requestOptions);
+        const promises = lists.value.map(l => this.reindexList(l, webUrl, requestDigest, webIdentityResp, logger));
+        await Promise.all(promises);
     }
     async reindexList(list, webUrl, requestDigest, webIdentityResp, logger) {
         if (list.NoCrawl) {
@@ -93,16 +88,11 @@ class SpoWebReindexCommand extends SpoCommand {
             }
             return;
         }
-        try {
-            const folderIdentityResp = await spo.getFolderIdentity(webIdentityResp.objectIdentity, webUrl, list.RootFolder.ServerRelativeUrl, requestDigest);
-            let searchversion = list.RootFolder.Properties.vti_x005f_searchversion || 0;
-            searchversion++;
-            await SpoPropertyBagBaseCommand.setProperty('vti_searchversion', searchversion.toString(), webUrl, requestDigest, folderIdentityResp, logger, this.debug, list.RootFolder.ServerRelativeUrl);
-            return;
-        }
-        catch (err) {
-            throw (err);
-        }
+        const folderIdentityResp = await spo.getFolderIdentity(webIdentityResp.objectIdentity, webUrl, list.RootFolder.ServerRelativeUrl, requestDigest);
+        let searchversion = list.RootFolder.Properties.vti_x005f_searchversion || 0;
+        searchversion++;
+        await SpoPropertyBagBaseCommand.setProperty('vti_searchversion', searchversion.toString(), webUrl, requestDigest, folderIdentityResp, logger, this.debug, list.RootFolder.ServerRelativeUrl);
+        return;
     }
 }
 _SpoWebReindexCommand_instances = new WeakSet(), _SpoWebReindexCommand_initOptions = function _SpoWebReindexCommand_initOptions() {

package/dist/m365/spo/commands.js

@@ -355,6 +355,8 @@ export default {
     USERPROFILE_GET: `${prefix} userprofile get`,
     USERPROFILE_SET: `${prefix} userprofile set`,
     WEB_ADD: `${prefix} web add`,
+    WEB_ALERT_LIST: `${prefix} web alert list`,
+    WEB_ALERT_REMOVE: `${prefix} web alert remove`,
     WEB_CLIENTSIDEWEBPART_LIST: `${prefix} web clientsidewebpart list`,
     WEB_GET: `${prefix} web get`,
     WEB_INSTALLEDLANGUAGE_LIST: `${prefix} web installedlanguage list`,

package/dist/m365/teams/commands/tab/tab-add.js

@@ -70,9 +70,15 @@ class TeamsTabAddCommand extends GraphCommand {
         if (options.contentUrl) {
             requestBody.configuration.contentUrl = options.contentUrl;
         }
-        options.entityId ? requestBody.configuration.entityId = options.entityId : null;
-        options.removeUrl ? requestBody.configuration.removeUrl = options.removeUrl : null;
-        options.websiteUrl ? requestBody.configuration.websiteUrl = options.websiteUrl : null;
+        if (options.entityId) {
+            requestBody.configuration.entityId = options.entityId;
+        }
+        if (options.removeUrl) {
+            requestBody.configuration.removeUrl = options.removeUrl;
+        }
+        if (options.websiteUrl) {
+            requestBody.configuration.websiteUrl = options.websiteUrl;
+        }
         Object.keys(options).forEach(key => {
             if (excludeOptions.indexOf(key) === -1) {
                 requestBody.configuration[key] = `${options[key]}`;

package/dist/m365/viva/commands/connections/connections-app-create.js

@@ -44,7 +44,7 @@ class VivaConnectionsAppCreateCommand extends AnonymousCommand {
             const appPortalUrl = `${args.options.portalUrl}${args.options.portalUrl.indexOf('?') > -1 ? '&' : '?'}app=portals`;
             let searchUrlPath = portalUrl.hostname;
             if (portalUrl.pathname.indexOf('/teams') > -1 || portalUrl.pathname.indexOf('/sites') > -1) {
-                const firstTwoUrlSegments = portalUrl.pathname.match(/^\/[^\/]+\/[^\/]+/);
+                const firstTwoUrlSegments = portalUrl.pathname.match(/^\/[^/]+\/[^/]+/);
                 if (firstTwoUrlSegments) {
                     searchUrlPath += firstTwoUrlSegments[0];
                 }

package/dist/m365/viva/commands/engage/engage-community-user-add.js

@@ -48,7 +48,7 @@ class VivaEngageCommunityUserAddCommand extends GraphCommand {
             .refine(options => options.ids || options.userNames, {
             message: 'Specify either of ids or userNames.'
         })
-            .refine(options => typeof options.userNames !== undefined && typeof options.ids !== undefined, {
+            .refine(options => options.userNames !== undefined || options.ids !== undefined, {
             message: 'Specify either ids or userNames, but not both.'
         });
     }

package/dist/m365/viva/commands/engage/engage-community-user-remove.js

@@ -48,7 +48,7 @@ class VivaEngageCommunityUserRemoveCommand extends GraphCommand {
             .refine(options => options.id || options.userName, {
             message: 'Specify either of id or userName.'
         })
-            .refine(options => typeof options.userName !== undefined && typeof options.id !== undefined, {
+            .refine(options => options.userName !== undefined || options.id !== undefined, {
             message: 'Specify either id or userName, but not both.'
         });
     }

package/dist/telemetry.js

@@ -21,7 +21,9 @@ async function trackTelemetry(object) {
         }
         await appInsights.flush();
     }
-    catch { }
+    catch {
+        // Do nothing
+    }
 }
 export const telemetry = {
     trackEvent: async (commandName, properties, exception) => {

package/dist/utils/accessToken.js

@@ -16,6 +16,7 @@ export const accessToken = {
             isAppOnlyAccessToken = token.idtyp === 'app';
         }
         catch {
+            // Do nothing
         }
         return isAppOnlyAccessToken;
     },
@@ -34,6 +35,7 @@ export const accessToken = {
             tenantId = token.tid;
         }
         catch {
+            // Do nothing
         }
         return tenantId;
     },
@@ -54,6 +56,7 @@ export const accessToken = {
             userName = token.upn || token.app_displayname;
         }
         catch {
+            // Do nothing
         }
         return userName;
     },
@@ -72,6 +75,7 @@ export const accessToken = {
             userId = token.oid;
         }
         catch {
+            // Do nothing
         }
         return userId;
     },

package/dist/utils/cache.js

@@ -28,7 +28,9 @@ export const cache = {
             // eslint-disable-next-line @typescript-eslint/no-empty-function
             fs.writeFile(cacheFilePath, value, () => { });
         }
-        catch { }
+        catch {
+            // Do nothing
+        }
     },
     clearExpired(cb) {
         // we don't need to wait for this to complete
@@ -58,7 +60,6 @@ export const cache = {
                     // remove files that haven't been accessed in the last 24 hours
                     if (stats.atime.getTime() < Date.now() - 24 * 60 * 60 * 1000) {
                         // we don't need to wait for the file to be deleted
-                        // eslint-disable-next-line @typescript-eslint/no-empty-function
                         fs.unlink(path.join(cacheFolderPath, file), () => {
                             if (cb && index === numFiles - 1) {
                                 cb();

package/dist/utils/customAppScope.js

@@ -16,7 +16,7 @@ export const customAppScope = {
         }
         const customAppScopes = await odata.getAllItems(url);
         if (customAppScopes.length === 0) {
-            throw `The specified custom application scope '${displayName}' does not exist.`;
+            throw new Error(`The specified custom application scope '${displayName}' does not exist.`);
         }
         if (customAppScopes.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', customAppScopes);

package/dist/utils/directoryExtension.js

@@ -16,7 +16,7 @@ export const directoryExtension = {
         }
         const extensionProperties = await odata.getAllItems(url);
         if (extensionProperties.length === 0) {
-            throw `The specified directory extension '${name}' does not exist.`;
+            throw new Error(`The specified directory extension '${name}' does not exist.`);
         }
         // there can be only one directory extension with a given name
         return extensionProperties[0];

package/dist/utils/entraAdministrativeUnit.js

@@ -24,7 +24,7 @@ export const entraAdministrativeUnit = {
         const graphResource = 'https://graph.microsoft.com';
         const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'${queryString}`);
         if (administrativeUnits.length === 0) {
-            throw `The specified administrative unit '${displayName}' does not exist.`;
+            throw new Error(`The specified administrative unit '${displayName}' does not exist.`);
         }
         if (administrativeUnits.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', administrativeUnits);

package/dist/utils/entraApp.js

@@ -305,7 +305,7 @@ export const entraApp = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `App with appId '${appId}' not found in Microsoft Entra ID`;
+            throw new Error(`App with appId '${appId}' not found in Microsoft Entra ID.`);
         }
         return apps[0];
     },
@@ -316,7 +316,7 @@ export const entraApp = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `App with name '${appName}' not found in Microsoft Entra ID`;
+            throw new Error(`App with name '${appName}' not found in Microsoft Entra ID.`);
         }
         if (apps.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);

package/dist/utils/entraDevice.js

@@ -12,7 +12,7 @@ export const entraDevice = {
     async getDeviceByDisplayName(displayName) {
         const devices = await odata.getAllItems(`${graphResource}/v1.0/devices?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
         if (devices.length === 0) {
-            throw `The specified device '${displayName}' does not exist.`;
+            throw new Error(`The specified device '${displayName}' does not exist.`);
         }
         if (devices.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', devices);

package/dist/utils/entraServicePrincipal.js

@@ -17,7 +17,7 @@ export const entraServicePrincipal = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `Service principal with appId '${appId}' not found in Microsoft Entra ID`;
+            throw new Error(`Service principal with appId '${appId}' not found in Microsoft Entra ID.`);
         }
         return apps[0];
     },
@@ -35,7 +35,7 @@ export const entraServicePrincipal = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `Service principal with name '${appName}' not found in Microsoft Entra ID`;
+            throw new Error(`Service principal with name '${appName}' not found in Microsoft Entra ID.`);
         }
         if (apps.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);

package/dist/utils/formatting.js

@@ -99,7 +99,7 @@ export const formatting = {
     },
     openTypesEncoder(value) {
         return value
-            .replace(/\%/g, '%25')
+            .replace(/%/g, '%25')
             .replace(/\./g, '%2E')
             .replace(/:/g, '%3A')
             .replace(/@/g, '%40')

package/dist/utils/md.js

@@ -32,7 +32,7 @@ function convertDd(md) {
     });
 }
 function convertHyperlinks(md) {
-    return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
+    return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^)]+)\)/gm, (match, label, url) => {
         // if the link is the same as the content, return just the link
         if (label === url) {
             return url;
@@ -54,7 +54,7 @@ function convertContentTabs(md) {
         .trim();
 }
 function convertCodeFences(md) {
-    const regex = new RegExp('^```.*?(?:\r?\n)(.*?)```(?:\r?\n)', 'gms');
+    const regex = /^```.*?(?:\r?\n)(.*?)```(?:\r?\n)/gms;
     return md.replace(regex, (match, code) => {
         return `${code.replace(/^(.+)$/gm, '  $1')}${EOL}`;
     });

package/dist/utils/odata.js

@@ -1,4 +1,6 @@
 import request from "../request.js";
+/* eslint-enable no-redeclare */
+// eslint-disable-next-line no-redeclare
 async function getAllItems(param1, metadata) {
     let items = [];
     const requestOptions = typeof param1 !== 'string' ? param1 : {

package/dist/utils/planner.js

@@ -22,7 +22,7 @@ export const planner = {
         try {
             return await request.get(requestOptions);
         }
-        catch (ex) {
+        catch {
             throw Error(`Planner plan with id '${id}' was not found.`);
         }
     },

package/dist/utils/powerPlatform.js

@@ -39,7 +39,7 @@ export const powerPlatform = {
             const response = await request.get(requestOptions);
             return response;
         }
-        catch (ex) {
+        catch {
             throw Error(`The specified Power Page website with id '${id}' does not exist.`);
         }
     },
@@ -97,7 +97,7 @@ export const powerPlatform = {
    */
     async getSolutionByName(dynamicsApiUrl, name) {
         const requestOptions = {
-            url: `${dynamicsApiUrl}/api/data/v9.0/solutions?$filter=isvisible eq true and uniquename eq \'${name}\'&$expand=publisherid($select=friendlyname)&$select=solutionid,uniquename,version,publisherid,installedon,solutionpackageversion,friendlyname,versionnumber&api-version=9.1`,
+            url: `${dynamicsApiUrl}/api/data/v9.0/solutions?$filter=isvisible eq true and uniquename eq '${name}'&$expand=publisherid($select=friendlyname)&$select=solutionid,uniquename,version,publisherid,installedon,solutionpackageversion,friendlyname,versionnumber&api-version=9.1`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

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.