@pnp/cli-microsoft365 7.2.0-beta.54705a9 → 7.2.0-beta.a021bb1

package/dist/m365/tenant/commands/people/people-profilecardproperty-add.js

@@ -0,0 +1,131 @@
+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 _TenantPeopleProfileCardPropertyAddCommand_instances, _TenantPeopleProfileCardPropertyAddCommand_initTelemetry, _TenantPeopleProfileCardPropertyAddCommand_initOptions, _TenantPeopleProfileCardPropertyAddCommand_initValidators;
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { profileCardPropertyNames } from './profileCardProperties.js';
+class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_ADD;
+    }
+    get description() {
+        return 'Adds an additional attribute to the profile card properties';
+    }
+    constructor() {
+        super();
+        _TenantPeopleProfileCardPropertyAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initValidators).call(this);
+    }
+    allowUnknownOptions() {
+        return true;
+    }
+    async commandAction(logger, args) {
+        const directoryPropertyName = profileCardPropertyNames.find(n => n.toLowerCase() === args.options.name.toLowerCase());
+        if (this.verbose) {
+            await logger.logToStderr(`Adding '${directoryPropertyName}' as a profile card property...`);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/admin/people/profileCardProperties`,
+            headers: {
+                'content-type': 'application/json',
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json',
+            data: {
+                directoryPropertyName,
+                annotations: this.getAnnotations(args.options)
+            }
+        };
+        try {
+            const response = await request.post(requestOptions);
+            // Transform the output to make it more readable
+            if (args.options.output && args.options.output !== 'json' && response.annotations.length > 0) {
+                const annotation = response.annotations[0];
+                response.displayName = annotation.displayName;
+                annotation.localizations.forEach((l) => {
+                    response[`displayName ${l.languageTag}`] = l.displayName;
+                });
+                delete response.annotations;
+            }
+            await logger.log(response);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    getAnnotations(options) {
+        if (!options.displayName) {
+            return [];
+        }
+        return [
+            {
+                displayName: options.displayName,
+                localizations: this.getLocalizations(options)
+            }
+        ];
+    }
+    getLocalizations(options) {
+        const unknownOptions = Object.keys(this.getUnknownOptions(options));
+        if (unknownOptions.length === 0) {
+            return [];
+        }
+        const localizations = [];
+        unknownOptions.forEach(key => {
+            localizations.push({
+                languageTag: key.replace('displayName-', ''),
+                displayName: options[key]
+            });
+        });
+        return localizations;
+    }
+}
+_TenantPeopleProfileCardPropertyAddCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertyAddCommand_initTelemetry = function _TenantPeopleProfileCardPropertyAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        // Add unknown options to telemetry
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
+        Object.assign(this.telemetryProperties, {
+            displayName: typeof args.options.displayName !== 'undefined',
+            ...unknownOptionsObj
+        });
+    });
+}, _TenantPeopleProfileCardPropertyAddCommand_initOptions = function _TenantPeopleProfileCardPropertyAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name <name>',
+        autocomplete: profileCardPropertyNames
+    }, {
+        option: '-d, --displayName [displayName]'
+    });
+}, _TenantPeopleProfileCardPropertyAddCommand_initValidators = function _TenantPeopleProfileCardPropertyAddCommand_initValidators() {
+    this.validators.push(async (args) => {
+        const propertyName = args.options.name.toLowerCase();
+        if (profileCardPropertyNames.every(n => n.toLowerCase() !== propertyName)) {
+            return `${args.options.name} is not a valid value for name. Allowed values are ${profileCardPropertyNames.join(', ')}`;
+        }
+        if (propertyName.startsWith('customattribute') && args.options.displayName === undefined) {
+            return `The option 'displayName' is required when adding customAttributes as profile card properties`;
+        }
+        if (!propertyName.startsWith('customattribute') && args.options.displayName !== undefined) {
+            return `The option 'displayName' can only be used when adding customAttributes as profile card properties`;
+        }
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        if (!propertyName.startsWith('customattribute') && unknownOptions.length > 0) {
+            return `Unknown options like ${unknownOptions.join(', ')} are only supported with customAttributes`;
+        }
+        if (propertyName.startsWith('customattribute')) {
+            const wronglyFormattedOptions = unknownOptions.filter(key => !key.toLowerCase().startsWith('displayname-'));
+            if (wronglyFormattedOptions.length > 0) {
+                return `Wrong option format detected for the following option(s): ${wronglyFormattedOptions.join(', ')}'. When adding localizations for customAttributes, use the format displayName-<languageTag>.`;
+            }
+        }
+        return true;
+    });
+};
+export default new TenantPeopleProfileCardPropertyAddCommand();
+//# sourceMappingURL=people-profilecardproperty-add.js.map

package/dist/m365/tenant/commands/people/people-profilecardproperty-get.js

@@ -0,0 +1,75 @@
+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 _TenantPeopleProfileCardPropertyGetCommand_instances, _TenantPeopleProfileCardPropertyGetCommand_initOptions, _TenantPeopleProfileCardPropertyGetCommand_initValidators;
+import GraphCommand from '../../../base/GraphCommand.js';
+import request from '../../../../request.js';
+import { profileCardPropertyNames } from './profileCardProperties.js';
+import commands from '../../commands.js';
+class TenantPeopleProfileCardPropertyGetCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_GET;
+    }
+    get description() {
+        return 'Retrieves information about a specific profile card property';
+    }
+    constructor() {
+        super();
+        _TenantPeopleProfileCardPropertyGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyGetCommand_instances, "m", _TenantPeopleProfileCardPropertyGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyGetCommand_instances, "m", _TenantPeopleProfileCardPropertyGetCommand_initValidators).call(this);
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving information about profile card property '${args.options.name}'...`);
+            }
+            // Get the right casing for the profile card property name
+            const profileCardProperty = profileCardPropertyNames.find(p => p.toLowerCase() === args.options.name.toLowerCase());
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${profileCardProperty}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const result = await request.get(requestOptions);
+            let output = result;
+            // Transform the output to make it more readable
+            if (args.options.output && args.options.output !== 'json' && result.annotations.length > 0) {
+                output = result.annotations[0].localizations.reduce((acc, curr) => ({
+                    ...acc,
+                    ['displayName ' + curr.languageTag]: curr.displayName
+                }), {
+                    ...result,
+                    displayName: result.annotations[0].displayName
+                });
+                delete output.annotations;
+            }
+            await logger.log(output);
+        }
+        catch (err) {
+            if (err.response?.status === 404) {
+                this.handleError(`Profile card property '${args.options.name}' does not exist.`);
+            }
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+_TenantPeopleProfileCardPropertyGetCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertyGetCommand_initOptions = function _TenantPeopleProfileCardPropertyGetCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name <name>',
+        autocomplete: profileCardPropertyNames
+    });
+}, _TenantPeopleProfileCardPropertyGetCommand_initValidators = function _TenantPeopleProfileCardPropertyGetCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (!profileCardPropertyNames.some(p => p.toLowerCase() === args.options.name.toLowerCase())) {
+            return `'${args.options.name}' is not a valid value for option name. Allowed values are: ${profileCardPropertyNames.join(', ')}.`;
+        }
+        return true;
+    });
+};
+export default new TenantPeopleProfileCardPropertyGetCommand();
+//# sourceMappingURL=people-profilecardproperty-get.js.map

package/dist/m365/tenant/commands/people/people-profilecardproperty-list.js

@@ -0,0 +1,53 @@
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { odata } from '../../../../utils/odata.js';
+class TenantPeopleProfileCardPropertyListCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_LIST;
+    }
+    get description() {
+        return 'Lists all profile card properties';
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Listing all profile card properties...`);
+            }
+            const result = await odata.getAllItems(`${this.resource}/v1.0/admin/people/profileCardProperties`);
+            let output = result;
+            if (args.options.output && args.options.output !== 'json') {
+                output = output.sort((n1, n2) => {
+                    const localizations1 = n1.annotations[0]?.localizations?.length ?? 0;
+                    const localizations2 = n2.annotations[0]?.localizations?.length ?? 0;
+                    if (localizations1 > localizations2) {
+                        return -1;
+                    }
+                    if (localizations1 < localizations2) {
+                        return 1;
+                    }
+                    return 0;
+                });
+                output = output.map((p) => {
+                    const propertyAnnotations = p.annotations[0]?.localizations?.map((l) => {
+                        return { ['displayName ' + l.languageTag]: l.displayName };
+                    }) ?? [];
+                    const propertyAnnotationsObject = Object.assign({}, ...propertyAnnotations);
+                    const result = { directoryPropertyName: p.directoryPropertyName };
+                    if (p.annotations[0]?.displayName) {
+                        result.displayName = p.annotations[0]?.displayName;
+                    }
+                    return {
+                        ...result,
+                        ...propertyAnnotationsObject
+                    };
+                });
+            }
+            await logger.log(output);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new TenantPeopleProfileCardPropertyListCommand();
+//# sourceMappingURL=people-profilecardproperty-list.js.map

package/dist/m365/tenant/commands/people/people-profilecardproperty-remove.js

@@ -0,0 +1,84 @@
+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 _TenantPeopleProfileCardPropertyRemoveCommand_instances, _TenantPeopleProfileCardPropertyRemoveCommand_initTelemetry, _TenantPeopleProfileCardPropertyRemoveCommand_initOptions, _TenantPeopleProfileCardPropertyRemoveCommand_initValidators;
+import { Cli } from '../../../../cli/Cli.js';
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { profileCardPropertyNames } from './profileCardProperties.js';
+class TenantPeopleProfileCardPropertyRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_REMOVE;
+    }
+    get description() {
+        return 'Removes an additional attribute from the profile card properties';
+    }
+    constructor() {
+        super();
+        _TenantPeopleProfileCardPropertyRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyRemoveCommand_instances, "m", _TenantPeopleProfileCardPropertyRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyRemoveCommand_instances, "m", _TenantPeopleProfileCardPropertyRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyRemoveCommand_instances, "m", _TenantPeopleProfileCardPropertyRemoveCommand_initValidators).call(this);
+    }
+    async commandAction(logger, args) {
+        const directoryPropertyName = profileCardPropertyNames.find(n => n.toLowerCase() === args.options.name.toLowerCase());
+        const removeProfileCardProperty = async () => {
+            if (this.verbose) {
+                await logger.logToStderr(`Removing '${directoryPropertyName}' as a profile card property...`);
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${directoryPropertyName}`,
+                headers: {
+                    'content-type': 'application/json'
+                },
+                responseType: 'json'
+            };
+            try {
+                await request.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeProfileCardProperty();
+        }
+        else {
+            const result = await Cli.prompt({
+                type: 'confirm',
+                name: 'continue',
+                default: false,
+                message: `Are you sure you want to remove the profile card property '${directoryPropertyName}'?`
+            });
+            if (result.continue) {
+                await removeProfileCardProperty();
+            }
+        }
+    }
+}
+_TenantPeopleProfileCardPropertyRemoveCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertyRemoveCommand_initTelemetry = function _TenantPeopleProfileCardPropertyRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            force: !!args.options.force
+        });
+    });
+}, _TenantPeopleProfileCardPropertyRemoveCommand_initOptions = function _TenantPeopleProfileCardPropertyRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name <name>',
+        autocomplete: profileCardPropertyNames
+    }, {
+        option: '-f, --force'
+    });
+}, _TenantPeopleProfileCardPropertyRemoveCommand_initValidators = function _TenantPeopleProfileCardPropertyRemoveCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (profileCardPropertyNames.every(n => n.toLowerCase() !== args.options.name.toLowerCase())) {
+            return `${args.options.name} is not a valid value for name. Allowed values are ${profileCardPropertyNames.join(', ')}`;
+        }
+        return true;
+    });
+};
+export default new TenantPeopleProfileCardPropertyRemoveCommand();
+//# sourceMappingURL=people-profilecardproperty-remove.js.map

package/dist/m365/tenant/commands/people/people-profilecardproperty-set.js

@@ -0,0 +1,118 @@
+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 _TenantPeopleProfileCardPropertySetCommand_instances, _TenantPeopleProfileCardPropertySetCommand_initTelemetry, _TenantPeopleProfileCardPropertySetCommand_initOptions, _TenantPeopleProfileCardPropertySetCommand_initValidators, _TenantPeopleProfileCardPropertySetCommand_initTypes;
+import GraphCommand from '../../../base/GraphCommand.js';
+import request from '../../../../request.js';
+import { profileCardPropertyNames as allProfileCardPropertyNames } from './profileCardProperties.js';
+import commands from '../../commands.js';
+class TenantPeopleProfileCardPropertySetCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_SET;
+    }
+    get description() {
+        return 'Updates a custom attribute to the profile card property';
+    }
+    constructor() {
+        super();
+        _TenantPeopleProfileCardPropertySetCommand_instances.add(this);
+        this.profileCardPropertyNames = allProfileCardPropertyNames.filter(p => p.toLowerCase().startsWith('customattribute'));
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initTypes).call(this);
+    }
+    allowUnknownOptions() {
+        return true;
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Updating profile card property '${args.options.name}'...`);
+            }
+            // Get the right casing for the profile card property name
+            const profileCardProperty = this.profileCardPropertyNames.find(p => p.toLowerCase() === args.options.name.toLowerCase());
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${profileCardProperty}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    annotations: [
+                        {
+                            displayName: args.options.displayName,
+                            localizations: this.getLocalizations(args.options)
+                        }
+                    ]
+                }
+            };
+            const result = await request.patch(requestOptions);
+            let output = result;
+            // Transform the output to make it more readable
+            if (args.options.output && args.options.output !== 'json' && result.annotations.length > 0) {
+                output = result.annotations[0].localizations.reduce((acc, curr) => ({
+                    ...acc,
+                    ['displayName ' + curr.languageTag]: curr.displayName
+                }), {
+                    ...result,
+                    displayName: result.annotations[0].displayName
+                });
+                delete output.annotations;
+            }
+            await logger.log(output);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    /**
+     * Transform option to localization object.
+     * @example Transform "--displayName-en-US 'Cost center'" to { languageTag: 'en-US', displayName: 'Cost center' }
+     */
+    getLocalizations(options) {
+        const unknownOptions = this.getUnknownOptions(options);
+        const result = Object.keys(unknownOptions).map(o => ({
+            languageTag: o.substring(o.indexOf('-') + 1),
+            displayName: unknownOptions[o]
+        }));
+        return result;
+    }
+}
+_TenantPeopleProfileCardPropertySetCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertySetCommand_initTelemetry = function _TenantPeopleProfileCardPropertySetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        // Add unknown options to telemetry
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
+        Object.assign(this.telemetryProperties, {
+            displayName: typeof args.options.displayName !== 'undefined',
+            ...unknownOptionsObj
+        });
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initOptions = function _TenantPeopleProfileCardPropertySetCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name <name>',
+        autocomplete: this.profileCardPropertyNames
+    }, {
+        option: '-d, --displayName <displayName>'
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initValidators = function _TenantPeopleProfileCardPropertySetCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (!this.profileCardPropertyNames.some(p => p.toLowerCase() === args.options.name.toLowerCase())) {
+            return `'${args.options.name}' is not a valid value for option name. Allowed values are: ${this.profileCardPropertyNames.join(', ')}.`;
+        }
+        // Unknown options are allowed only if they start with 'displayName-'
+        const unknownOptionKeys = Object.keys(this.getUnknownOptions(args.options));
+        const invalidOptionKey = unknownOptionKeys.find(o => !o.startsWith('displayName-'));
+        if (invalidOptionKey) {
+            return `Invalid option: '${invalidOptionKey}'`;
+        }
+        return true;
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initTypes = function _TenantPeopleProfileCardPropertySetCommand_initTypes() {
+    this.types.string.push('name', 'displayName');
+};
+export default new TenantPeopleProfileCardPropertySetCommand();
+//# sourceMappingURL=people-profilecardproperty-set.js.map

package/dist/m365/tenant/commands/people/profileCardProperties.js

@@ -0,0 +1,24 @@
+export const profileCardPropertyNames = [
+    'UserPrincipalName',
+    'Fax',
+    'StreetAddress',
+    'PostalCode',
+    'StateOrProvince',
+    'Alias',
+    'customAttribute1',
+    'customAttribute2',
+    'customAttribute3',
+    'customAttribute4',
+    'customAttribute5',
+    'customAttribute6',
+    'customAttribute7',
+    'customAttribute8',
+    'customAttribute9',
+    'customAttribute10',
+    'customAttribute11',
+    'customAttribute12',
+    'customAttribute13',
+    'customAttribute14',
+    'customAttribute15'
+];
+//# sourceMappingURL=profileCardProperties.js.map

package/dist/m365/tenant/commands.js

@@ -2,6 +2,11 @@ const prefix = 'tenant';
 export default {
     ID_GET: `${prefix} id get`,
     INFO_GET: `${prefix} info get`,
+    PEOPLE_PROFILECARDPROPERTY_ADD: `${prefix} people profilecardproperty add`,
+    PEOPLE_PROFILECARDPROPERTY_GET: `${prefix} people profilecardproperty get`,
+    PEOPLE_PROFILECARDPROPERTY_LIST: `${prefix} people profilecardproperty list`,
+    PEOPLE_PROFILECARDPROPERTY_REMOVE: `${prefix} people profilecardproperty remove`,
+    PEOPLE_PROFILECARDPROPERTY_SET: `${prefix} people profilecardproperty set`,
     REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
     REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
     REPORT_OFFICE365ACTIVATIONCOUNTS: `${prefix} report office365activationcounts`,

package/dist/utils/aadGroup.js

@@ -54,7 +54,9 @@ export const aadGroup = {
             throw Error(`The specified group '${displayName}' does not exist.`);
         }
         if (groups.length > 1) {
-            throw Error(`Multiple groups with name '${displayName}' found: ${groups.map(x => x.id).join(',')}.`);
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', groups);
+            const result = await Cli.handleMultipleResultsFound(`Multiple groups with name '${displayName}' found.`, resultAsKeyValuePair);
+            return result.id;
         }
         return groups[0].id;
     },

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-add.mdx

@@ -0,0 +1,119 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad administrativeunit add
+
+Creates a new administrative unit
+
+## Usage
+
+```sh
+m365 aad administrativeunit add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --displayname <displayName>`
+: Display name for the administrative unit.
+
+`-d, --description [description]`
+: Description for the administrative unit.
+
+`--hiddenMembership`
+: Indicates whether the administrative unit and its members are hidden.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Global Administrator** or **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Create an administrative unit with a specific display name
+
+```sh
+m365 aad administrativeunit add --displayName 'Marketing Division'
+```
+
+Create an administrative unit with a specific display name and description
+
+```sh
+m365 aad administrativeunit add --displayName 'Marketing Division' --description 'Marketing department administration'
+```
+
+Create a hidden administrative unit with a specific display name
+
+```sh
+m365 aad administrativeunit add --displayName 'Marketing Division' --hiddenMembership
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "00b45a1b-7632-4e94-a3bd-f06aec976d31",
+    "deletedDateTime": null,
+    "displayName": "Marketing Division",
+    "description": "Marketing department administration",
+    "membershipRule": null,
+    "membershipType": null,
+    "membershipRuleProcessingState": null,
+    "visibility": null
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  deletedDateTime              : null
+  description                  : Marketing department administration
+  displayName                  : Marketing Division
+  id                           : 00b45a1b-7632-4e94-a3bd-f06aec976d31
+  membershipRule               : null
+  membershipRuleProcessingState: null
+  membershipType               : null
+  visibility                   : null
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,visibility
+  00b45a1b-7632-4e94-a3bd-f06aec976d31,Marketing Division,Marketing department administration,HiddenMembership
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Date: 10/23/2023
+
+  ## Marketing Division (00b45a1b-7632-4e94-a3bd-f06aec976d31)
+
+  Property | Value
+  ---------|-------
+  id | 00b45a1b-7632-4e94-a3bd-f06aec976d31
+  displayName | Marketing Division
+  description | Marketing department administration
+  visibility | HiddenMembership
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units