@pnp/cli-microsoft365 10.3.0-beta.ea113b7 → 10.3.0

package/dist/m365/spo/commands/list/list-defaultvalue-remove.js

@@ -0,0 +1,181 @@
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import commands from '../../commands.js';
+import { DOMParser } from '@xmldom/xmldom';
+import { validation } from '../../../../utils/validation.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { cli } from '../../../../cli/cli.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.`
+    }))),
+    listId: zod.alias('i', z.string().optional()
+        .refine(id => id === undefined || validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    }))),
+    listTitle: zod.alias('t', z.string().optional()),
+    listUrl: z.string().optional(),
+    fieldName: z.string(),
+    folderUrl: z.string().optional(),
+    force: zod.alias('f', z.boolean().optional())
+})
+    .strict();
+class SpoListDefaultValueRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.LIST_DEFAULTVALUE_REMOVE;
+    }
+    get description() {
+        return 'Removes a specific default column value for a specific document library';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.listId, options.listTitle, options.listUrl].filter(o => o !== undefined).length === 1, {
+            message: 'Use one of the following options: listId, listTitle, listUrl.'
+        });
+    }
+    async commandAction(logger, args) {
+        if (!args.options.force) {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove default column value '${args.options.fieldName}' from ${args.options.folderUrl ? `'${args.options.folderUrl}'` : 'the root of the list'}?` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Removing default column value '${args.options.fieldName}' from ${args.options.folderUrl ? `'${args.options.folderUrl}'` : 'the root of the list'}.`);
+                await logger.logToStderr(`Getting server-relative URL of the list...`);
+            }
+            const listServerRelUrl = await this.getServerRelativeListUrl(args.options);
+            let folderUrl = listServerRelUrl;
+            if (args.options.folderUrl) {
+                folderUrl = urlUtil.getServerRelativePath(args.options.webUrl, urlUtil.removeTrailingSlashes(args.options.folderUrl));
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Getting default column values...`);
+            }
+            const defaultValuesXml = await this.getDefaultColumnValuesXml(args.options.webUrl, listServerRelUrl);
+            const removeDefaultValueResult = this.removeFieldFromXml(defaultValuesXml, args.options.fieldName, folderUrl);
+            if (!removeDefaultValueResult.isFieldFound) {
+                throw `Default column value '${args.options.fieldName}' was not found.`;
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Uploading default column values to list...`);
+            }
+            await this.uploadDefaultColumnValuesXml(args.options.webUrl, listServerRelUrl, removeDefaultValueResult.xml);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getServerRelativeListUrl(options) {
+        const requestOptions = {
+            url: `${options.webUrl}/_api/Web`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        if (options.listUrl) {
+            const serverRelativeUrl = urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
+            requestOptions.url += `/GetList('${formatting.encodeQueryParameter(serverRelativeUrl)}')`;
+        }
+        else if (options.listId) {
+            requestOptions.url += `/Lists('${options.listId}')`;
+        }
+        else if (options.listTitle) {
+            requestOptions.url += `/Lists/GetByTitle('${formatting.encodeQueryParameter(options.listTitle)}')`;
+        }
+        requestOptions.url += '?$expand=RootFolder&$select=RootFolder/ServerRelativeUrl,BaseTemplate';
+        try {
+            const response = await request.get(requestOptions);
+            if (response.BaseTemplate !== 101) {
+                throw `The specified list is not a document library.`;
+            }
+            return response.RootFolder.ServerRelativeUrl;
+        }
+        catch (error) {
+            if (error.status === 404) {
+                throw `List '${options.listId || options.listTitle || options.listUrl}' was not found.`;
+            }
+            throw error;
+        }
+    }
+    async getDefaultColumnValuesXml(webUrl, listServerRelUrl) {
+        try {
+            const requestOptions = {
+                url: `${webUrl}/_api/Web/GetFileByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(listServerRelUrl + '/Forms/client_LocationBasedDefaults.html')}')/$value`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const defaultValuesXml = await request.get(requestOptions);
+            return defaultValuesXml;
+        }
+        catch (err) {
+            // For lists that have never had default column values set, the client_LocationBasedDefaults.html file does not exist.
+            if (err.status === 404) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    removeFieldFromXml(xml, fieldName, folderUrl) {
+        if (xml === null) {
+            return { isFieldFound: false };
+        }
+        // Encode all spaces in the folder URL
+        const encodedFolderUrl = folderUrl.replace(/ /g, '%20');
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        const folderLinks = doc.getElementsByTagName('a');
+        for (let i = 0; i < folderLinks.length; i++) {
+            const folderNode = folderLinks[i];
+            const folderNodeUrl = folderNode.getAttribute('href');
+            if (encodedFolderUrl.toLowerCase() !== folderNodeUrl.toLowerCase()) {
+                continue;
+            }
+            const defaultValues = folderNode.getElementsByTagName('DefaultValue');
+            for (let j = 0; j < defaultValues.length; j++) {
+                const defaultValueNode = defaultValues[j];
+                const defaultValueNodeField = defaultValueNode.getAttribute('FieldName');
+                if (defaultValueNodeField !== fieldName) {
+                    continue;
+                }
+                if (folderNode.childNodes.length === 1) {
+                    // No other default values found in the folder, let's remove the folder node
+                    folderNode.parentNode.removeChild(folderNode);
+                }
+                else {
+                    // Default value node found, let's remove it
+                    folderNode.removeChild(defaultValueNode);
+                }
+                return { isFieldFound: true, xml: doc.toString() };
+            }
+        }
+        return { isFieldFound: false };
+    }
+    async uploadDefaultColumnValuesXml(webUrl, listServerRelUrl, xml) {
+        const requestOptions = {
+            url: `${webUrl}/_api/Web/GetFileByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(listServerRelUrl + '/Forms/client_LocationBasedDefaults.html')}')/$value`,
+            headers: {
+                accept: 'application/json;odata=nometadata',
+                'content-type': 'text/plain'
+            },
+            responseType: 'json',
+            data: xml
+        };
+        await request.put(requestOptions);
+    }
+}
+export default new SpoListDefaultValueRemoveCommand();
+//# sourceMappingURL=list-defaultvalue-remove.js.map

package/dist/m365/spo/commands/list/list-defaultvalue-set.js

@@ -0,0 +1,210 @@
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import commands from '../../commands.js';
+import { DOMParser } from '@xmldom/xmldom';
+import { validation } from '../../../../utils/validation.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.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.`
+    }))),
+    listId: zod.alias('i', z.string().optional()
+        .refine(id => id === undefined || validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    }))),
+    listTitle: zod.alias('t', z.string().optional()),
+    listUrl: z.string().optional(),
+    fieldName: z.string(),
+    fieldValue: z.string()
+        .refine(value => value !== '', `The value cannot be empty. Use 'spo list defaultvalue remove' to remove a default column value.`),
+    folderUrl: z.string().optional()
+        .refine(url => url === undefined || (!url.includes('#') && !url.includes('%')), 'Due to limitations in SharePoint Online, setting default column values for folders with a # or % character in their path is not supported.')
+})
+    .strict();
+class SpoListDefaultValueSetCommand extends SpoCommand {
+    get name() {
+        return commands.LIST_DEFAULTVALUE_SET;
+    }
+    get description() {
+        return 'Sets default column values for a specific document library';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.listId, options.listTitle, options.listUrl].filter(o => o !== undefined).length === 1, {
+            message: 'Use one of the following options: listId, listTitle, listUrl.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Setting default column value '${args.options.fieldValue}' for field '${args.options.fieldName}'...`);
+                await logger.logToStderr(`Getting server-relative URL of the list...`);
+            }
+            const listServerRelUrl = await this.getServerRelativeListUrl(args.options);
+            let folderUrl = listServerRelUrl;
+            if (args.options.folderUrl) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Getting server-relative URL of folder '${args.options.folderUrl}'...`);
+                }
+                // Casing of the folder URL is important, let's retrieve the correct URL
+                const serverRelativeFolderUrl = urlUtil.getServerRelativePath(args.options.webUrl, urlUtil.removeTrailingSlashes(args.options.folderUrl));
+                folderUrl = await this.getCorrectFolderUrl(args.options.webUrl, serverRelativeFolderUrl);
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Getting default column values...`);
+            }
+            const defaultValuesXml = await this.ensureDefaultColumnValuesXml(args.options.webUrl, listServerRelUrl);
+            const modifiedXml = await this.updateFieldValueXml(logger, defaultValuesXml, args.options.fieldName, args.options.fieldValue, folderUrl);
+            await this.uploadDefaultColumnValuesXml(logger, args.options.webUrl, listServerRelUrl, modifiedXml);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getServerRelativeListUrl(options) {
+        const requestOptions = {
+            url: `${options.webUrl}/_api/Web`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        if (options.listUrl) {
+            const serverRelativeUrl = urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
+            requestOptions.url += `/GetList('${formatting.encodeQueryParameter(serverRelativeUrl)}')`;
+        }
+        else if (options.listId) {
+            requestOptions.url += `/Lists('${options.listId}')`;
+        }
+        else if (options.listTitle) {
+            requestOptions.url += `/Lists/GetByTitle('${formatting.encodeQueryParameter(options.listTitle)}')`;
+        }
+        requestOptions.url += '?$expand=RootFolder&$select=RootFolder/ServerRelativeUrl,BaseTemplate';
+        try {
+            const response = await request.get(requestOptions);
+            if (response.BaseTemplate !== 101) {
+                throw `The specified list is not a document library.`;
+            }
+            return response.RootFolder.ServerRelativeUrl;
+        }
+        catch (error) {
+            if (error.status === 404) {
+                throw `List '${options.listId || options.listTitle || options.listUrl}' was not found.`;
+            }
+            throw error;
+        }
+    }
+    async getCorrectFolderUrl(webUrl, folderUrl) {
+        const requestOptions = {
+            // Using ListItemAllFields endpoint because GetFolderByServerRelativePath doesn't return the correctly cased URL
+            url: `${webUrl}/_api/Web/GetFolderByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(folderUrl)}')/ListItemAllFields?$select=FileRef`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const response = await request.get(requestOptions);
+        if (!response.FileRef) {
+            throw `Folder '${folderUrl}' was not found.`;
+        }
+        return response.FileRef;
+    }
+    async ensureDefaultColumnValuesXml(webUrl, listServerRelUrl) {
+        try {
+            const requestOptions = {
+                url: `${webUrl}/_api/Web/GetFileByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(listServerRelUrl + '/Forms/client_LocationBasedDefaults.html')}')/$value`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const defaultValuesXml = await request.get(requestOptions);
+            return defaultValuesXml;
+        }
+        catch (err) {
+            if (err.status !== 404) {
+                throw err;
+            }
+            // For lists that have never had default column values set, the client_LocationBasedDefaults.html file does not exist.
+            // In this case, we need to create the file with blank default metadata.
+            const requestOptions = {
+                url: `${webUrl}/_api/Web/GetFolderByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(listServerRelUrl + '/Forms')}')/Files/Add(url='client_LocationBasedDefaults.html', overwrite=false)`,
+                headers: {
+                    accept: 'application/json;odata=nometadata',
+                    'content-type': 'text/plain'
+                },
+                responseType: 'json',
+                data: '<MetadataDefaults />'
+            };
+            await request.post(requestOptions);
+            return requestOptions.data;
+        }
+    }
+    async updateFieldValueXml(logger, xml, fieldName, fieldValue, folderUrl) {
+        if (this.verbose) {
+            await logger.logToStderr(`Modifying default column values...`);
+        }
+        // Encode all spaces in the folder URL
+        const encodedFolderUrl = folderUrl.replace(/ /g, '%20');
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        // Create a new DefaultValue node
+        const newDefaultValueNode = doc.createElement('DefaultValue');
+        newDefaultValueNode.setAttribute('FieldName', fieldName);
+        newDefaultValueNode.textContent = fieldValue;
+        const folderLinks = doc.getElementsByTagName('a');
+        for (let i = 0; i < folderLinks.length; i++) {
+            const folderNode = folderLinks[i];
+            const folderNodeUrl = folderNode.getAttribute('href');
+            if (encodedFolderUrl !== folderNodeUrl) {
+                continue;
+            }
+            const defaultValues = folderNode.getElementsByTagName('DefaultValue');
+            for (let j = 0; j < defaultValues.length; j++) {
+                const defaultValueNode = defaultValues[j];
+                const defaultValueNodeField = defaultValueNode.getAttribute('FieldName');
+                if (defaultValueNodeField !== fieldName) {
+                    continue;
+                }
+                // Default value node found, let's update the value
+                defaultValueNode.textContent = fieldValue;
+                return doc.toString();
+            }
+            // Default value node not found, let's create it
+            folderNode.appendChild(newDefaultValueNode);
+            return doc.toString();
+        }
+        // Folder node was not found, let's create it
+        const newFolderNode = doc.createElement('a');
+        newFolderNode.setAttribute('href', encodedFolderUrl);
+        newFolderNode.appendChild(newDefaultValueNode);
+        doc.documentElement.appendChild(newFolderNode);
+        return doc.toString();
+    }
+    async uploadDefaultColumnValuesXml(logger, webUrl, listServerRelUrl, xml) {
+        if (this.verbose) {
+            await logger.logToStderr(`Uploading default column values to list...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/Web/GetFileByServerRelativePath(decodedUrl='${formatting.encodeQueryParameter(listServerRelUrl + '/Forms/client_LocationBasedDefaults.html')}')/$value`,
+            headers: {
+                accept: 'application/json;odata=nometadata',
+                'content-type': 'text/plain'
+            },
+            responseType: 'json',
+            data: xml
+        };
+        await request.put(requestOptions);
+    }
+}
+export default new SpoListDefaultValueSetCommand();
+//# sourceMappingURL=list-defaultvalue-set.js.map

package/dist/m365/spo/commands.js

@@ -137,7 +137,10 @@ export default {
     LIST_CONTENTTYPE_LIST: `${prefix} list contenttype list`,
     LIST_CONTENTTYPE_REMOVE: `${prefix} list contenttype remove`,
     LIST_CONTENTTYPE_DEFAULT_SET: `${prefix} list contenttype default set`,
+    LIST_DEFAULTVALUE_CLEAR: `${prefix} list defaultvalue clear`,
     LIST_DEFAULTVALUE_LIST: `${prefix} list defaultvalue list`,
+    LIST_DEFAULTVALUE_REMOVE: `${prefix} list defaultvalue remove`,
+    LIST_DEFAULTVALUE_SET: `${prefix} list defaultvalue set`,
     LIST_GET: `${prefix} list get`,
     LIST_LIST: `${prefix} list list`,
     LIST_REMOVE: `${prefix} list remove`,

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

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import request from '../../../../request.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+const options = globalOptionsZod
+    .extend({
+    enabled: zod.alias('e', z.boolean())
+})
+    .strict();
+class TenantPeoplePronounsSetCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PRONOUNS_SET;
+    }
+    get description() {
+        return 'Manage pronouns settings for an organization';
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr('Updating pronouns settings...');
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/people/pronouns`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                data: {
+                    isEnabledInOrganization: args.options.enabled
+                },
+                responseType: 'json'
+            };
+            const pronouns = await request.patch(requestOptions);
+            await logger.log(pronouns);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new TenantPeoplePronounsSetCommand();
+//# sourceMappingURL=people-pronouns-set.js.map

package/dist/m365/tenant/commands/report/report-settings-set.js

@@ -0,0 +1,47 @@
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+const options = globalOptionsZod
+    .extend({
+    displayConcealedNames: zod.alias('d', z.boolean())
+})
+    .strict();
+class TenantReportSettingsSetCommand extends GraphCommand {
+    get name() {
+        return commands.REPORT_SETTINGS_SET;
+    }
+    get description() {
+        return 'Update tenant-level settings for Microsoft 365 reports';
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        try {
+            const { displayConcealedNames } = args.options;
+            if (this.verbose) {
+                await logger.logToStderr(`Updating report setting displayConcealedNames to ${displayConcealedNames}`);
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/reportSettings`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json'
+                },
+                responseType: 'json',
+                data: {
+                    displayConcealedNames
+                }
+            };
+            await request.patch(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new TenantReportSettingsSetCommand();
+//# sourceMappingURL=report-settings-set.js.map

package/dist/m365/tenant/commands.js

@@ -8,12 +8,14 @@ export default {
     PEOPLE_PROFILECARDPROPERTY_REMOVE: `${prefix} people profilecardproperty remove`,
     PEOPLE_PROFILECARDPROPERTY_SET: `${prefix} people profilecardproperty set`,
     PEOPLE_PRONOUNS_GET: `${prefix} people pronouns get`,
+    PEOPLE_PRONOUNS_SET: `${prefix} people pronouns set`,
     REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
     REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
     REPORT_OFFICE365ACTIVATIONCOUNTS: `${prefix} report office365activationcounts`,
     REPORT_OFFICE365ACTIVATIONSUSERDETAIL: `${prefix} report office365activationsuserdetail`,
     REPORT_OFFICE365ACTIVATIONSUSERCOUNTS: `${prefix} report office365activationsusercounts`,
     REPORT_SERVICESUSERCOUNTS: `${prefix} report servicesusercounts`,
+    REPORT_SETTINGS_SET: `${prefix} report settings set`,
     SECURITY_ALERTS_LIST: `${prefix} security alerts list`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_GET: `${prefix} serviceannouncement healthissue get`,
     SERVICEANNOUNCEMENT_HEALTH_GET: `${prefix} serviceannouncement health get`,

package/docs/docs/cmd/entra/app/app-add.mdx

@@ -31,7 +31,7 @@ m365 entra appregistration add [options]
 : Comma-separated list of redirect URIs. Requires `platform` to be specified.
 
 `-p, --platform [platform]`
-: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`.
+: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`. Requires `redirectUris` to be specified.
 
 `--implicitFlow`
 : Specify, to indicate that the authorization endpoint should return ID and access tokens.

package/docs/docs/cmd/entra/roledefinition/roledefinition-add.mdx

@@ -0,0 +1,131 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roledefinition add
+
+Creates a custom Microsoft Entra ID role definition
+
+## Usage
+
+```sh
+m365 entra roledefinition add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --displayName <displayName>`
+: The display name for the role definition.
+
+`-a, --allowedResourceActions <allowedResourceActions>`	
+: Comma-separated list of resource actions allowed for the role.
+
+`-d, --description [description]`
+: The description for the role definition.
+
+`-e, --enabled [enabled]`
+: Indicates if the role is enabled for the assignment. If not specified, the role is enabled by default.
+
+`-v, --version [version]`
+: The version of the role definition.
+```
+
+<Global />
+
+## Remarks
+
+Use the `m365 entra rolepermission list --resourceNamespace microsoft.directory` command to get a list of available resource actions.
+
+## Examples
+
+Create a custom Microsoft Entra ID role
+
+```sh
+m365 entra roledefinition add --displayName 'Application Remover' --description 'Allows to remove any Entra ID application' --allowedResourceActions 'microsoft.directory/applications/delete'
+```
+
+Create a custom Microsoft Entra ID role, but disable it for the assignment
+
+```sh
+m365 entra roledefinition add --displayName 'Application Remover' --version '1.0' --enabled false --allowedResourceActions 'microsoft.directory/applications/delete,microsoft.directory/applications/owners/update'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "3844129d-f748-4c03-8165-4412ee9b4ceb",
+    "description": null,
+    "displayName": "Custom Role",
+    "isBuiltIn": false,
+    "isEnabled": true,
+    "resourceScopes": [
+      "/"
+    ],
+    "templateId": "3844129d-f748-4c03-8165-4412ee9b4ceb",
+    "version": "1",
+    "rolePermissions": [
+      {
+        "allowedResourceActions": [
+          "microsoft.directory/groups.unified/create",
+          "microsoft.directory/groups.unified/delete"
+        ],
+        "condition": null
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  description    : null
+  displayName    : Custom Role
+  id             : 3844129d-f748-4c03-8165-4412ee9b4ceb
+  isBuiltIn      : false
+  isEnabled      : true
+  resourceScopes : ["/"]
+  rolePermissions: [{"allowedResourceActions":["microsoft.directory/groups.unified/create","microsoft.directory/groups.unified/delete"],"condition":null}]
+  templateId     : 3844129d-f748-4c03-8165-4412ee9b4ceb
+  version        : 1
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,description,displayName,isBuiltIn,isEnabled,templateId,version
+  3844129d-f748-4c03-8165-4412ee9b4ceb,,Custom Role,0,1,3844129d-f748-4c03-8165-4412ee9b4ceb,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roledefinition add --displayName "Custom Role" --allowedResourceActions "microsoft.directory/groups.unified/create,microsoft.directory/groups.unified/delete" --version 1
+
+  Date: 12/15/2024
+
+  ## Custom Role (3844129d-f748-4c03-8165-4412ee9b4ceb)
+
+  Property | Value
+  ---------|-------
+  id | 3844129d-f748-4c03-8165-4412ee9b4ceb
+  displayName | Custom Role
+  isBuiltIn | false
+  isEnabled | true
+  templateId | 3844129d-f748-4c03-8165-4412ee9b4ceb
+  version | 1
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/api/rbacapplication-post-roledefinitions