@pnp/cli-microsoft365 10.3.0-beta.d1b978f → 10.3.0-beta.df85113

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

@@ -0,0 +1,29 @@
+import { cli } from '../cli/cli.js';
+import { formatting } from './formatting.js';
+import { odata } from './odata.js';
+export const customAppScope = {
+    /**
+     * Get a custom application scope by its name
+     * @param displayName Custom application scope display name.
+     * @param properties Comma-separated list of properties to include in the response.
+     * @returns The custom application scope.
+     * @throws Error when role definition was not found.
+     */
+    async getCustomAppScopeByDisplayName(displayName, properties) {
+        let url = `https://graph.microsoft.com/beta/roleManagement/exchange/customAppScopes?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const customAppScopes = await odata.getAllItems(url);
+        if (customAppScopes.length === 0) {
+            throw `The specified custom application scope '${displayName}' does not exist.`;
+        }
+        if (customAppScopes.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', customAppScopes);
+            const selectedCustomAppScope = await cli.handleMultipleResultsFound(`Multiple custom application scopes with name '${displayName}' found.`, resultAsKeyValuePair);
+            return selectedCustomAppScope;
+        }
+        return customAppScopes[0];
+    }
+};
+//# sourceMappingURL=customAppScope.js.map

package/dist/utils/entraServicePrincipal.js

@@ -0,0 +1,46 @@
+import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
+export const entraServicePrincipal = {
+    /**
+     * Get service principal by its appId
+     * @param appId App id.
+     * @param properties Comma-separated list of properties to include in the response.
+     * @returns The service principal.
+     * @throws Error when service principal was not found.
+     */
+    async getServicePrincipalByAppId(appId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/servicePrincipals?$filter=appId eq '${appId}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `Service principal with appId '${appId}' not found in Microsoft Entra ID`;
+        }
+        return apps[0];
+    },
+    /**
+     * Get service principal by its name
+     * @param appName Service principal name.
+     * @param properties Comma-separated list of properties to include in the response.
+     * @returns The service principal.
+     * @throws Error when service principal was not found.
+     */
+    async getServicePrincipalByAppName(appName, properties) {
+        let url = `https://graph.microsoft.com/v1.0/servicePrincipals?$filter=displayName eq '${formatting.encodeQueryParameter(appName)}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `Service principal with name '${appName}' not found in Microsoft Entra ID`;
+        }
+        if (apps.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);
+            return await cli.handleMultipleResultsFound(`Multiple service principals with name '${appName}' found in Microsoft Entra ID.`, resultAsKeyValuePair);
+        }
+        return apps[0];
+    }
+};
+//# sourceMappingURL=entraServicePrincipal.js.map

package/dist/utils/powerPlatform.js

@@ -1,5 +1,7 @@
+import { cli } from "../cli/cli.js";
 import request from "../request.js";
 import { formatting } from "./formatting.js";
+import { odata } from "./odata.js";
 const powerPlatformResource = 'https://api.bap.microsoft.com';
 export const powerPlatform = {
     async getDynamicsInstanceApiUrl(environment, asAdmin) {
@@ -24,6 +26,42 @@ export const powerPlatform = {
         catch (ex) {
             throw Error(`The environment '${environment}' could not be retrieved. See the inner exception for more details: ${ex.message}`);
         }
+    },
+    async getWebsiteById(environment, id) {
+        const requestOptions = {
+            url: `https://api.powerplatform.com/powerpages/environments/${environment}/websites/${id}?api-version=2022-03-01-preview`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        try {
+            const response = await request.get(requestOptions);
+            return response;
+        }
+        catch (ex) {
+            throw Error(`The specified Power Page website with id '${id}' does not exist.`);
+        }
+    },
+    async getWebsiteByName(environment, websiteName) {
+        const response = await odata.getAllItems(`https://api.powerplatform.com/powerpages/environments/${environment}/websites?api-version=2022-03-01-preview`);
+        const items = response.filter(response => response.name === websiteName);
+        if (items.length === 0) {
+            throw Error(`The specified Power Page website '${websiteName}' does not exist.`);
+        }
+        if (items.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('websiteUrl', items);
+            return cli.handleMultipleResultsFound(`Multiple Power Page websites with name '${websiteName}' found`, resultAsKeyValuePair);
+        }
+        return items[0];
+    },
+    async getWebsiteByUrl(environment, url) {
+        const response = await odata.getAllItems(`https://api.powerplatform.com/powerpages/environments/${environment}/websites?api-version=2022-03-01-preview`);
+        const items = response.filter(response => response.websiteUrl === url);
+        if (items.length === 0) {
+            throw Error(`The specified Power Page website with url '${url}' does not exist.`);
+        }
+        return items[0];
     }
 };
 //# sourceMappingURL=powerPlatform.js.map

package/dist/utils/roleDefinition.js

@@ -46,6 +46,29 @@ export const roleDefinition = {
             responseType: 'json'
         };
         return await request.get(requestOptions);
+    },
+    /**
+     * Get an Exchange role by its name
+     * @param displayName Role definition display name.
+     * @param properties Comma-separated list of properties to include in the response.
+     * @returns The role definition.
+     * @throws Error when role definition was not found.
+     */
+    async getExchangeRoleDefinitionByDisplayName(displayName, properties) {
+        let url = `https://graph.microsoft.com/beta/roleManagement/exchange/roleDefinitions?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const roleDefinitions = await odata.getAllItems(url);
+        if (roleDefinitions.length === 0) {
+            throw `The specified role definition '${displayName}' does not exist.`;
+        }
+        if (roleDefinitions.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', roleDefinitions);
+            const selectedRoleDefinition = await cli.handleMultipleResultsFound(`Multiple role definitions with name '${displayName}' found.`, resultAsKeyValuePair);
+            return selectedRoleDefinition;
+        }
+        return roleDefinitions[0];
     }
 };
 //# sourceMappingURL=roleDefinition.js.map