@pnp/cli-microsoft365 10.9.0-beta.bc13e90 → 10.10.0-beta.1bb5ba0

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

@@ -0,0 +1,99 @@
+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 _VivaEngageCommunityRemoveCommand_instances, _VivaEngageCommunityRemoveCommand_initTelemetry, _VivaEngageCommunityRemoveCommand_initOptions, _VivaEngageCommunityRemoveCommand_initValidators, _VivaEngageCommunityRemoveCommand_initOptionSets, _VivaEngageCommunityRemoveCommand_initTypes;
+import { cli } from '../../../../cli/cli.js';
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+class VivaEngageCommunityRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_REMOVE;
+    }
+    get description() {
+        return 'Removes a Viva Engage community';
+    }
+    constructor() {
+        super();
+        _VivaEngageCommunityRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityRemoveCommand_instances, "m", _VivaEngageCommunityRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityRemoveCommand_instances, "m", _VivaEngageCommunityRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityRemoveCommand_instances, "m", _VivaEngageCommunityRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityRemoveCommand_instances, "m", _VivaEngageCommunityRemoveCommand_initOptionSets).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityRemoveCommand_instances, "m", _VivaEngageCommunityRemoveCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        const removeCommunity = async () => {
+            try {
+                let communityId = args.options.id;
+                if (args.options.displayName) {
+                    communityId = (await vivaEngage.getCommunityByDisplayName(args.options.displayName, ['id'])).id;
+                }
+                else if (args.options.entraGroupId) {
+                    communityId = (await vivaEngage.getCommunityByEntraGroupId(args.options.entraGroupId, ['id'])).id;
+                }
+                if (args.options.verbose) {
+                    await logger.logToStderr(`Removing Viva Engage community with ID ${communityId}...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/employeeExperience/communities/${communityId}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    }
+                };
+                await request.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeCommunity();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove Viva Engage community '${args.options.id || args.options.displayName || args.options.entraGroupId}'?` });
+            if (result) {
+                await removeCommunity();
+            }
+        }
+    }
+}
+_VivaEngageCommunityRemoveCommand_instances = new WeakSet(), _VivaEngageCommunityRemoveCommand_initTelemetry = function _VivaEngageCommunityRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            id: args.options.id !== 'undefined',
+            displayName: args.options.displayName !== 'undefined',
+            entraGroupId: args.options.entraGroupId !== 'undefined',
+            force: !!args.options.force
+        });
+    });
+}, _VivaEngageCommunityRemoveCommand_initOptions = function _VivaEngageCommunityRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --id [id]'
+    }, {
+        option: '-n, --displayName [displayName]'
+    }, {
+        option: '--entraGroupId [entraGroupId]'
+    }, {
+        option: '-f, --force'
+    });
+}, _VivaEngageCommunityRemoveCommand_initValidators = function _VivaEngageCommunityRemoveCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.entraGroupId && !validation.isValidGuid(args.options.entraGroupId)) {
+            return `${args.options.entraGroupId} is not a valid GUID for the option 'entraGroupId'.`;
+        }
+        return true;
+    });
+}, _VivaEngageCommunityRemoveCommand_initOptionSets = function _VivaEngageCommunityRemoveCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['id', 'displayName', 'entraGroupId']
+    });
+}, _VivaEngageCommunityRemoveCommand_initTypes = function _VivaEngageCommunityRemoveCommand_initTypes() {
+    this.types.string.push('id', 'displayName', 'entraGroupId');
+};
+export default new VivaEngageCommunityRemoveCommand();
+//# sourceMappingURL=engage-community-remove.js.map

package/dist/m365/viva/commands/engage/engage-network-list.js

@@ -24,6 +24,9 @@ class VivaEngageNetworkListCommand extends VivaEngageCommand {
         __classPrivateFieldGet(this, _VivaEngageNetworkListCommand_instances, "m", _VivaEngageNetworkListCommand_initOptions).call(this);
     }
     async commandAction(logger, args) {
+        if (args.options.includeSuspended) {
+            await this.warn(logger, `Parameter 'includeSuspended' is deprecated. Please use 'withSuspended' instead`);
+        }
         const requestOptions = {
             url: `${this.resource}/v1/networks/current.json`,
             headers: {
@@ -32,7 +35,7 @@ class VivaEngageNetworkListCommand extends VivaEngageCommand {
             },
             responseType: 'json',
             data: {
-                includeSuspended: args.options.includeSuspended !== undefined && args.options.includeSuspended !== false
+                includeSuspended: (args.options.includeSuspended !== undefined && args.options.includeSuspended !== false) || (args.options.withSuspended !== undefined && args.options.withSuspended !== false)
             }
         };
         try {
@@ -47,12 +50,15 @@ class VivaEngageNetworkListCommand extends VivaEngageCommand {
 _VivaEngageNetworkListCommand_instances = new WeakSet(), _VivaEngageNetworkListCommand_initTelemetry = function _VivaEngageNetworkListCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
-            includeSuspended: args.options.includeSuspended
+            includeSuspended: args.options.includeSuspended,
+            withSuspended: args.options.withSuspended
         });
     });
 }, _VivaEngageNetworkListCommand_initOptions = function _VivaEngageNetworkListCommand_initOptions() {
     this.options.unshift({
         option: '--includeSuspended'
+    }, {
+        option: '--withSuspended'
     });
 };
 export default new VivaEngageNetworkListCommand();

package/dist/m365/viva/commands.js

@@ -4,6 +4,7 @@ export default {
     ENGAGE_COMMUNITY_ADD: `${prefix} engage community add`,
     ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
     ENGAGE_COMMUNITY_LIST: `${prefix} engage community list`,
+    ENGAGE_COMMUNITY_REMOVE: `${prefix} engage community remove`,
     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`,

package/dist/utils/entraServicePrincipal.js

@@ -1,6 +1,7 @@
 import { odata } from './odata.js';
 import { formatting } from './formatting.js';
 import { cli } from '../cli/cli.js';
+import request from '../request.js';
 export const entraServicePrincipal = {
     /**
      * Get service principal by its appId
@@ -52,6 +53,26 @@ export const entraServicePrincipal = {
             url += `?$select=${properties}`;
         }
         return odata.getAllItems(url);
+    },
+    /**
+     * Create a new service principal for the specified application.
+     * @param appId Application ID of the application for which to create a service principal.
+     * @returns The created service principal.
+     */
+    async createServicePrincipal(appId) {
+        const url = `https://graph.microsoft.com/v1.0/servicePrincipals`;
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none',
+                'content-type': 'application/json;odata=nometadata'
+            },
+            data: {
+                appId
+            },
+            responseType: 'json'
+        };
+        return await request.post(requestOptions);
     }
 };
 //# sourceMappingURL=entraServicePrincipal.js.map

package/dist/utils/md.js

@@ -13,8 +13,8 @@ function convertHeadings(md) {
     });
 }
 function convertAdmonitions(md) {
-    const regex = new RegExp(/^:::(\w+)(?:\[([^\]]+)\])?([\s\S]*?):::$/, 'gm');
-    return md.replace(regex, (_, label, title, content) => label.toLocaleUpperCase() + (title ? EOL + EOL + title : '') + EOL + EOL + content.trim());
+    const regex = new RegExp(/^([ \t]*):::(\w+)(?:\[([^\]]+)\])?([\s\S]*?)^\1:::$/, 'gm');
+    return md.replace(regex, (_, indent, label, title, content) => indent + label.toLocaleUpperCase() + (title ? EOL + EOL + indent + title : '') + EOL + EOL + indent + content.trim());
 }
 function includeContent(md, rootFolder) {
     const mdxImports = [
@@ -49,7 +49,7 @@ function convertHyperlinks(md) {
 function convertContentTabs(md) {
     return md
         .replace(/<TabItem value="([^"]+)">/gm, '$1')
-        .replace(/.*<\/?(Tabs|TabItem)>.*\n?/g, '')
+        .replace(/.*\n?<\/?(Tabs|TabItem)>.*\n?/g, '')
         .replace(/```(?:\w+)?\s*([\s\S]*?)\s*```/g, '$1')
         .trim();
 }

package/dist/utils/spo.js

@@ -1403,13 +1403,13 @@ export const spo = {
         await request.post(requestOptions);
     },
     /**
-     * Retrieves the site ID for a given web URL.
+     * Retrieves the site ID for a given web URL by the MS Graph.
      * @param webUrl The web URL for which to retrieve the site ID.
      * @param logger The logger object.
      * @param verbose Set for verbose logging
-     * @returns A promise that resolves to the site ID.
+     * @returns The site ID as a string.
      */
-    async getSiteId(webUrl, logger, verbose) {
+    async getSiteIdByMSGraph(webUrl, logger, verbose) {
         if (verbose && logger) {
             await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
         }
@@ -1424,6 +1424,90 @@ export const spo = {
         const site = await request.get(requestOptions);
         return site.id;
     },
+    /**
+     * Retrieves the SharePoint Online site ID for the specified web URL by the SharePoint REST API.
+     * @param webUrl The web URL of the SharePoint Online site to retrieve the site ID for.
+     * @param logger The logger object.
+     * @param verbose Set for verbose logging
+     * @returns The site ID as a string.
+     */
+    async getSiteIdBySPApi(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/site?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const siteResponse = await request.get(requestOptions);
+        return siteResponse.Id;
+    },
+    /**
+     * Retrieves the id of a SharePoint web for the specified web URL.
+     * @param webUrl The web URL for which to retrieve the web ID.
+     * @param logger The logger object for logging messages.
+     * @param verbose Set to true for verbose logging.
+     * @returns The web ID as a string.
+     */
+    async getWebId(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting web id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/web?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const webResponse = await request.get(requestOptions);
+        return webResponse.Id;
+    },
+    /**
+     * Retrieves the ID of a SharePoint list by its title or URL.
+     * @param webUrl The base URL of the SharePoint site.
+     * @param listTitle The title of the list (optional).
+     * @param listUrl The server-relative URL of the list (optional).
+     * @param logger The logger object for logging messages (optional).
+     * @param verbose Set to true for verbose logging (optional).
+     * @returns The list ID as a string.
+     */
+    async getListId(webUrl, listTitle, listUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving list id...`);
+        }
+        if (!listTitle && !listUrl) {
+            throw new Error('Either listTitle or listUrl must be provided.');
+        }
+        let listId = '';
+        if (listTitle) {
+            const requestOptions = {
+                url: `${webUrl}/_api/web/lists/getByTitle('${formatting.encodeQueryParameter(listTitle)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        else if (listUrl) {
+            const listServerRelativeUrl = urlUtil.getServerRelativePath(webUrl, listUrl);
+            const requestOptions = {
+                url: `${webUrl}/_api/web/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        return listId;
+    },
     /**
      * Retrieves the server-relative URL of a folder.
      * @param webUrl Web URL

package/docs/docs/cmd/_global.mdx

@@ -1,6 +1,6 @@
 ```md definition-list
 `-h, --help [help]`
-: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `response`, `full`. Default is `options`.
+: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `permissions`, `response`, `full`. Default is `options`.
 
 `--query [query]`
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.

package/docs/docs/cmd/entra/m365group/m365group-get.mdx

@@ -22,29 +22,32 @@ m365 entra m365group get [options]
 : Display name of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
 
 `--includeSiteUrl`
-: Set to retrieve the site URL for the group
+: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for the group.
+
+`--withSiteUrl`
+: Set to retrieve the site URL for the group.
 ```
 
 <Global />
 
 ## Examples
 
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_.
 
 ```sh
 m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
-Get information about the Microsoft 365 Group with displayName _Finance_
+Get information about the Microsoft 365 Group with displayName _Finance_.
 
 ```sh
 m365 entra m365group get --displayName Finance
 ```
 
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site
+Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site.
 
 ```sh
-m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSiteUrl
+m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --withSiteUrl
 ```
 
 ## Response

package/docs/docs/cmd/entra/m365group/m365group-list.mdx

@@ -16,54 +16,56 @@ m365 entra m365group list [options]
 
 ```md definition-list
 `-d, --displayName [displayName]`
-: Retrieve only groups with displayName starting with the specified value
+: Retrieve only groups with displayName starting with the specified value.
 
 `-m, --mailNickname [displayName]`
-: Retrieve only groups with mailNickname starting with the specified value
+: Retrieve only groups with mailNickname starting with the specified value.
 
 `--includeSiteUrl`
-: Set to retrieve the site URL for each group
+: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for each group.
+
+`--withSiteUrl`
+: Set to retrieve the site URL for each group.
 
 `--orphaned`
-: Set to only retrieve groups without owners
+: Set to only retrieve groups without owners.
 ```
 
 <Global />
 
 ## Remarks
 
-Using the `--includeSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
+Using the `--withSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
 
 Using the `--orphaned` option, you can retrieve Microsoft 365 Groups without owners.
 
 ## Examples
 
-List all Microsoft 365 Groups in the tenant
+List all Microsoft 365 Groups in the tenant.
 
 ```sh
 m365 entra m365group list
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_
+List Microsoft 365 Groups with display name starting with _Project_.
 
 ```sh
 m365 entra m365group list --displayName Project
 ```
 
-List Microsoft 365 Groups mail nick name starting with _team_
+List Microsoft 365 Groups mail nick name starting with _team_.
 
 ```sh
 m365 entra m365group list --mailNickname team
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_ including
-the URL of the corresponding SharePoint site
+List Microsoft 365 Groups with display name starting with _Project_ including the URL of the corresponding SharePoint site.
 
 ```sh
-m365 entra m365group list --displayName Project --includeSiteUrl
+m365 entra m365group list --displayName Project --withSiteUrl
 ```
 
-List Microsoft 365 Groups without owners
+List Microsoft 365 Groups without owners.
 
 ```sh
 m365 entra m365group list --orphaned

package/docs/docs/cmd/entra/organization/organization-set.mdx

@@ -0,0 +1,84 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra organization set
+
+Updates info about the organization
+
+## Usage
+
+```sh
+m365 entra organization set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the organization. Specify either `id` or `displayName`, but not both.
+
+`-d, --displayName [displayName]`
+: The name of the organization. Specify either `id` or `displayName`, but not both.
+
+`--marketingNotificationEmails [marketingNotificationEmails]`
+: The comma separated list of marketing notification emails.
+
+`--securityComplianceNotificationMails [securityComplianceNotificationMails]`
+: The comma separated list of security compliance notification emails.
+
+`--securityComplianceNotificationPhones [securityComplianceNotificationPhones]`
+: The comma separated list of security compliance notification phones.
+
+`--technicalNotificationMails [technicalNotificationMails]`
+: The comma separated list of technical notification emails.
+
+`--contactEmail [contactEmail]`
+: A valid smtp email address for the privacy statement contact
+
+`--statementUrl [statementUrl]`
+: The URL that directs to the company's privacy statement
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                      |
+  |-----------------|--------------------------------------------------|
+  | Microsoft Graph | Organization.ReadWrite.All                       |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                              |
+  |-----------------|----------------------------------------------------------|
+  | Microsoft Graph | Organization.ReadWrite.All                              |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Updates properties of an organization specified by id
+
+```sh
+m365 entra organization set --id 84841066-274d-4ec0-a5c1-276be684bdd3 --marketingNotificationEmails 'marketing@contoso.com'
+```
+
+Updates properties of an organization specified by displayName
+
+```sh
+m365 entra organization set --displayName Contoso --marketingNotificationEmails 'marketing@contoso.com'
+```
+
+## Response
+
+The command won't return a response on success
+
+## More information
+
+- Organization: https://learn.microsoft.com/graph/api/organization-update

package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx

@@ -28,6 +28,9 @@ m365 entra pim role assignment eligibility list [options]
 : Display name of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were eligible for a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were eligible for a role.
 ```
 
@@ -50,7 +53,7 @@ m365 entra pim role assignment eligibility list --userId '@meID'
 Get a list of eligible roles for any user with principal details.
 
 ```sh
-m365 entra pim role assignment eligibility list --includePrincipalDetails
+m365 entra pim role assignment eligibility list --withPrincipalDetails
 ```
 
 ## Response
@@ -121,9 +124,9 @@ m365 entra pim role assignment eligibility list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -183,7 +186,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment eligibility list --includePrincipalDetails "true"
+  # entra pim role assignment eligibility list --withPrincipalDetails "true"
 
   Date: 4/8/2024
 

package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx

@@ -31,7 +31,10 @@ m365 entra pim role assignment list [options]
 : An optional ISO 8601 formatted date filter to search from.
 
 `--includePrincipalDetails`
-: An optional flag to include details of the principals that were assigned a role
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
+: An optional flag to include details of the principals that were assigned a role.
 ```
 
 <Global />
@@ -50,7 +53,7 @@ Get a list of Entra role assignments for the current user.
 m365 entra pim role assignment list --userId '@meID'
 ```
 
-Get a list of Entra role assignments since the first of January 2024
+Get a list of Entra role assignments since the first of January 2024.
 
 ```sh
 m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
@@ -59,7 +62,7 @@ m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
 Get a list of Entra role assignments with principal details.
 
 ```sh
-m365 entra pim role assignment list --includePrincipalDetails
+m365 entra pim role assignment list --withPrincipalDetails
 ```
 
 ## Response
@@ -135,9 +138,9 @@ m365 entra pim role assignment list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -201,7 +204,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment list --includePrincipalDetails "true"
+  # entra pim role assignment list --withPrincipalDetails "true"
 
   Date: 3/31/2024
 

package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx

@@ -34,6 +34,9 @@ m365 entra pim role request list [options]
 : An optional value to filter the list of requests. Allowed values are: `Canceled`, `Denied`, `Failed`, `Granted`, `PendingAdminDecision`, `PendingApproval`, `PendingProvisioning`, `PendingScheduleCreation`, `Provisioned`, `Revoked`, and `ScheduleCreated`.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were assigned a role.
 ```
 
@@ -62,7 +65,7 @@ m365 entra pim role request list --createdDateTime 2024-01-01T00:00:00Z
 Get a list of PIM requests with principal details.
 
 ```sh
-m365 entra pim role request list --includePrincipalDetails
+m365 entra pim role request list --withPrincipalDetails
 ```
 
 Get a list of PIM requests with pending approvals.
@@ -158,9 +161,9 @@ m365 entra pim role request list --status PendingApproval
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -238,7 +241,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role request list --includePrincipalDetails "true"
+  # entra pim role request list --withPrincipalDetails "true"
 
   Date: 5/30/2024