@pnp/cli-microsoft365 10.5.0-beta.395d550 → 10.5.0-beta.63404d1

package/dist/m365/spo/commands/page/page-section-remove.js

@@ -0,0 +1,81 @@
+import { cli } from '../../../../cli/cli.js';
+import request from '../../../../request.js';
+import { spo } from '../../../../utils/spo.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+import { Page } from './Page.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+const options = globalOptionsZod
+    .extend({
+    webUrl: zod.alias('u', z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint Online site URL.`
+    }))),
+    pageName: zod.alias('n', z.string()),
+    section: zod.alias('s', z.number()),
+    force: zod.alias('f', z.boolean().optional())
+})
+    .strict();
+class SpoPageSectionRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.PAGE_SECTION_REMOVE;
+    }
+    get description() {
+        return 'Removes the specified section from the modern page';
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        if (args.options.force) {
+            await this.removeSection(logger, args);
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove section ${args.options.section} from '${args.options.pageName}'?` });
+            if (result) {
+                await this.removeSection(logger, args);
+            }
+        }
+    }
+    async removeSection(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Removing modern page section ${args.options.pageName} - ${args.options.section}...`);
+            }
+            const reqDigest = await spo.getRequestDigest(args.options.webUrl);
+            const clientSidePage = await Page.getPage(args.options.pageName, args.options.webUrl, logger, this.debug, this.verbose);
+            const sectionToDelete = clientSidePage.sections
+                .findIndex(section => section.order === args.options.section);
+            if (sectionToDelete === -1) {
+                throw new Error(`Section ${args.options.section} not found`);
+            }
+            clientSidePage.sections.splice(sectionToDelete, 1);
+            const updatedContent = clientSidePage.toHtml();
+            const requestOptions = {
+                url: `${args.options
+                    .webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${urlUtil.getServerRelativeSiteUrl(args.options.webUrl)}/sitepages/${args.options.pageName}')/ListItemAllFields`,
+                headers: {
+                    'X-RequestDigest': reqDigest.FormDigestValue,
+                    'content-type': 'application/json;odata=nometadata',
+                    'X-HTTP-Method': 'MERGE',
+                    'IF-MATCH': '*',
+                    accept: 'application/json;odata=nometadata'
+                },
+                data: {
+                    CanvasContent1: updatedContent
+                },
+                responseType: 'json'
+            };
+            return request.post(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoPageSectionRemoveCommand();
+//# sourceMappingURL=page-section-remove.js.map

package/dist/m365/spo/commands.js

@@ -116,6 +116,7 @@ export default {
     GROUP_MEMBER_REMOVE: `${prefix} group member remove`,
     HIDEDEFAULTTHEMES_GET: `${prefix} hidedefaultthemes get`,
     HIDEDEFAULTTHEMES_SET: `${prefix} hidedefaultthemes set`,
+    HOMESITE_ADD: `${prefix} homesite add`,
     HOMESITE_GET: `${prefix} homesite get`,
     HOMESITE_LIST: `${prefix} homesite list`,
     HOMESITE_REMOVE: `${prefix} homesite remove`,
@@ -221,6 +222,7 @@ export default {
     PAGE_SECTION_ADD: `${prefix} page section add`,
     PAGE_SECTION_GET: `${prefix} page section get`,
     PAGE_SECTION_LIST: `${prefix} page section list`,
+    PAGE_SECTION_REMOVE: `${prefix} page section remove`,
     PAGE_TEMPLATE_LIST: `${prefix} page template list`,
     PAGE_TEMPLATE_REMOVE: `${prefix} page template remove`,
     PAGE_TEXT_ADD: `${prefix} page text add`,

package/dist/m365/viva/commands/engage/engage-community-user-add.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import request from '../../../../request.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { formatting } from '../../../../utils/formatting.js';
+const options = globalOptionsZod
+    .extend({
+    communityId: z.string().optional(),
+    communityDisplayName: zod.alias('n', z.string().optional()),
+    entraGroupId: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    ids: z.string()
+        .refine(ids => validation.isValidGuidArray(ids) === true, invalidIds => ({
+        message: `The following GUIDs are invalid: ${invalidIds}.`
+    })).optional(),
+    userNames: z.string()
+        .refine(userNames => validation.isValidUserPrincipalNameArray(userNames) === true, invalidUserNames => ({
+        message: `The following user principal names are invalid: ${invalidUserNames}.`
+    })).optional(),
+    role: zod.alias('r', z.enum(['Admin', 'Member']))
+})
+    .strict();
+class VivaEngageCommunityUserAddCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_USER_ADD;
+    }
+    get description() {
+        return 'Adds a user to a specific Microsoft 365 Viva Engage community';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
+            message: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+        })
+            .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
+            message: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+        })
+            .refine(options => options.ids || options.userNames, {
+            message: 'Specify either of ids or userNames.'
+        })
+            .refine(options => typeof options.userNames !== undefined && typeof options.ids !== undefined, {
+            message: 'Specify either ids or userNames, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr('Adding users to community...');
+            }
+            let entraGroupId = args.options.entraGroupId;
+            if (args.options.communityDisplayName) {
+                const community = await vivaEngage.getCommunityByDisplayName(args.options.communityDisplayName, ['groupId']);
+                entraGroupId = community.groupId;
+            }
+            if (args.options.communityId) {
+                const community = await vivaEngage.getCommunityById(args.options.communityId, ['groupId']);
+                entraGroupId = community.groupId;
+            }
+            const userIds = args.options.ids ? formatting.splitAndTrim(args.options.ids) : await entraUser.getUserIdsByUpns(formatting.splitAndTrim(args.options.userNames));
+            const role = args.options.role === 'Member' ? 'members' : 'owners';
+            for (let i = 0; i < userIds.length; i += 400) {
+                const userIdsBatch = userIds.slice(i, i + 400);
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/$batch`,
+                    headers: {
+                        'content-type': 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json',
+                    data: {
+                        requests: []
+                    }
+                };
+                // only 20 requests per one batch are allowed
+                for (let j = 0; j < userIdsBatch.length; j += 20) {
+                    // only 20 users can be added in one request
+                    const userIdsChunk = userIdsBatch.slice(j, j + 20);
+                    requestOptions.data.requests.push({
+                        id: j + 1,
+                        method: 'PATCH',
+                        url: `/groups/${entraGroupId}`,
+                        headers: {
+                            'content-type': 'application/json;odata.metadata=none'
+                        },
+                        body: {
+                            [`${role}@odata.bind`]: userIdsChunk.map((u) => `${this.resource}/v1.0/directoryObjects/${u}`)
+                        }
+                    });
+                }
+                const res = await request.post(requestOptions);
+                for (const response of res.responses) {
+                    if (response.status !== 204) {
+                        throw response.body;
+                    }
+                }
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageCommunityUserAddCommand();
+//# sourceMappingURL=engage-community-user-add.js.map

package/dist/m365/viva/commands/engage/engage-community-user-remove.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import request from '../../../../request.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { cli } from '../../../../cli/cli.js';
+const options = globalOptionsZod
+    .extend({
+    communityId: z.string().optional(),
+    communityDisplayName: zod.alias('n', z.string().optional()),
+    entraGroupId: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    id: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    userName: z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), userName => ({
+        message: `'${userName}' is not a valid user principal name.`
+    })).optional(),
+    force: z.boolean().optional()
+})
+    .strict();
+class VivaEngageCommunityUserRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_USER_REMOVE;
+    }
+    get description() {
+        return 'Removes a specified user from a Microsoft 365 Viva Engage community';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
+            message: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+        })
+            .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
+            message: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+        })
+            .refine(options => options.id || options.userName, {
+            message: 'Specify either of id or userName.'
+        })
+            .refine(options => typeof options.userName !== undefined && typeof options.id !== undefined, {
+            message: 'Specify either id or userName, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (args.options.force) {
+                await this.deleteUserFromCommunity(args.options, logger);
+            }
+            else {
+                const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove the user ${args.options.id || args.options.userName} from the community ${args.options.communityDisplayName || args.options.communityId || args.options.entraGroupId}?` });
+                if (result) {
+                    await this.deleteUserFromCommunity(args.options, logger);
+                }
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async deleteUserFromCommunity(options, logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Removing user from community...');
+        }
+        let entraGroupId = options.entraGroupId;
+        if (options.communityDisplayName) {
+            const community = await vivaEngage.getCommunityByDisplayName(options.communityDisplayName, ['groupId']);
+            entraGroupId = community.groupId;
+        }
+        else if (options.communityId) {
+            const community = await vivaEngage.getCommunityById(options.communityId, ['groupId']);
+            entraGroupId = community.groupId;
+        }
+        const userId = options.id || await entraUser.getUserIdByUpn(options.userName);
+        await this.deleteUser(entraGroupId, userId, 'owners');
+        await this.deleteUser(entraGroupId, userId, 'members');
+    }
+    async deleteUser(entraGroupId, userId, role) {
+        try {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/groups/${entraGroupId}/${role}/${userId}/$ref`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            await request.delete(requestOptions);
+        }
+        catch (err) {
+            if (err.response.status !== 404) {
+                throw err.response.data;
+            }
+        }
+    }
+}
+export default new VivaEngageCommunityUserRemoveCommand();
+//# sourceMappingURL=engage-community-user-remove.js.map

package/dist/m365/viva/commands.js

@@ -5,7 +5,9 @@ export default {
     ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
     ENGAGE_COMMUNITY_LIST: `${prefix} engage community list`,
     ENGAGE_COMMUNITY_SET: `${prefix} engage community set`,
+    ENGAGE_COMMUNITY_USER_ADD: `${prefix} engage community user add`,
     ENGAGE_COMMUNITY_USER_LIST: `${prefix} engage community user list`,
+    ENGAGE_COMMUNITY_USER_REMOVE: `${prefix} engage community user remove`,
     ENGAGE_GROUP_LIST: `${prefix} engage group list`,
     ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,
     ENGAGE_GROUP_USER_REMOVE: `${prefix} engage group user remove`,

package/dist/request.js

@@ -132,6 +132,7 @@ class Request {
             throw 'Logger not set on the request object';
         }
         this.updateRequestForCloudType(options, auth.connection.cloudType);
+        this.removeDoubleSlashes(options);
         try {
             let accessToken = '';
             if (options.headers && options.headers['x-anonymous']) {
@@ -187,6 +188,10 @@ class Request {
         const cloudUrl = Auth.getEndpointForResource(hostname, cloudType);
         options.url = options.url.replace(hostname, cloudUrl);
     }
+    removeDoubleSlashes(options) {
+        options.url = options.url.substring(0, 8) +
+            options.url.substring(8).replace('//', '/');
+    }
     createProxyConfigFromUrl(url) {
         const parsedUrl = new URL(url);
         const port = parsedUrl.port || (url.toLowerCase().startsWith('https') ? 443 : 80);

package/dist/utils/directoryExtension.js

@@ -0,0 +1,25 @@
+import { formatting } from './formatting.js';
+import { odata } from './odata.js';
+export const directoryExtension = {
+    /**
+     * Get a directory extension by its name registered for an application.
+     * @param name Role definition display name.
+     * @param appObjectId Application object id.
+     * @param properties List of properties to include in the response.
+     * @returns The directory extensions.
+     * @throws Error when directory extension was not found.
+     */
+    async getDirectoryExtensionByName(name, appObjectId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications/${appObjectId}/extensionProperties?$filter=name eq '${formatting.encodeQueryParameter(name)}'`;
+        if (properties) {
+            url += `&$select=${properties.join(',')}`;
+        }
+        const extensionProperties = await odata.getAllItems(url);
+        if (extensionProperties.length === 0) {
+            throw `The specified directory extension '${name}' does not exist.`;
+        }
+        // there can be only one directory extension with a given name
+        return extensionProperties[0];
+    }
+};
+//# sourceMappingURL=directoryExtension.js.map

package/dist/utils/entraApp.js

@@ -1,6 +1,8 @@
 import fs from 'fs';
 import request from '../request.js';
 import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
 async function getCertificateBase64Encoded({ options, logger, debug }) {
     if (options.certificateBase64Encoded) {
         return options.certificateBase64Encoded;
@@ -278,6 +280,32 @@ export const entraApp = {
             await logger.logToStderr(`OAuth2 permissions: ${JSON.stringify(entraApp.appPermissions.flatMap(permission => permission.scope), null, 2)}`);
         }
         return resolvedApis;
+    },
+    async getAppRegistrationByAppId(appId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications?$filter=appId eq '${appId}'`;
+        if (properties) {
+            url += `&$select=${properties.join(',')}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `App with appId '${appId}' not found in Microsoft Entra ID`;
+        }
+        return apps[0];
+    },
+    async getAppRegistrationByAppName(appName, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications?$filter=displayName eq '${formatting.encodeQueryParameter(appName)}'`;
+        if (properties) {
+            url += `&$select=${properties.join(',')}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `App with name '${appName}' not found in Microsoft Entra ID`;
+        }
+        if (apps.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);
+            return await cli.handleMultipleResultsFound(`Multiple apps with name '${appName}' found in Microsoft Entra ID.`, resultAsKeyValuePair);
+        }
+        return apps[0];
     }
 };
 //# sourceMappingURL=entraApp.js.map

package/docs/docs/cmd/graph/directoryextension/directoryextension-add.mdx

@@ -0,0 +1,123 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension add
+
+Creates a new directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the directory extension.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--dataType <dataType>`
+: The data type of the value the extension property can hold. Possible values are: `Binary`, `Boolean`, `DateTime`, `Integer`, `LargeInteger` and `String`.
+
+`--targetObjects <targetObjects>`
+: Comma-separated list of Microsoft Graph resources that can use the extension. Possible values are: `User`, `Group`, `Application`, `AdministrativeUnit`, `Device` and `Organization`.
+
+`--isMultiValued`
+: Defines the directory extension as a multi-valued property.
+```
+
+<Global />
+
+## Examples
+
+Create a new directory extension of string type defined for user resource.
+
+```sh
+m365 graph directoryextension add --name gitHubWorkAccountName --appName ContosoApp --targetObjects User --dataType String
+```
+
+Create a new multi-valued directory extension of integer type defined for device and application resource
+
+```sh
+m365 graph directoryextension add --name departmentIds --appId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --targetObjects 'Application,Device' --dataType Integer --isMultiValued
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
+    "deletedDateTime": null,
+    "appDisplayName": "ContosoApp",
+    "dataType": "String",
+    "isMultiValued": false,
+    "isSyncedFromOnPremises": false,
+    "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
+    "targetObjects": [
+      "User"
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 01e77f60-3dde-4fa3-825b-cac8048994a8
+  isMultiValued         : false
+  isSyncedFromOnPremises: false
+  name                  : extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
+
+  Date: 9/8/2024
+
+  ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
+
+  Property | Value|
+  ---------|-------|
+  id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | false
+  isSyncedFromOnPremises | false
+  name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx

@@ -0,0 +1,118 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension get
+
+Retrieves the definition of a directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the directory extension. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: The name of the directory extension. Specify either `id` or `name`, but not both.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+```
+
+<Global />
+
+## Examples
+
+Get directory extension by id registered for an application specified by app id.
+
+```sh
+m365 directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+```
+
+Get directory extension by name registered for an application specified by name.
+
+```sh
+m365 directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
+```
+
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
+    "deletedDateTime": null,
+    "appDisplayName": "ContosoApp",
+    "dataType": "String",
+    "isMultiValued": false,
+    "isSyncedFromOnPremises": false,
+    "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
+    "targetObjects": [
+      "User"
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 01e77f60-3dde-4fa3-825b-cac8048994a8
+  isMultiValued         : false
+  isSyncedFromOnPremises: false
+  name                  : extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
+
+  Date: 3/2/2025
+
+  ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
+
+  Property | Value|
+  ---------|-------|
+  id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | false
+  isSyncedFromOnPremises | false
+  name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions