@pnp/cli-microsoft365 7.1.0 → 7.2.0-beta.11c70fc

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,79 @@
+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.promptForConfirmation({ message: `Are you sure you want to remove the profile card property '${directoryPropertyName}'?` });
+            if (result) {
+                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/m365/todo/commands/list/list-remove.js

@@ -27,13 +27,8 @@ class TodoListRemoveCommand extends GraphCommand {
             await this.removeList(args);
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the task list ${args.options.id || args.options.name}?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the task list ${args.options.id || args.options.name}?` });
+            if (result) {
                 await this.removeList(args);
             }
         }

package/dist/m365/todo/commands/task/task-remove.js

@@ -27,13 +27,8 @@ class TodoTaskRemoveCommand extends GraphCommand {
             await this.removeToDoTask(args.options);
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the task ${args.options.id} from list ${args.options.listId || args.options.listName}?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the task ${args.options.id} from list ${args.options.listId || args.options.listName}?` });
+            if (result) {
                 await this.removeToDoTask(args.options);
             }
         }

package/dist/m365/yammer/commands/group/group-user-remove.js

@@ -31,13 +31,8 @@ class YammerGroupUserRemoveCommand extends YammerCommand {
             if (args.options.id) {
                 messagePrompt = `Are you sure you want to remove the user ${args.options.id} from the group ${args.options.groupId}?`;
             }
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: messagePrompt
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: messagePrompt });
+            if (result) {
                 await this.executeRemoveAction(args.options);
             }
         }

package/dist/m365/yammer/commands/message/message-like-set.js

@@ -29,14 +29,9 @@ class YammerMessageLikeSetCommand extends YammerCommand {
                 await this.executeLikeAction(args.options);
             }
             else {
-                const messagePrompt = `Are you sure you want to unlike message ${args.options.messageId}?`;
-                const result = await Cli.prompt({
-                    type: 'confirm',
-                    name: 'continue',
-                    default: false,
-                    message: messagePrompt
-                });
-                if (result.continue) {
+                const message = `Are you sure you want to unlike message ${args.options.messageId}?`;
+                const result = await Cli.promptForConfirmation({ message });
+                if (result) {
                     await this.executeLikeAction(args.options);
                 }
             }

package/dist/m365/yammer/commands/message/message-remove.js

@@ -27,13 +27,8 @@ class YammerMessageRemoveCommand extends YammerCommand {
             await this.removeMessage(args.options);
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the Yammer message ${args.options.id}?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the Yammer message ${args.options.id}?` });
+            if (result) {
                 await this.removeMessage(args.options);
             }
         }

package/dist/request.js

@@ -3,6 +3,7 @@ import { Stream } from 'stream';
 import auth, { Auth } from './Auth.js';
 import { app } from './utils/app.js';
 import { formatting } from './utils/formatting.js';
+import { timings } from './cli/timings.js';
 class Request {
     set debug(debug) {
         // if the value to set is the same as current value return early to avoid
@@ -125,6 +126,7 @@ class Request {
         return this.execute(options);
     }
     execute(options, resolve, reject) {
+        const start = process.hrtime.bigint();
         if (!this._logger) {
             return Promise.reject('Logger not set on the request object');
         }
@@ -159,6 +161,8 @@ class Request {
                     resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
                 else {
+                    const end = process.hrtime.bigint();
+                    timings.api.push(Number(end - start));
                     _resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
             }, (error) => {
@@ -181,6 +185,8 @@ class Request {
                         reject(error);
                     }
                     else {
+                        const end = process.hrtime.bigint();
+                        timings.api.push(Number(end - start));
                         _reject(error);
                     }
                 }

package/dist/utils/aadAdministrativeUnit.js

@@ -0,0 +1,25 @@
+import { odata } from "./odata.js";
+import { formatting } from "./formatting.js";
+import { Cli } from "../cli/Cli.js";
+const graphResource = 'https://graph.microsoft.com';
+export const aadAdministrativeUnit = {
+    /**
+     * Get an administrative unit by its display name.
+     * @param displayName Administrative unit display name.
+     * @returns The administrative unit.
+     * @throws Error when administrative unit was not found.
+     */
+    async getAdministrativeUnitByDisplayName(displayName) {
+        const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
+        if (administrativeUnits.length === 0) {
+            throw `The specified administrative unit '${displayName}' does not exist.`;
+        }
+        if (administrativeUnits.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', administrativeUnits);
+            const selectedAdministrativeUnit = await Cli.handleMultipleResultsFound(`Multiple administrative units with name '${displayName}' found.`, resultAsKeyValuePair);
+            return selectedAdministrativeUnit;
+        }
+        return administrativeUnits[0];
+    }
+};
+//# sourceMappingURL=aadAdministrativeUnit.js.map

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/dist/utils/prompt.js

@@ -1,16 +1,35 @@
-import { Cli } from '../cli/Cli.js';
 import { settingsNames } from '../settingsNames.js';
-let inquirer;
+import { Cli } from '../cli/Cli.js';
+let inquirerInput;
+let inquirerConfirm;
+let inquirerSelect;
 export const prompt = {
     /* c8 ignore next 10 */
-    async forInput(config, answers) {
-        if (!inquirer) {
-            inquirer = await import('inquirer');
+    async forInput(config) {
+        if (!inquirerInput) {
+            inquirerInput = await import('@inquirer/input');
+        }
+        const cli = Cli.getInstance();
+        const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
+        return inquirerInput.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+    },
+    /* c8 ignore next 10 */
+    async forConfirmation(config) {
+        if (!inquirerConfirm) {
+            inquirerConfirm = await import('@inquirer/confirm');
+        }
+        const cli = Cli.getInstance();
+        const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
+        return inquirerConfirm.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+    },
+    /* c8 ignore next 10 */
+    async forSelection(config) {
+        if (!inquirerSelect) {
+            inquirerSelect = await import('@inquirer/select');
         }
         const cli = Cli.getInstance();
         const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
-        const prompt = inquirer.createPromptModule({ output: errorOutput === 'stderr' ? process.stderr : process.stdout });
-        return await prompt(config, answers);
+        return inquirerSelect.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
     }
 };
 //# sourceMappingURL=prompt.js.map

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