@pnp/cli-microsoft365 7.6.0-beta.480812d → 7.6.0-beta.79bc59c

package/dist/m365/base/PeriodBasedReport.js

@@ -8,6 +8,9 @@ import request from '../../request.js';
 import { formatting } from '../../utils/formatting.js';
 import GraphCommand from "./GraphCommand.js";
 class PeriodBasedReport extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     constructor() {
         super();
         _PeriodBasedReport_instances.add(this);

package/dist/m365/spfx/commands/project/project-github-workflow-add.js

@@ -33,6 +33,9 @@ class SpfxProjectGithubWorkflowAddCommand extends BaseProjectCommand {
         if (this.projectRootPath === null) {
             throw new CommandError(`Couldn't find project root folder`, _a.ERROR_NO_PROJECT_ROOT_FOLDER);
         }
+        if (!args.options.overwrite) {
+            await this.warn(logger, `We recommend always using the --overwrite option and it will become the default behavior in next major release. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.`);
+        }
         const solutionPackageJsonFile = path.join(this.projectRootPath, 'package.json');
         const packageJson = fs.readFileSync(solutionPackageJsonFile, 'utf-8');
         const solutionName = JSON.parse(packageJson).name;

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

@@ -10,6 +10,9 @@ import { validation } from '../../../../utils/validation.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TeamsReportDirectroutingcallsCommand extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     get name() {
         return commands.REPORT_DIRECTROUTINGCALLS;
     }

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

@@ -10,6 +10,9 @@ import { validation } from '../../../../utils/validation.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TeamsReportPstncallsCommand extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     get name() {
         return commands.REPORT_PSTNCALLS;
     }

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

@@ -3,12 +3,17 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _TeamsTeamAddCommand_instances, _TeamsTeamAddCommand_initTelemetry, _TeamsTeamAddCommand_initOptions, _TeamsTeamAddCommand_initOptionSets;
+var _TeamsTeamAddCommand_instances, _TeamsTeamAddCommand_initTelemetry, _TeamsTeamAddCommand_initOptions, _TeamsTeamAddCommand_initValidators, _TeamsTeamAddCommand_initOptionSets;
 import { setTimeout } from 'timers/promises';
 import request from '../../../../request.js';
 import { entraGroup } from '../../../../utils/entraGroup.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import auth from '../../../../Auth.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { formatting } from '../../../../utils/formatting.js';
 class TeamsTeamAddCommand extends GraphCommand {
     get name() {
         return commands.TEAM_ADD;
@@ -22,9 +27,14 @@ class TeamsTeamAddCommand extends GraphCommand {
         this.pollingInterval = 30000;
         __classPrivateFieldGet(this, _TeamsTeamAddCommand_instances, "m", _TeamsTeamAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _TeamsTeamAddCommand_instances, "m", _TeamsTeamAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsTeamAddCommand_instances, "m", _TeamsTeamAddCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _TeamsTeamAddCommand_instances, "m", _TeamsTeamAddCommand_initOptionSets).call(this);
     }
     async commandAction(logger, args) {
+        const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[this.resource].accessToken);
+        if (isAppOnlyAccessToken && !args.options.ownerUserNames && !args.options.ownerIds && !args.options.ownerEmails) {
+            this.handleError(`Specify at least 'ownerUserNames', 'ownerIds' or 'ownerEmails' when using application permissions.`);
+        }
         let requestBody;
         if (args.options.template) {
             if (this.verbose) {
@@ -54,6 +64,19 @@ class TeamsTeamAddCommand extends GraphCommand {
                 description: args.options.description
             };
         }
+        let members = [];
+        if (args.options.ownerEmails || args.options.ownerIds || args.options.ownerUserNames) {
+            await this.retrieveMembersToAdd(members, 'owner', args.options.ownerEmails, args.options.ownerIds, args.options.ownerUserNames);
+        }
+        if (args.options.memberEmails || args.options.memberIds || args.options.memberUserNames) {
+            await this.retrieveMembersToAdd(members, 'member', args.options.memberEmails, args.options.memberIds, args.options.memberUserNames);
+        }
+        // We filter out the first owner here and add it to the request body when we are using application only permissions. This is required or the Graph API will throw an error.
+        if (members.length > 0 && members.filter(y => y.roles.includes('owner')).length > 0 && isAppOnlyAccessToken) {
+            const groupOwner = members.filter(y => y.roles.includes('owner')).slice(0, 1);
+            members = members.filter(y => y !== groupOwner[0]);
+            requestBody.members = groupOwner;
+        }
         const requestOptionsPost = {
             url: `${this.resource}/v1.0/teams`,
             headers: {
@@ -72,12 +95,18 @@ class TeamsTeamAddCommand extends GraphCommand {
                 responseType: 'json'
             };
             const teamsAsyncOperation = await request.get(requestOptions);
-            if (!args.options.wait) {
+            if (!args.options.wait && members.length === 0) {
                 await logger.log(teamsAsyncOperation);
             }
             else {
                 await this.waitUntilTeamFinishedProvisioning(teamsAsyncOperation, requestOptions, logger);
                 const entraGroup = await this.getEntraGroup(teamsAsyncOperation.targetResourceId, logger);
+                if (members.length > 0) {
+                    if (this.verbose) {
+                        await logger.logToStderr('Adding members to the team...');
+                    }
+                    await this.addMembers(members, entraGroup.id);
+                }
                 await logger.log(entraGroup);
             }
         }
@@ -85,6 +114,19 @@ class TeamsTeamAddCommand extends GraphCommand {
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    async addMembers(members, groupId) {
+        for (const member of members) {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/teams/${groupId}/members`,
+                headers: {
+                    'content-type': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: member
+            };
+            await request.post(requestOptions);
+        }
+    }
     async waitUntilTeamFinishedProvisioning(teamsAsyncOperation, requestOptions, logger) {
         if (teamsAsyncOperation.status === 'succeeded') {
             if (this.verbose) {
@@ -118,6 +160,31 @@ class TeamsTeamAddCommand extends GraphCommand {
         }
         return group;
     }
+    async retrieveMembersToAdd(members, role, emails, ids, userNames) {
+        let itemsToProcess = [];
+        if (emails) {
+            itemsToProcess = await entraUser.getUserIdsByEmails(formatting.splitAndTrim(emails));
+        }
+        else if (ids) {
+            itemsToProcess = formatting.splitAndTrim(ids);
+        }
+        else if (userNames) {
+            itemsToProcess = await entraUser.getUserIdsByUpns(formatting.splitAndTrim(userNames));
+        }
+        itemsToProcess.map((item) => {
+            const member = members.find((y) => y['user@odata.bind'] === `https://graph.microsoft.com/v1.0/users('${item}')`);
+            if (!member) {
+                members.push({
+                    '@odata.type': '#microsoft.graph.aadUserConversationMember',
+                    'user@odata.bind': `https://graph.microsoft.com/v1.0/users('${item}')`,
+                    roles: [role]
+                });
+            }
+            else {
+                member.roles.push(role);
+            }
+        });
+    }
 }
 _TeamsTeamAddCommand_instances = new WeakSet(), _TeamsTeamAddCommand_initTelemetry = function _TeamsTeamAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
@@ -125,7 +192,13 @@ _TeamsTeamAddCommand_instances = new WeakSet(), _TeamsTeamAddCommand_initTelemet
             name: typeof args.options.name !== 'undefined',
             description: typeof args.options.description !== 'undefined',
             template: typeof args.options.template !== 'undefined',
-            wait: !!args.options.wait
+            wait: !!args.options.wait,
+            ownerUserNames: typeof args.options.ownerUserNames !== 'undefined',
+            ownerIds: typeof args.options.ownerIds !== 'undefined',
+            ownerEmails: typeof args.options.ownerEmails !== 'undefined',
+            memberUserNames: typeof args.options.memberUserNames !== 'undefined',
+            memberIds: typeof args.options.memberIds !== 'undefined',
+            memberEmails: typeof args.options.memberEmails !== 'undefined'
         });
     });
 }, _TeamsTeamAddCommand_initOptions = function _TeamsTeamAddCommand_initOptions() {
@@ -137,6 +210,52 @@ _TeamsTeamAddCommand_instances = new WeakSet(), _TeamsTeamAddCommand_initTelemet
         option: '--template [template]'
     }, {
         option: '--wait'
+    }, {
+        option: '--ownerUserNames [ownerUserNames]'
+    }, {
+        option: '--ownerIds [ownerIds]'
+    }, {
+        option: '--ownerEmails [ownerEmails]'
+    }, {
+        option: '--memberUserNames [memberUserNames]'
+    }, {
+        option: '--memberIds [memberIds]'
+    }, {
+        option: '--memberEmails [memberEmails]'
+    });
+}, _TeamsTeamAddCommand_initValidators = function _TeamsTeamAddCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.ownerUserNames) {
+            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.ownerUserNames));
+            if (isValidUserPrincipalNameArray !== true) {
+                return `Owner username '${isValidUserPrincipalNameArray}' is invalid for option 'ownerUserNames'.`;
+            }
+        }
+        if (args.options.ownerEmails) {
+            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.ownerEmails));
+            if (isValidUserPrincipalNameArray !== true) {
+                return `Owner email '${isValidUserPrincipalNameArray}' is invalid for option 'ownerEmails'.`;
+            }
+        }
+        if (args.options.ownerIds && !validation.isValidGuidArray(formatting.splitAndTrim(args.options.ownerIds))) {
+            return `The option 'ownerIds' contains one or more invalid GUIDs.`;
+        }
+        if (args.options.memberUserNames) {
+            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.memberUserNames));
+            if (isValidUserPrincipalNameArray !== true) {
+                return `Member username '${isValidUserPrincipalNameArray}' is invalid for option 'memberUserNames'.`;
+            }
+        }
+        if (args.options.memberEmails) {
+            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.memberEmails));
+            if (isValidUserPrincipalNameArray !== true) {
+                return `Member email '${isValidUserPrincipalNameArray}' is invalid for option 'memberEmails'.`;
+            }
+        }
+        if (args.options.memberIds && !validation.isValidGuidArray(formatting.splitAndTrim(args.options.memberIds))) {
+            return `The option 'memberIds' contains one or more invalid GUIDs`;
+        }
+        return true;
     });
 }, _TeamsTeamAddCommand_initOptionSets = function _TeamsTeamAddCommand_initOptionSets() {
     this.optionSets.push({
@@ -149,6 +268,16 @@ _TeamsTeamAddCommand_instances = new WeakSet(), _TeamsTeamAddCommand_initTelemet
         runsWhen: (args) => {
             return !args.options.template;
         }
+    }, {
+        options: ['ownerUserNames', 'ownerIds', 'ownerEmails'],
+        runsWhen: (args) => {
+            return args.options.ownerUserNames || args.options.ownerIds || args.options.ownerEmails;
+        }
+    }, {
+        options: ['memberUserNames', 'memberIds', 'memberEmails'],
+        runsWhen: (args) => {
+            return args.options.memberUserNames || args.options.memberIds || args.options.memberEmails;
+        }
     });
 };
 export default new TeamsTeamAddCommand();

package/dist/m365/tenant/commands/report/report-office365activationcounts.js

@@ -3,6 +3,9 @@ import { formatting } from '../../../../utils/formatting.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TenantReportOffice365ActivationCountsCommand extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     get name() {
         return commands.REPORT_OFFICE365ACTIVATIONCOUNTS;
     }

package/dist/m365/tenant/commands/report/report-office365activationsusercounts.js

@@ -3,6 +3,9 @@ import { formatting } from '../../../../utils/formatting.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TenantReportOffice365ActivationsUserCountsCommand extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     get name() {
         return commands.REPORT_OFFICE365ACTIVATIONSUSERCOUNTS;
     }

package/dist/m365/tenant/commands/report/report-office365activationsuserdetail.js

@@ -3,6 +3,9 @@ import { formatting } from '../../../../utils/formatting.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TenantReportOffice365ActivationsUserDetailCommand extends GraphCommand {
+    get allowedOutputs() {
+        return ['json', 'csv'];
+    }
     get name() {
         return commands.REPORT_OFFICE365ACTIVATIONSUSERDETAIL;
     }

package/dist/utils/entraUser.js

@@ -74,6 +74,42 @@ export const entraUser = {
         }
         return res.value[0].id;
     },
+    /**
+     * Retrieve the IDs of users by their mail. There is no guarantee that the order of the returned IDs will match the order of the specified mails.
+     * @param emails Array of user mails.
+     * @returns Array of user IDs.
+     */
+    async getUserIdsByEmails(emails) {
+        const userIds = [];
+        for (let i = 0; i < emails.length; i += 20) {
+            const emailsChunk = emails.slice(i, i + 20);
+            const requestOptions = {
+                url: `${graphResource}/v1.0/$batch`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    requests: emailsChunk.map((email, index) => ({
+                        id: index + 1,
+                        method: 'GET',
+                        url: `/users?$filter=mail eq '${formatting.encodeQueryParameter(email)}'&$select=id`,
+                        headers: {
+                            accept: 'application/json;odata.metadata=none'
+                        }
+                    }))
+                }
+            };
+            const res = await request.post(requestOptions);
+            for (const response of res.responses) {
+                if (response.status !== 200) {
+                    throw Error(`The specified user with mail '${emailsChunk[response.id - 1]}' does not exist.`);
+                }
+                userIds.push(response.body.id);
+            }
+        }
+        return userIds;
+    },
     /**
      * Retrieve the UPN of a user by its ID.
      * @param id User ID.

package/docs/docs/cmd/entra/m365group/m365group-report-activitycounts.mdx

@@ -30,6 +30,14 @@ m365 aad m365group report activitycounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get the number of group activities across group workloads for the last week

package/docs/docs/cmd/entra/m365group/m365group-report-activitydetail.mdx

@@ -33,6 +33,14 @@ m365 aad m365group report activitydetail [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get details about Microsoft 365 Groups activity by group for the last week

package/docs/docs/cmd/entra/m365group/m365group-report-activityfilecounts.mdx

@@ -30,6 +30,14 @@ m365 aad m365group report activityfilecounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get the total number of files and how many of them were active across all group sites associated with an Microsoft 365 Group for the last week

package/docs/docs/cmd/entra/m365group/m365group-report-activitygroupcounts.mdx

@@ -30,6 +30,14 @@ m365 aad m365group report activitygroupcounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get the daily total number of groups and how many of them were active based on activities for the last week

package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx

@@ -30,6 +30,14 @@ m365 aad m365group report activitystorage  [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get the total storage used across all group mailboxes and group sites for the last week

package/docs/docs/cmd/onedrive/report/report-activityfilecounts.mdx

@@ -21,6 +21,14 @@ m365 onedrive report activityfilecounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the number of unique, licensed users that performed file interactions against any OneDrive account for the last week

package/docs/docs/cmd/onedrive/report/report-activityusercounts.mdx

@@ -21,6 +21,14 @@ m365 onedrive report activityusercounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the trend in the number of active OneDrive users for the last week

package/docs/docs/cmd/onedrive/report/report-activityuserdetail.mdx

@@ -24,6 +24,14 @@ m365 onedrive report activityuserdetail [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets details about OneDrive activity by user for the last week

package/docs/docs/cmd/onedrive/report/report-usageaccountcounts.mdx

@@ -23,6 +23,14 @@ m365 onedrive report usageaccountcounts [options]
 
 ## Remarks
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
+## Remarks
+
 Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is considered an active site
 
 ## Examples

package/docs/docs/cmd/onedrive/report/report-usageaccountdetail.mdx

@@ -24,6 +24,14 @@ m365 onedrive report usageaccountdetail [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets details about OneDrive usage by account for the last week

package/docs/docs/cmd/onedrive/report/report-usagefilecounts.mdx

@@ -25,6 +25,12 @@ m365 onedrive report usagefilecounts [options]
 
 A file is considered active if it has been saved, synced, modified, or shared within the specified time period.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the total number of files across all sites and how many are active files for the last week

package/docs/docs/cmd/onedrive/report/report-usagestorage.mdx

@@ -21,6 +21,14 @@ m365 onedrive report usagestorage [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the trend on the amount of storage you are using in OneDrive for Business for the last week

package/docs/docs/cmd/outlook/report/report-mailactivitycounts.mdx

@@ -12,6 +12,14 @@ Enables you to understand the trends of email activity (like how many were sent,
 m365 outlook report mailactivitycounts [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailactivityusercounts.mdx

@@ -12,6 +12,14 @@ Enables you to understand trends on the number of unique users who are performin
 m365 outlook report mailactivityusercounts [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailactivityuserdetail.mdx

@@ -12,6 +12,14 @@ Gets details about email activity users have performed
 m365 outlook report mailactivityuserdetail [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailappusageappsusercounts.mdx

@@ -11,6 +11,13 @@ Gets the count of unique users per email app
 ```sh
 m365 outlook report mailappusageappsusercounts [options]
 ```
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
 
 ## Options
 

package/docs/docs/cmd/outlook/report/report-mailappusageusercounts.mdx

@@ -12,6 +12,14 @@ Gets the count of unique users that connected to Exchange Online using any email
 m365 outlook report mailappusageusercounts [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailappusageuserdetail.mdx

@@ -12,6 +12,14 @@ Gets details about which activities users performed on the various email apps
 m365 outlook report mailappusageuserdetail [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailappusageversionsusercounts.mdx

@@ -12,6 +12,14 @@ Gets the count of unique users by Outlook desktop version.
 m365 outlook report mailappusageversionsusercounts [options]
 ```
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/outlook/report/report-mailboxusagedetail.mdx

@@ -21,6 +21,14 @@ m365 outlook report mailboxusagedetail [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets details about mailbox usage for the last week

package/docs/docs/cmd/outlook/report/report-mailboxusagemailboxcount.mdx

@@ -25,6 +25,12 @@ m365 outlook report mailboxusagemailboxcount [options]
 
 A mailbox is considered active if the user sent or read any email.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the total number of user mailboxes in your organization and how many are active each day for the last week.