@pnp/cli-microsoft365 11.0.0-beta.1f852eb → 11.0.0-beta.3655c37

package/dist/m365/spo/commands/homesite/homesite-remove.js

@@ -3,7 +3,6 @@ import { zod } from '../../../../utils/zod.js';
 import { globalOptionsZod } from '../../../../Command.js';
 import { validation } from '../../../../utils/validation.js';
 import { cli } from '../../../../cli/cli.js';
-import config from '../../../../config.js';
 import request from '../../../../request.js';
 import { spo } from '../../../../utils/spo.js';
 import SpoCommand from '../../../base/SpoCommand.js';
@@ -13,7 +12,7 @@ const options = globalOptionsZod
     url: zod.alias('u', z.string()
         .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
         message: `'${url}' is not a valid SharePoint Online site URL.`
-    })).optional()),
+    }))),
     force: zod.alias('f', z.boolean().optional())
 })
     .strict();
@@ -30,34 +29,8 @@ class SpoHomeSiteRemoveCommand extends SpoCommand {
     async commandAction(logger, args) {
         const removeHomeSite = async () => {
             try {
-                if (this.verbose) {
-                    await logger.logToStderr(`Removing ${args.options.url ? `'${args.options.url}' as home site` : 'the current home site'}...`);
-                }
                 const spoAdminUrl = await spo.getSpoAdminUrl(logger, this.debug);
-                const reqDigest = await spo.getRequestDigest(spoAdminUrl);
-                if (args.options.url) {
-                    await this.removeHomeSiteByUrl(args.options.url, spoAdminUrl, logger);
-                    await logger.log(`${args.options.url} has been removed as a Home Site. It may take some time for the change to apply. Check aka.ms/homesites for details.`);
-                }
-                else {
-                    await this.warn(logger, `The current way this command works is deprecated and will change in the next major release. The '--url' option will become required.`);
-                    const requestOptions = {
-                        url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
-                        headers: {
-                            'X-RequestDigest': reqDigest.FormDigestValue
-                        },
-                        data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="28" ObjectPathId="27" /><Method Name="RemoveSPHSite" Id="29" ObjectPathId="27" /></Actions><ObjectPaths><Constructor Id="27" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /></ObjectPaths></Request>`
-                    };
-                    const res = await request.post(requestOptions);
-                    const json = JSON.parse(res);
-                    const response = json[0];
-                    if (response.ErrorInfo) {
-                        throw response.ErrorInfo.ErrorMessage;
-                    }
-                    else {
-                        await logger.log(json[json.length - 1]);
-                    }
-                }
+                await this.removeHomeSiteByUrl(args.options.url, spoAdminUrl, logger);
             }
             catch (err) {
                 this.handleRejectedODataJsonPromise(err);
@@ -67,11 +40,7 @@ class SpoHomeSiteRemoveCommand extends SpoCommand {
             await removeHomeSite();
         }
         else {
-            const result = await cli.promptForConfirmation({
-                message: args.options.url
-                    ? `Are you sure you want to remove '${args.options.url}' as home site?`
-                    : `Are you sure you want to remove the current home site?`
-            });
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove '${args.options.url}' as home site?` });
             if (result) {
                 await removeHomeSite();
             }
@@ -79,6 +48,9 @@ class SpoHomeSiteRemoveCommand extends SpoCommand {
     }
     async removeHomeSiteByUrl(siteUrl, spoAdminUrl, logger) {
         const siteAdminProperties = await spo.getSiteAdminPropertiesByUrl(siteUrl, false, logger, this.verbose);
+        if (this.verbose) {
+            await logger.logToStderr(`Removing '${siteUrl}' as home site...`);
+        }
         const requestOptions = {
             url: `${spoAdminUrl}/_api/SPO.Tenant/RemoveTargetedSite`,
             headers: {

package/dist/m365/spo/commands/homesite/homesite-set.js

@@ -1,79 +1,123 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _SpoHomeSiteSetCommand_instances, _SpoHomeSiteSetCommand_initTelemetry, _SpoHomeSiteSetCommand_initOptions, _SpoHomeSiteSetCommand_initValidators, _SpoHomeSiteSetCommand_initTypes;
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import { spo } from '../../../../utils/spo.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import { entraGroup } from '../../../../utils/entraGroup.js';
+const optionsSchema = globalOptionsZod
+    .extend({
+    url: zod.alias('u', z.string()
+        .refine((url) => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint Online site URL.`
+    }))),
+    vivaConnectionsDefaultStart: z.boolean().optional(),
+    draftMode: z.boolean().optional(),
+    audienceIds: z.string()
+        .refine(audiences => validation.isValidGuidArray(audiences) === true, audiences => ({
+        message: `The following GUIDs are invalid: ${validation.isValidGuidArray(audiences)}.`
+    })).optional(),
+    audienceNames: z.string().optional(),
+    targetedLicenseType: z.enum(['everyone', 'frontLineWorkers', 'informationWorkers']).optional(),
+    order: z.number()
+        .refine(order => validation.isValidPositiveInteger(order) === true, order => ({
+        message: `'${order}' is not a positive integer.`
+    })).optional()
+});
 class SpoHomeSiteSetCommand extends SpoCommand {
     get name() {
         return commands.HOMESITE_SET;
     }
     get description() {
-        return 'Sets the specified site as the Home Site';
+        return 'Updates an existing SharePoint home site.';
     }
-    constructor() {
-        super();
-        _SpoHomeSiteSetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _SpoHomeSiteSetCommand_instances, "m", _SpoHomeSiteSetCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _SpoHomeSiteSetCommand_instances, "m", _SpoHomeSiteSetCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _SpoHomeSiteSetCommand_instances, "m", _SpoHomeSiteSetCommand_initValidators).call(this);
-        __classPrivateFieldGet(this, _SpoHomeSiteSetCommand_instances, "m", _SpoHomeSiteSetCommand_initTypes).call(this);
+    get schema() {
+        return optionsSchema;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine((options) => [options.audienceIds, options.audienceNames].filter(o => o !== undefined).length <= 1, {
+            message: 'You must specify either audienceIds or audienceNames but not both.'
+        })
+            .refine((options) => options.vivaConnectionsDefaultStart !== undefined ||
+            options.draftMode !== undefined ||
+            options.audienceIds !== undefined ||
+            options.audienceNames !== undefined ||
+            options.targetedLicenseType !== undefined ||
+            options.order !== undefined, {
+            message: 'You must specify at least one option to configure.'
+        });
     }
     async commandAction(logger, args) {
         try {
             if (this.verbose) {
-                await logger.logToStderr(`Setting the SharePoint home site to: ${args.options.siteUrl}...`);
-                await logger.logToStderr('Attempting to retrieve the SharePoint admin URL.');
+                await logger.logToStderr(`Configuring SharePoint home site: ${args.options.url}...`);
+                await logger.logToStderr(`Attempting to retrieve the SharePoint admin URL.`);
             }
             const spoAdminUrl = await spo.getSpoAdminUrl(logger, this.debug);
+            const configuration = {};
+            if (args.options.vivaConnectionsDefaultStart !== undefined) {
+                configuration.IsVivaConnectionsDefaultStartPresent = true;
+                configuration.vivaConnectionsDefaultStart = args.options.vivaConnectionsDefaultStart;
+            }
+            if (args.options.draftMode !== undefined) {
+                configuration.IsInDraftModePresent = true;
+                configuration.isInDraftMode = args.options.draftMode;
+            }
+            if (args.options.audienceIds !== undefined) {
+                configuration.IsAudiencesPresent = true;
+                configuration.Audiences = args.options.audienceIds.split(',').map(id => id.trim());
+            }
+            if (args.options.audienceNames !== undefined) {
+                configuration.IsAudiencesPresent = true;
+                configuration.Audiences = args.options.audienceNames.trim() === '' ? [] : await this.transformAudienceNamesToIds(args.options.audienceNames);
+            }
+            if (args.options.targetedLicenseType !== undefined) {
+                configuration.IsTargetedLicenseTypePresent = true;
+                configuration.TargetedLicenseType = this.convertTargetedLicenseTypeToNumber(args.options.targetedLicenseType);
+            }
+            if (args.options.order !== undefined) {
+                configuration.IsOrderPresent = true;
+                configuration.Order = args.options.order;
+            }
             const requestOptions = {
-                url: `${spoAdminUrl}/_api/SPO.Tenant`,
+                url: `${spoAdminUrl}/_api/SPO.Tenant/UpdateTargetedSite`,
                 headers: {
                     accept: 'application/json;odata=nometadata',
                     'content-Type': 'application/json'
                 },
                 responseType: 'json',
                 data: {
-                    sphSiteUrl: args.options.siteUrl
+                    siteUrl: args.options.url,
+                    configurationParam: configuration
                 }
             };
-            if (args.options.vivaConnectionsDefaultStart !== undefined) {
-                requestOptions.url += '/SetSPHSiteWithConfiguration';
-                requestOptions.data.configuration = { vivaConnectionsDefaultStart: args.options.vivaConnectionsDefaultStart };
-            }
-            else {
-                requestOptions.url += '/SetSPHSite';
-            }
             const res = await request.post(requestOptions);
-            await logger.log(res.value);
+            await logger.log(res);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    convertTargetedLicenseTypeToNumber(licenseType) {
+        const licenseTypeMap = {
+            'everyone': 0,
+            'frontLineWorkers': 1,
+            'informationWorkers': 2
+        };
+        return licenseTypeMap[licenseType];
+    }
+    async transformAudienceNamesToIds(audienceNames) {
+        const names = audienceNames.split(',');
+        const ids = [];
+        for (const name of names) {
+            const id = await entraGroup.getGroupIdByDisplayName(name.trim());
+            ids.push(id);
+        }
+        return ids;
+    }
 }
-_SpoHomeSiteSetCommand_instances = new WeakSet(), _SpoHomeSiteSetCommand_initTelemetry = function _SpoHomeSiteSetCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            vivaConnectionsDefaultStart: typeof args.options.vivaConnectionsDefaultStart !== 'undefined'
-        });
-    });
-}, _SpoHomeSiteSetCommand_initOptions = function _SpoHomeSiteSetCommand_initOptions() {
-    this.options.unshift({
-        option: '-u, --siteUrl <siteUrl>'
-    }, {
-        option: '--vivaConnectionsDefaultStart [vivaConnectionsDefaultStart]',
-        autocomplete: ['true', 'false']
-    });
-}, _SpoHomeSiteSetCommand_initValidators = function _SpoHomeSiteSetCommand_initValidators() {
-    this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.siteUrl));
-}, _SpoHomeSiteSetCommand_initTypes = function _SpoHomeSiteSetCommand_initTypes() {
-    this.types.boolean.push('vivaConnectionsDefaultStart');
-};
 export default new SpoHomeSiteSetCommand();
 //# sourceMappingURL=homesite-set.js.map

package/dist/m365/spo/commands/list/list-view-add.js

@@ -114,7 +114,7 @@ class SpoListViewAddCommand extends SpoCommand {
                         Query: args.options.viewQuery,
                         PersonalView: !!args.options.personal,
                         SetAsDefaultView: !!args.options.default,
-                        Paged: !!args.options.paged,
+                        Paged: args.options.paged ?? true,
                         RowLimit: args.options.rowLimit ?? 30,
                         CustomFormatter: args.options.customFormatter
                     }

package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-list.js

@@ -1,9 +1,11 @@
-import config from '../../../../config.js';
 import request from '../../../../request.js';
-import { spo } from '../../../../utils/spo.js';
-import SpoCommand from '../../../base/SpoCommand.js';
+import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
-class SpoServicePrincipalGrantListCommand extends SpoCommand {
+class SpoServicePrincipalGrantListCommand extends GraphCommand {
+    constructor() {
+        super(...arguments);
+        this.spoServicePrincipalDisplayName = 'SharePoint Online Web Client Extensibility';
+    }
     get name() {
         return commands.SERVICEPRINCIPAL_GRANT_LIST;
     }
@@ -15,36 +17,26 @@ class SpoServicePrincipalGrantListCommand extends SpoCommand {
     }
     async commandAction(logger) {
         try {
-            const spoAdminUrl = await spo.getSpoAdminUrl(logger, this.debug);
             if (this.verbose) {
-                await logger.logToStderr(`Retrieving request digest...`);
+                await logger.logToStderr(`Retrieving permissions granted to the service principal '${this.spoServicePrincipalDisplayName}'...`);
             }
-            const reqDigest = await spo.getRequestDigest(spoAdminUrl);
             const requestOptions = {
-                url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                url: `${this.resource}/v1.0/servicePrincipals?$filter=displayName eq '${this.spoServicePrincipalDisplayName}'&$select=id`,
                 headers: {
-                    'X-RequestDigest': reqDigest.FormDigestValue
+                    accept: 'application/json;odata.metadata=none'
                 },
-                data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="4" ObjectPathId="3" /><ObjectPath Id="6" ObjectPathId="5" /><Query Id="7" ObjectPathId="5"><Query SelectAllProperties="true"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties /></ChildItemQuery></Query></Actions><ObjectPaths><Constructor Id="3" TypeId="{104e8f06-1e00-4675-99c6-1b9b504ed8d8}" /><Property Id="5" ParentId="3" Name="PermissionGrants" /></ObjectPaths></Request>`
+                responseType: 'json'
             };
-            const res = await request.post(requestOptions);
-            const json = JSON.parse(res);
-            const response = json[0];
-            if (response.ErrorInfo) {
-                throw response.ErrorInfo.ErrorMessage;
-            }
-            else {
-                const result = json[json.length - 1]._Child_Items_;
-                await logger.log(result.map(r => {
-                    delete r._ObjectType_;
-                    delete r.ClientId;
-                    delete r.ConsentType;
-                    return r;
-                }));
+            const response = await request.get(requestOptions);
+            if (response.value.length === 0) {
+                throw `Service principal '${this.spoServicePrincipalDisplayName}' not found`;
             }
+            requestOptions.url = `${this.resource}/v1.0/servicePrincipals/${response.value[0].id}/oauth2PermissionGrants`;
+            const result = await request.get(requestOptions);
+            await logger.log(result.value);
         }
         catch (err) {
-            this.handleRejectedPromise(err);
+            this.handleRejectedODataJsonPromise(err);
         }
     }
 }

package/dist/m365/spo/commands.js

@@ -83,6 +83,7 @@ export default {
     FILE_SHARINGLINK_SET: `${prefix} file sharinglink set`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
+    FILE_VERSION_KEEP: `${prefix} file version keep`,
     FILE_VERSION_LIST: `${prefix} file version list`,
     FILE_VERSION_REMOVE: `${prefix} file version remove`,
     FILE_VERSION_RESTORE: `${prefix} file version restore`,
@@ -193,7 +194,6 @@ export default {
     LISTITEM_ROLEINHERITANCE_BREAK: `${prefix} listitem roleinheritance break`,
     LISTITEM_ROLEINHERITANCE_RESET: `${prefix} listitem roleinheritance reset`,
     LISTITEM_SET: `${prefix} listitem set`,
-    MAIL_SEND: `${prefix} mail send`,
     NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
     NAVIGATION_NODE_GET: `${prefix} navigation node get`,
     NAVIGATION_NODE_LIST: `${prefix} navigation node list`,
@@ -325,7 +325,6 @@ export default {
     TENANT_COMMANDSET_LIST: `${prefix} tenant commandset list`,
     TENANT_COMMANDSET_REMOVE: `${prefix} tenant commandset remove`,
     TENANT_COMMANDSET_SET: `${prefix} tenant commandset set`,
-    TENANT_HOMESITE_LIST: `${prefix} tenant homesite list`,
     TENANT_RECYCLEBINITEM_LIST: `${prefix} tenant recyclebinitem list`,
     TENANT_RECYCLEBINITEM_REMOVE: `${prefix} tenant recyclebinitem remove`,
     TENANT_RECYCLEBINITEM_RESTORE: `${prefix} tenant recyclebinitem restore`,

package/dist/m365/teams/commands/report/report-directroutingcalls.js

@@ -4,12 +4,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _TeamsReportDirectroutingcallsCommand_instances, _TeamsReportDirectroutingcallsCommand_initTelemetry, _TeamsReportDirectroutingcallsCommand_initOptions, _TeamsReportDirectroutingcallsCommand_initValidators;
-import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import GraphApplicationCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
-class TeamsReportDirectroutingcallsCommand extends GraphCommand {
+class TeamsReportDirectroutingcallsCommand extends GraphApplicationCommand {
     get allowedOutputs() {
         return ['json', 'csv'];
     }
@@ -31,16 +31,9 @@ class TeamsReportDirectroutingcallsCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         const toDateTimeParameter = formatting.encodeQueryParameter(args.options.toDateTime ? args.options.toDateTime : new Date().toISOString());
-        const requestOptions = {
-            url: `${this.resource}/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=${formatting.encodeQueryParameter(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
         try {
-            const res = await request.get(requestOptions);
-            await logger.log(res);
+            const response = await odata.getAllItems(`${this.resource}/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=${formatting.encodeQueryParameter(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`);
+            await logger.log(response);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);

package/dist/m365/teams/commands/report/report-pstncalls.js

@@ -4,12 +4,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _TeamsReportPstncallsCommand_instances, _TeamsReportPstncallsCommand_initTelemetry, _TeamsReportPstncallsCommand_initOptions, _TeamsReportPstncallsCommand_initValidators;
-import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import GraphApplicationCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
-class TeamsReportPstncallsCommand extends GraphCommand {
+class TeamsReportPstncallsCommand extends GraphApplicationCommand {
     get allowedOutputs() {
         return ['json', 'csv'];
     }
@@ -31,16 +31,9 @@ class TeamsReportPstncallsCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         const toDateTimeParameter = formatting.encodeQueryParameter(args.options.toDateTime ? args.options.toDateTime : new Date().toISOString());
-        const requestOptions = {
-            url: `${this.resource}/v1.0/communications/callRecords/getPstnCalls(fromDateTime=${formatting.encodeQueryParameter(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
         try {
-            const res = await request.get(requestOptions);
-            await logger.log(res);
+            const response = await odata.getAllItems(`${this.resource}/v1.0/communications/callRecords/getPstnCalls(fromDateTime=${formatting.encodeQueryParameter(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`);
+            await logger.log(response);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);

package/dist/m365/viva/commands.js

@@ -9,9 +9,6 @@ export default {
     ENGAGE_COMMUNITY_USER_ADD: `${prefix} engage community user add`,
     ENGAGE_COMMUNITY_USER_LIST: `${prefix} engage community user list`,
     ENGAGE_COMMUNITY_USER_REMOVE: `${prefix} engage community user remove`,
-    ENGAGE_GROUP_LIST: `${prefix} engage group list`,
-    ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,
-    ENGAGE_GROUP_USER_REMOVE: `${prefix} engage group user remove`,
     ENGAGE_MESSAGE_ADD: `${prefix} engage message add`,
     ENGAGE_MESSAGE_GET: `${prefix} engage message get`,
     ENGAGE_MESSAGE_LIKE_SET: `${prefix} engage message like set`,

package/dist/utils/entraAdministrativeUnit.js

@@ -19,7 +19,7 @@ export const entraAdministrativeUnit = {
             }
         }
         const queryString = queryParameters.length > 0
-            ? `?${queryParameters.join('&')}`
+            ? `&${queryParameters.join('&')}`
             : '';
         const graphResource = 'https://graph.microsoft.com';
         const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'${queryString}`);

package/dist/utils/entraApp.js

@@ -143,6 +143,21 @@ export const entraApp = {
                 redirectUris: options.redirectUris.split(',').map(u => u.trim())
             };
         }
+        if (options.platform === 'android') {
+            applicationInfo['publicClient'] = {
+                redirectUris: [
+                    `msauth://${options.bundleId}/${formatting.encodeQueryParameter(options.signatureHash)}`
+                ]
+            };
+        }
+        if (options.platform === 'apple') {
+            applicationInfo['publicClient'] = {
+                redirectUris: [
+                    `msauth://code/msauth.${options.bundleId}%3A%2F%2Fauth`,
+                    `msauth.${options.bundleId}://auth`
+                ]
+            };
+        }
         if (options.implicitFlow) {
             if (!applicationInfo.web) {
                 applicationInfo.web = {};

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

@@ -31,7 +31,7 @@ m365 entra appregistration add [options]
 : Comma-separated list of redirect URIs. Requires `platform` to be specified.
 
 `-p, --platform [platform]`
-: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`. Requires `redirectUris` to be specified.
+: Platform for which the app should be configured. Allowed values `spa`, `web`, `publicClient`, `apple`, `android`.
 
 `--implicitFlow`
 : Specify, to indicate that the authorization endpoint should return ID and access tokens.
@@ -75,6 +75,12 @@ m365 entra appregistration add [options]
 `--manifest [manifest]`
 : App manifest as retrieved from Entra ID to create the app registration from. Specify either `name` or `manifest` but not both.
 
+`--bundleId [bundleId]`
+: Specify a bundle Id to add the iOS / macOS or Android platform to the application. Required when platform is `apple` or `android`.
+
+`--signatureHash [signatureHash]`
+: A required hash when specifying a bundle Id and platform `android`.
+
 `--save`
 : Use to store the information about the created app in a local file.
 

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

@@ -0,0 +1,163 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roleassignment add
+
+Assign a Entra ID role to a user and specify the scope for which the user has been granted access
+
+## Usage
+
+```sh
+m365 entra roleassignment add [options]
+```
+
+## Options
+
+```md definition-list
+`--roleDefinitionId [roleDefinitionId]`
+: Id of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--roleDefinitionName [roleDefinitionName]`
+: Name of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--principal <principal>`
+: Id of a user, group or service principal or user principal name or group mail nickname to which the assignment is granted.
+
+`--userId [userId]`
+: Id of a user to which the assignment is scoped.
+
+`--userName [userName]`
+: User principal name of a user to which the assignment is scoped.
+
+`--administrativeUnitId [administrativeUnitId]`
+: Id of an administrative unit to which the assignment is scoped.
+
+`--administrativeUnitName [administrativeUnitName]`
+: Name of an administrative unit to which the assignment is scoped.
+
+`--applicationId [applicationId]`
+: Id of an application to which the assignment is scoped.
+
+`applicationObjectId [applicationObjectId]`
+: Object Id of an application to which the assignment is scoped.
+
+`--applicationName [applicationName]`
+: Name of an application to which the assignment is scoped.
+
+`--servicePrincipalId [servicePrincipalId]`
+: Id of a service principal to which the assignment is scoped.
+
+`--servicePrincipalName [servicePrincipalName]`
+: Name of a service principal to which the assignment is scoped.
+
+`--groupId [groupId]`
+: Id of a group to which the assignment is scoped.
+
+`--groupName [groupName]`
+: Name of a group to which the assignment is scoped.
+```
+
+<Global />
+
+## 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 specified by name to a user specified by id and scope the assignment to the whole tenant
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'SharePoint Administrator' --principal 7a2ca997-9461-402e-9882-58088a370889
+```
+
+Assign a role specified by id to a user specified by UPN and scope the assignment to a service principal specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionId 777b752-f9b7-4205-a2b1-5db0d6a0ccfc --principal john.doe@contoso.com --servicePrincipalId a4738dd8-fc0f-4646-87fb-47539f5c651b
+```
+
+Assign a role specified by name to a group specified by mail nickname and scope the assignment to an administrative unit specified by name
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'User Administrator' --principal 'contoso-group' --administrativeUnitName 'Marketing'
+```
+
+Assign a role specified by name to a service principal specified by id and scope the assignment to an application specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'Application Administrator' --principal ab2ca997-9461-402e-9882-58088a370889 --applicationId 47539fd8-fc0f-4646-87fb-a4738d5c651b
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1",
+    "principalId": "3844129d-f748-4c03-8165-4412ee9b4ceb",
+    "directoryScopeId": "/",
+    "roleDefinitionId": "92b086b3-e367-4ef2-b869-1de128fb986e"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryScopeId: /
+  id              : s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId     : 3844129d-f748-4c03-8165-4412ee9b4ceb
+  roleDefinitionId: 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,directoryScopeId,roleDefinitionId
+  s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1,3844129d-f748-4c03-8165-4412ee9b4ceb,/,92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roleassignment add --roleDefinitionId "92b086b3-e367-4ef2-b869-1de128fb986e" --principal "3844129d-f748-4c03-8165-4412ee9b4ceb"
+
+  Date: 7/3/2025
+
+  ## s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+
+  Property | Value
+  ---------|-------
+  id | s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId | 3844129d-f748-4c03-8165-4412ee9b4ceb
+  directoryScopeId | /
+  roleDefinitionId | 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/api/rbacapplication-post-roleassignments