@pnp/cli-microsoft365 7.3.0-beta.73848f3 → 7.3.0-beta.ca3f7f5

package/dist/m365/external/commands/item/item-add.js

@@ -0,0 +1,144 @@
+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 _ExternalItemAddCommand_instances, _a, _ExternalItemAddCommand_initTelemetry, _ExternalItemAddCommand_initOptions, _ExternalItemAddCommand_initValidators;
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+class ExternalItemAddCommand extends GraphCommand {
+    get name() {
+        return commands.ITEM_ADD;
+    }
+    get description() {
+        return 'Creates external item';
+    }
+    constructor() {
+        super();
+        _ExternalItemAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _ExternalItemAddCommand_instances, "m", _ExternalItemAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _ExternalItemAddCommand_instances, "m", _ExternalItemAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _ExternalItemAddCommand_instances, "m", _ExternalItemAddCommand_initValidators).call(this);
+    }
+    allowUnknownOptions() {
+        return true;
+    }
+    async commandAction(logger, args) {
+        const acls = args.options.acls
+            .split(';')
+            .map(acl => {
+            const aclParts = acl.split(',');
+            return {
+                accessType: aclParts[0],
+                type: aclParts[1],
+                value: aclParts[2]
+            };
+        });
+        const requestBody = {
+            id: args.options.id,
+            content: {
+                value: args.options.content,
+                type: args.options.contentType ?? 'text'
+            },
+            acl: acls,
+            properties: {}
+        };
+        // we need to rewrite the @odata properties to the correct format
+        // because . in @odata.type is interpreted by minimist as a child property
+        // we also need to extract multiple values for collections into arrays
+        this.rewriteCollectionProperties(args.options);
+        this.addUnknownOptionsToPayload(requestBody.properties, args.options);
+        const requestOptions = {
+            url: `${this.resource}/v1.0/external/connections/${args.options.externalConnectionId}/items/${args.options.id}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none',
+                'content-type': 'application/json'
+            },
+            responseType: 'json',
+            data: requestBody
+        };
+        try {
+            const externalItem = await request.put(requestOptions);
+            if (args.options.output === 'csv' || args.options.output === 'md') {
+                // for CSV and md, we need to bring the properties to the main object
+                // and convert arrays to comma-separated strings or they will be dropped
+                // from the output
+                Object.getOwnPropertyNames(externalItem.properties).forEach(name => {
+                    if (Array.isArray(externalItem.properties[name])) {
+                        externalItem[name] = externalItem.properties[name].join(', ');
+                    }
+                    else {
+                        externalItem[name] = externalItem.properties[name];
+                    }
+                });
+            }
+            await logger.log(externalItem);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    rewriteCollectionProperties(options) {
+        Object.getOwnPropertyNames(options).forEach(name => {
+            if (!name.endsWith('@odata')) {
+                return;
+            }
+            options[`${name}.type`] = options[name].type;
+            delete options[name];
+            // convert the value of a collection to an array
+            const nameWithoutOData = name.substring(0, name.indexOf('@odata'));
+            if (options[nameWithoutOData]) {
+                options[nameWithoutOData] = options[nameWithoutOData].split(';#');
+            }
+        });
+    }
+}
+_a = ExternalItemAddCommand, _ExternalItemAddCommand_instances = new WeakSet(), _ExternalItemAddCommand_initTelemetry = function _ExternalItemAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            contentType: typeof args.options.contentType
+        });
+    });
+}, _ExternalItemAddCommand_initOptions = function _ExternalItemAddCommand_initOptions() {
+    this.options.unshift({
+        option: '--id <id>'
+    }, {
+        option: '--externalConnectionId <externalConnectionId>'
+    }, {
+        option: '--content <content>'
+    }, {
+        option: '--contentType [contentType]',
+        autocomplete: _a.contentType
+    }, {
+        option: '--acls <acls>'
+    });
+}, _ExternalItemAddCommand_initValidators = function _ExternalItemAddCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.contentType &&
+            _a.contentType.indexOf(args.options.contentType) < 0) {
+            return `${args.options.contentType} is not a valid value for contentType. Allowed values are ${_a.contentType.join(', ')}`;
+        }
+        // verify that each value for ACLs consists of three parts
+        // and that the values are correct
+        const acls = args.options.acls.split(';');
+        for (let i = 0; i < acls.length; i++) {
+            const acl = acls[i].split(',');
+            if (acl.length !== 3) {
+                return `The value ${acls[i]} for option acls is not in the correct format. The correct format is "accessType,type,value", eg. "grant,everyone,everyone"`;
+            }
+            const accessTypeValues = ['grant', 'deny'];
+            if (accessTypeValues.indexOf(acl[0]) < 0) {
+                return `The value ${acl[0]} for option acls is not valid. Allowed values are ${accessTypeValues.join(', ')}}`;
+            }
+            const aclTypeValues = ['user', 'group', 'everyone', 'everyoneExceptGuests', 'externalGroup'];
+            if (aclTypeValues.indexOf(acl[1]) < 0) {
+                return `The value ${acl[1]} for option acls is not valid. Allowed values are ${aclTypeValues.join(', ')}}`;
+            }
+        }
+        return true;
+    });
+};
+ExternalItemAddCommand.contentType = ['text', 'html'];
+export default new ExternalItemAddCommand();
+//# sourceMappingURL=item-add.js.map

package/dist/m365/external/commands.js

@@ -2,6 +2,7 @@ const prefix = 'external';
 const searchPrefix = 'search';
 export default {
     CONNECTION_ADD: `${prefix} connection add`,
+    CONNECTION_DOCTOR: `${prefix} connection doctor`,
     CONNECTION_GET: `${prefix} connection get`,
     CONNECTION_LIST: `${prefix} connection list`,
     CONNECTION_REMOVE: `${prefix} connection remove`,
@@ -10,6 +11,7 @@ export default {
     EXTERNALCONNECTION_GET: `${searchPrefix} externalconnection get`,
     EXTERNALCONNECTION_LIST: `${searchPrefix} externalconnection list`,
     EXTERNALCONNECTION_REMOVE: `${searchPrefix} externalconnection remove`,
-    EXTERNALCONNECTION_SCHEMA_ADD: `${searchPrefix} externalconnection schema add`
+    EXTERNALCONNECTION_SCHEMA_ADD: `${searchPrefix} externalconnection schema add`,
+    ITEM_ADD: `${prefix} item add`
 };
 //# sourceMappingURL=commands.js.map

package/dist/m365/spo/commands/customaction/customaction-add.js

@@ -65,7 +65,7 @@ class SpoCustomActionAddCommand extends SpoCommand {
                     RegistrationId: customAction.RegistrationId,
                     RegistrationType: customAction.RegistrationType,
                     Rights: JSON.stringify(customAction.Rights),
-                    Scope: args.options.scope,
+                    Scope: args.options.scope, // because it is more human readable
                     ScriptBlock: customAction.ScriptBlock,
                     ScriptSrc: customAction.ScriptSrc,
                     Sequence: customAction.Sequence,

package/dist/m365/spo/commands/file/file-add.js

@@ -352,7 +352,7 @@ class SpoFileAddCommand extends SpoCommand {
         }
         const requestBody = {
             formValues: fieldsToUpdate,
-            bNewDocumentUpdate: true,
+            bNewDocumentUpdate: true, // true = will automatically checkin the item, but we will use it to perform system update and also do a checkin
             checkInComment: checkInComment || ''
         };
         if (this.debug) {

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

@@ -0,0 +1,151 @@
+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 _TeamsMeetingAddCommand_instances, _TeamsMeetingAddCommand_initTelemetry, _TeamsMeetingAddCommand_initOptions, _TeamsMeetingAddCommand_initValidators;
+import auth from '../../../../Auth.js';
+import { aadUser } from '../../../../utils/aadUser.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import { validation } from '../../../../utils/validation.js';
+import GraphCommand from "../../../base/GraphCommand.js";
+import commands from '../../commands.js';
+import request from '../../../../request.js';
+class TeamsMeetingAddCommand extends GraphCommand {
+    get name() {
+        return commands.MEETING_ADD;
+    }
+    get description() {
+        return 'Creates a new online meeting';
+    }
+    constructor() {
+        super();
+        _TeamsMeetingAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAddCommand_instances, "m", _TeamsMeetingAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAddCommand_instances, "m", _TeamsMeetingAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAddCommand_instances, "m", _TeamsMeetingAddCommand_initValidators).call(this);
+    }
+    async commandAction(logger, args) {
+        try {
+            const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAccessToken && !args.options.organizerEmail) {
+                throw `The option 'organizerEmail' is required when creating a meeting using app only permissions`;
+            }
+            if (!isAppOnlyAccessToken && args.options.organizerEmail) {
+                throw `The option 'organizerEmail' is not supported when creating a meeting using delegated permissions`;
+            }
+            const meeting = await this.createMeeting(logger, args.options);
+            await logger.log(meeting);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    /**
+     * Creates a new online meeting
+     * @param logger
+     * @param options
+     * @returns MS Graph online meeting response
+     */
+    async createMeeting(logger, options) {
+        let requestUrl = `${this.resource}/v1.0/me`;
+        if (options.organizerEmail) {
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving Organizer Id...`);
+            }
+            const organizerId = await aadUser.getUserIdByEmail(options.organizerEmail);
+            requestUrl = `${this.resource}/v1.0/users/${organizerId}`;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Creating the meeting...`);
+        }
+        const requestData = {};
+        if (options.participantUserNames) {
+            const attendees = options.participantUserNames.trim().toLowerCase().split(',').map(p => ({
+                upn: p.trim()
+            }));
+            requestData.participants = { attendees };
+        }
+        if (options.startTime) {
+            requestData.startDateTime = options.startTime;
+        }
+        if (options.endTime) {
+            requestData.endDateTime = options.endTime;
+            if (!options.startTime) {
+                requestData.startDateTime = new Date().toISOString();
+            }
+        }
+        if (options.subject) {
+            requestData.subject = options.subject;
+        }
+        if (options.recordAutomatically !== undefined) {
+            requestData.recordAutomatically = true;
+        }
+        const requestOptions = {
+            headers: {
+                accept: 'application/json;odata.metadata=none',
+                'content-type': 'application/json'
+            },
+            responseType: 'json',
+            url: `${requestUrl}/onlineMeetings`,
+            data: requestData
+        };
+        return request.post(requestOptions);
+    }
+}
+_TeamsMeetingAddCommand_instances = new WeakSet(), _TeamsMeetingAddCommand_initTelemetry = function _TeamsMeetingAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            startTime: typeof args.options.startTime !== 'undefined',
+            endTime: typeof args.options.endTime !== 'undefined',
+            subject: typeof args.options.subject !== 'undefined',
+            participantUserNames: typeof args.options.participantUserNames !== 'undefined',
+            organizerEmail: typeof args.options.organizerEmail !== 'undefined',
+            recordAutomatically: !!args.options.recordAutomatically
+        });
+    });
+}, _TeamsMeetingAddCommand_initOptions = function _TeamsMeetingAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-s, --startTime [startTime]'
+    }, {
+        option: '-e, --endTime [endTime]'
+    }, {
+        option: '--subject [subject]'
+    }, {
+        option: '-p, --participantUserNames [participantUserNames]'
+    }, {
+        option: '--organizerEmail [organizerEmail]'
+    }, {
+        option: '-r, --recordAutomatically'
+    });
+}, _TeamsMeetingAddCommand_initValidators = function _TeamsMeetingAddCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.startTime && !validation.isValidISODateTime(args.options.startTime)) {
+            return `'${args.options.startTime}' is not a valid ISO date string for startTime.`;
+        }
+        if (args.options.endTime && !validation.isValidISODateTime(args.options.endTime)) {
+            return `'${args.options.endTime}' is not a valid ISO date string for endTime.`;
+        }
+        if (args.options.startTime && args.options.endTime && new Date(args.options.startTime) >= new Date(args.options.endTime)) {
+            return 'The startTime value must be before endTime.';
+        }
+        if (args.options.startTime && new Date() >= new Date(args.options.startTime)) {
+            return 'The startTime value must be in the future.';
+        }
+        if (args.options.endTime && new Date() >= new Date(args.options.endTime)) {
+            return 'The endTime value must be in the future.';
+        }
+        if (args.options.participantUserNames) {
+            const participants = args.options.participantUserNames.trim().toLowerCase().split(',').filter(e => e && e !== '');
+            if (!participants || participants.length === 0 || participants.some(e => !validation.isValidUserPrincipalName(e))) {
+                return `'${args.options.participantUserNames}' contains one or more invalid UPN.`;
+            }
+        }
+        if (args.options.organizerEmail && !validation.isValidUserPrincipalName(args.options.organizerEmail)) {
+            return `'${args.options.organizerEmail}' is not a valid email for organizerEmail.`;
+        }
+        return true;
+    });
+};
+export default new TeamsMeetingAddCommand();
+//# sourceMappingURL=meeting-add.js.map

package/dist/m365/teams/commands/user/user-app-remove.js

@@ -27,11 +27,15 @@ class TeamsUserAppRemoveCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         const removeApp = async () => {
+            const appId = await this.getAppId(args);
             // validation ensures that here we have either userId or userName
             const userId = (args.options.userId ?? args.options.userName);
             const endpoint = `${this.resource}/v1.0`;
+            if (this.verbose) {
+                await logger.logToStderr(`Removing app with ID ${args.options.id} for user ${args.options.userId}`);
+            }
             const requestOptions = {
-                url: `${endpoint}/users/${formatting.encodeQueryParameter(userId)}/teamwork/installedApps/${args.options.id}`,
+                url: `${endpoint}/users/${formatting.encodeQueryParameter(userId)}/teamwork/installedApps/${appId}`,
                 headers: {
                     'accept': 'application/json;odata.metadata=none'
                 },
@@ -54,10 +58,34 @@ class TeamsUserAppRemoveCommand extends GraphCommand {
             }
         }
     }
+    async getAppId(args) {
+        if (args.options.id) {
+            return args.options.id;
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/users/${args.options.userId}/teamwork/installedApps?$expand=teamsAppDefinition&$filter=teamsAppDefinition/displayName eq '${formatting.encodeQueryParameter(args.options.name)}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const response = await request.get(requestOptions);
+        if (response.value.length === 1) {
+            return response.value[0].id;
+        }
+        if (response.value.length === 0) {
+            throw `The specified Teams app does not exist`;
+        }
+        const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', response.value);
+        const result = (await Cli.handleMultipleResultsFound(`Multiple Teams apps with name '${args.options.name}' found.`, resultAsKeyValuePair));
+        return result.id;
+    }
 }
 _TeamsUserAppRemoveCommand_instances = new WeakSet(), _TeamsUserAppRemoveCommand_initTelemetry = function _TeamsUserAppRemoveCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
+            id: typeof args.options.id !== 'undefined',
+            name: typeof args.options.name !== 'undefined',
             userId: typeof args.options.userId !== 'undefined',
             userName: typeof args.options.userName !== 'undefined',
             force: (!!args.options.force).toString()
@@ -65,7 +93,9 @@ _TeamsUserAppRemoveCommand_instances = new WeakSet(), _TeamsUserAppRemoveCommand
     });
 }, _TeamsUserAppRemoveCommand_initOptions = function _TeamsUserAppRemoveCommand_initOptions() {
     this.options.unshift({
-        option: '--id <id>'
+        option: '--id [id]'
+    }, {
+        option: '--name [name]'
     }, {
         option: '--userId [userId]'
     }, {
@@ -84,6 +114,7 @@ _TeamsUserAppRemoveCommand_instances = new WeakSet(), _TeamsUserAppRemoveCommand
         return true;
     });
 }, _TeamsUserAppRemoveCommand_initOptionSets = function _TeamsUserAppRemoveCommand_initOptionSets() {
+    this.optionSets.push({ options: ['id', 'name'] });
     this.optionSets.push({ options: ['userId', 'userName'] });
 };
 export default new TeamsUserAppRemoveCommand();

package/dist/m365/teams/commands.js

@@ -27,9 +27,10 @@ export default {
     FUNSETTINGS_SET: `${prefix} funsettings set`,
     GUESTSETTINGS_LIST: `${prefix} guestsettings list`,
     GUESTSETTINGS_SET: `${prefix} guestsettings set`,
-    MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
+    MEETING_ADD: `${prefix} meeting add`,
     MEETING_GET: `${prefix} meeting get`,
     MEETING_LIST: `${prefix} meeting list`,
+    MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
     MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
     MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
     MEMBERSETTINGS_SET: `${prefix} membersettings set`,

package/dist/telemetry.js

@@ -29,14 +29,6 @@ export const telemetry = {
             commandName,
             properties
         });
-    },
-    trackException: (exception) => {
-        if (Cli.getInstance().getSettingWithDefaultValue(settingsNames.disableTelemetry, false)) {
-            return;
-        }
-        trackTelemetry({
-            exception
-        });
     }
 };
 //# sourceMappingURL=telemetry.js.map

package/dist/utils/validation.js

@@ -7,8 +7,11 @@ export const validation = {
             return false;
         }
         const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        // verify if the guid is a valid guid. @meid will be replaced in a later stage with the actual user id of the logged in user
-        return guidRegEx.test(guid) || guid.toLowerCase().trim() === '@meid';
+        // verify if the guid is a valid guid. @meid will be replaced in a later
+        // stage with the actual user id of the logged in user
+        // we also need to make it toString in case the args is resolved as number
+        // or boolean
+        return guidRegEx.test(guid) || guid.toString().toLowerCase().trim() === '@meid';
     },
     isValidTeamsChannelId(guid) {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);

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

@@ -14,6 +14,11 @@ m365 aad group list [options]
 
 ## Options
 
+```md definition-list
+`--type [type]`
+: Filter the results to only groups of a given type. Allowed values: `microsoft365`, `security`, `distribution`, `mailEnabledSecurity`. By default, all groups are listed.
+```
+
 <Global />
 
 ## Examples
@@ -24,6 +29,12 @@ Lists all groups defined in Azure Active Directory.
 m365 aad group list
 ```
 
+List all security groups defined in Azure Active Directory.
+
+```sh
+m365 aad group list --type security
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/aad/user/user-password-validate.mdx

@@ -23,7 +23,7 @@ m365 aad user password validate [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 
@@ -100,4 +100,4 @@ m365 aad user password validate --password "cli365P@ssW0rd"
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/adaptivecard/adaptivecard-send.mdx

@@ -47,7 +47,7 @@ The predefined card is automatically adjusted based on which options have been s
 
 If your custom card is a card template (card with placeholders like `${title}`), you can fill it with data either by specifying the complete data object using the `cardData` option, or by passing any number of arbitrary options that will be mapped onto the card. The arbitrary properties should not match any of the global options like `output`, `query`, `debug`, etc. Data options like `title`, `description`, `imageUrl` and `actionUrl` will be mapped onto the card as well.
 
-:::caution Escaping JSON in PowerShell
+:::warning Escaping JSON in PowerShell
 
 When using the `--card` and `--cardData` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.