@pnp/cli-microsoft365 6.0.0-beta.c5ce305 → 6.0.0-beta.c63e3b2

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

@@ -16,6 +16,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoTaskSetCommand_instances, _TodoTaskSetCommand_initTelemetry, _TodoTaskSetCommand_initOptions, _TodoTaskSetCommand_initValidators, _TodoTaskSetCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+const validation_1 = require("../../../../utils/validation");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 class TodoTaskSetCommand extends GraphCommand_1.default {
@@ -40,7 +42,7 @@ class TodoTaskSetCommand extends GraphCommand_1.default {
             try {
                 const listId = yield this.getTodoListId(args);
                 const requestOptions = {
-                    url: `${endpoint}/me/todo/lists/${listId}/tasks/${encodeURIComponent(args.options.id)}`,
+                    url: `${endpoint}/me/todo/lists/${listId}/tasks/${formatting_1.formatting.encodeQueryParameter(args.options.id)}`,
                     headers: {
                         accept: 'application/json;odata.metadata=none',
                         'Content-Type': 'application/json'
@@ -76,7 +78,14 @@ class TodoTaskSetCommand extends GraphCommand_1.default {
             return Promise.resolve(taskList.id);
         });
     }
+    getDateTimeTimeZone(dateTime) {
+        return {
+            dateTime: dateTime,
+            timeZone: 'Etc/GMT'
+        };
+    }
     mapRequestBody(options) {
+        var _a;
         const requestBody = {};
         if (options.status) {
             requestBody.status = options.status;
@@ -84,6 +93,21 @@ class TodoTaskSetCommand extends GraphCommand_1.default {
         if (options.title) {
             requestBody.title = options.title;
         }
+        if (options.importance) {
+            requestBody.importance = options.importance.toLowerCase();
+        }
+        if (options.bodyContentType || options.bodyContent) {
+            requestBody.body = {
+                content: options.bodyContent,
+                contentType: ((_a = options.bodyContentType) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || 'text'
+            };
+        }
+        if (options.dueDateTime) {
+            requestBody.dueDateTime = this.getDateTimeTimeZone(options.dueDateTime);
+        }
+        if (options.reminderDateTime) {
+            requestBody.reminderDateTime = this.getDateTimeTimeZone(options.reminderDateTime);
+        }
         return requestBody;
     }
 }
@@ -93,7 +117,12 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_initTelemetry
             listId: typeof args.options.listId !== 'undefined',
             listName: typeof args.options.listName !== 'undefined',
             status: typeof args.options.status !== 'undefined',
-            title: typeof args.options.title !== 'undefined'
+            title: typeof args.options.title !== 'undefined',
+            bodyContent: typeof args.options.bodyContent !== 'undefined',
+            bodyContentType: args.options.bodyContentType,
+            dueDateTime: typeof args.options.dueDateTime !== 'undefined',
+            importance: args.options.importance,
+            reminderDateTime: typeof args.options.reminderDateTime !== 'undefined'
         });
     });
 }, _TodoTaskSetCommand_initOptions = function _TodoTaskSetCommand_initOptions() {
@@ -108,6 +137,18 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_initTelemetry
         option: '--listName [listName]'
     }, {
         option: '--listId [listId]'
+    }, {
+        option: '--bodyContent [bodyContent]'
+    }, {
+        option: '--bodyContentType [bodyContentType]',
+        autocomplete: ['text', 'html']
+    }, {
+        option: '--dueDateTime [dueDateTime]'
+    }, {
+        option: '--importance [importance]',
+        autocomplete: ['low', 'normal', 'high']
+    }, {
+        option: '--reminderDateTime [reminderDateTime]'
     });
 }, _TodoTaskSetCommand_initValidators = function _TodoTaskSetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
@@ -119,6 +160,18 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_initTelemetry
             args.options.status !== 'deferred') {
             return `${args.options.status} is not a valid value. Allowed values are notStarted|inProgress|completed|waitingOnOthers|deferred`;
         }
+        if (args.options.bodyContentType && ['text', 'html'].indexOf(args.options.bodyContentType.toLowerCase()) === -1) {
+            return `'${args.options.bodyContentType}' is not a valid value for the bodyContentType option. Allowed values are text|html`;
+        }
+        if (args.options.importance && ['low', 'normal', 'high'].indexOf(args.options.importance.toLowerCase()) === -1) {
+            return `'${args.options.importance}' is not a valid value for the importance option. Allowed values are low|normal|high`;
+        }
+        if (args.options.dueDateTime && !validation_1.validation.isValidISODateTime(args.options.dueDateTime)) {
+            return `'${args.options.dueDateTime}' is not a valid ISO date string`;
+        }
+        if (args.options.reminderDateTime && !validation_1.validation.isValidISODateTime(args.options.reminderDateTime)) {
+            return `'${args.options.reminderDateTime}' is not a valid ISO date string`;
+        }
         return true;
     }));
 }, _TodoTaskSetCommand_initOptionSets = function _TodoTaskSetCommand_initOptionSets() {

package/dist/m365/todo/commands.js

@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'todo';
 exports.default = {
     LIST_ADD: `${prefix} list add`,
+    LIST_GET: `${prefix} list get`,
     LIST_LIST: `${prefix} list list`,
     LIST_REMOVE: `${prefix} list remove`,
     LIST_SET: `${prefix} list set`,
     TASK_ADD: `${prefix} task add`,
+    TASK_GET: `${prefix} task get`,
     TASK_LIST: `${prefix} task list`,
     TASK_REMOVE: `${prefix} task remove`,
     TASK_SET: `${prefix} task set`

package/dist/m365/yammer/commands/group/group-list.js

@@ -37,7 +37,7 @@ class YammerGroupListCommand extends YammerCommand_1.default {
         return ['id', 'name', 'email', 'privacy', 'external', 'moderated'];
     }
     getAllItems(logger, args, page) {
-        return new Promise((resolve, reject) => {
+        return __awaiter(this, void 0, void 0, function* () {
             let endpoint = `${this.resource}/v1`;
             if (args.options.userId) {
                 endpoint += `/groups/for_user/${args.options.userId}.json`;
@@ -54,32 +54,17 @@ class YammerGroupListCommand extends YammerCommand_1.default {
                 },
                 responseType: 'json'
             };
-            request_1.default
-                .get(requestOptions)
-                .then((res) => {
-                this.items = this.items.concat(res);
-                if (args.options.limit && this.items.length > args.options.limit) {
-                    this.items = this.items.slice(0, args.options.limit);
-                    resolve();
-                }
-                else {
-                    // we need to page by 50 items (hardcoded)
-                    if (this.items.length % 50 === 0) {
-                        this
-                            .getAllItems(logger, args, ++page)
-                            .then(() => {
-                            resolve();
-                        }, (err) => {
-                            reject(err);
-                        });
-                    }
-                    else {
-                        resolve();
-                    }
-                }
-            }, (err) => {
-                reject(err);
-            });
+            const output = yield request_1.default.get(requestOptions);
+            if (!output.length) {
+                return;
+            }
+            this.items = this.items.concat(output);
+            if (args.options.limit && this.items.length > args.options.limit) {
+                this.items = this.items.slice(0, args.options.limit);
+            }
+            else if (this.items.length % 50 === 0) {
+                yield this.getAllItems(logger, args, ++page);
+            }
         });
     }
     commandAction(logger, args) {

package/dist/m365/yammer/commands/user/user-get.js

@@ -16,6 +16,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _YammerUserGetCommand_instances, _YammerUserGetCommand_initTelemetry, _YammerUserGetCommand_initOptions, _YammerUserGetCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
 const YammerCommand_1 = require("../../../base/YammerCommand");
 const commands_1 = require("../../commands");
 class YammerUserGetCommand extends YammerCommand_1.default {
@@ -39,10 +40,10 @@ class YammerUserGetCommand extends YammerCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             let endPoint = `${this.resource}/v1/users/current.json`;
             if (args.options.id) {
-                endPoint = `${this.resource}/v1/users/${encodeURIComponent(args.options.id)}.json`;
+                endPoint = `${this.resource}/v1/users/${args.options.id}.json`;
             }
             else if (args.options.email) {
-                endPoint = `${this.resource}/v1/users/by_email.json?email=${encodeURIComponent(args.options.email)}`;
+                endPoint = `${this.resource}/v1/users/by_email.json?email=${formatting_1.formatting.encodeQueryParameter(args.options.email)}`;
             }
             const requestOptions = {
                 url: endPoint,

package/dist/m365/yammer/commands/yammer-search.js

@@ -16,6 +16,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _YammerSearchCommand_instances, _YammerSearchCommand_initTelemetry, _YammerSearchCommand_initOptions, _YammerSearchCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../request");
+const formatting_1 = require("../../../utils/formatting");
 const YammerCommand_1 = require("../../base/YammerCommand");
 const commands_1 = require("../commands");
 class YammerSearchCommand extends YammerCommand_1.default {
@@ -44,10 +45,13 @@ class YammerSearchCommand extends YammerCommand_1.default {
     }
     getAllItems(logger, args, page) {
         return new Promise((resolve, reject) => {
-            const endpoint = `${this.resource}/v1/search.json?search=${encodeURIComponent(args.options.queryText)}&page=${page}`;
+            const endpoint = `${this.resource}/v1/search.json?search=${formatting_1.formatting.encodeQueryParameter(args.options.queryText)}&page=${page}`;
             const requestOptions = {
                 url: endpoint,
-                responseType: 'json'
+                responseType: 'json',
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                }
             };
             request_1.default
                 .get(requestOptions)

package/dist/utils/aadGroup.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.aadGroup = void 0;
 const request_1 = require("../request");
+const formatting_1 = require("./formatting");
 const odata_1 = require("./odata");
 const graphResource = 'https://graph.microsoft.com';
 exports.aadGroup = {
@@ -33,7 +34,7 @@ exports.aadGroup = {
      * @param displayName Group display name.
      */
     getGroupsByDisplayName(displayName) {
-        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(displayName)}'`);
+        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(displayName)}'`);
     },
     /**
      * Get a single group by its display name.

package/dist/utils/cache.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cache = void 0;
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const config_1 = require("../config");
+const cacheFolderPath = path.join(os.tmpdir(), config_1.default.configstoreName.replace('config', 'cache'));
+const mkdirOptions = { mode: 0o0700, recursive: true };
+exports.cache = {
+    cacheFolderPath: cacheFolderPath,
+    getValue(key) {
+        this.clearExpired();
+        try {
+            const cacheFilePath = path.join(cacheFolderPath, key);
+            if (!fs.existsSync(cacheFilePath)) {
+                return undefined;
+            }
+            return fs.readFileSync(cacheFilePath, 'utf8');
+        }
+        catch (_a) {
+            return undefined;
+        }
+    },
+    setValue(key, value) {
+        this.clearExpired();
+        try {
+            fs.mkdirSync(cacheFolderPath, mkdirOptions);
+            const cacheFilePath = path.join(cacheFolderPath, key);
+            // we don't need to wait for the file to be written
+            // eslint-disable-next-line @typescript-eslint/no-empty-function
+            fs.writeFile(cacheFilePath, value, () => { });
+        }
+        catch (_a) { }
+    },
+    clearExpired(cb) {
+        // we don't need to wait for this to complete
+        // even if it stops meanwhile, it will be picked up next time
+        fs.readdir(cacheFolderPath, (err, files) => {
+            if (err) {
+                if (cb) {
+                    cb();
+                }
+                return;
+            }
+            const numFiles = files.length;
+            if (numFiles === 0) {
+                if (cb) {
+                    cb();
+                }
+                return;
+            }
+            files.forEach((file, index) => {
+                fs.stat(path.join(cacheFolderPath, file), (err, stats) => {
+                    if (err || stats.isDirectory()) {
+                        if (cb && index === numFiles - 1) {
+                            cb();
+                        }
+                        return;
+                    }
+                    // remove files that haven't been accessed in the last 24 hours
+                    if (stats.atime.getTime() < Date.now() - 24 * 60 * 60 * 1000) {
+                        // we don't need to wait for the file to be deleted
+                        // eslint-disable-next-line @typescript-eslint/no-empty-function
+                        fs.unlink(path.join(cacheFolderPath, file), () => {
+                            if (cb && index === numFiles - 1) {
+                                cb();
+                            }
+                        });
+                    }
+                    else {
+                        if (cb && index === numFiles - 1) {
+                            cb();
+                        }
+                    }
+                });
+            });
+        });
+    }
+};
+//# sourceMappingURL=cache.js.map

package/dist/utils/md.js

@@ -45,10 +45,16 @@ function convertHyperlinks(md) {
         return `${label} (${url})`;
     });
 }
+function convertContentTabs(md) {
+    const regex = new RegExp('^=== "(.+?)"(?:\r\n|\n){2}((?:^    (?:.*?(?:\r\n|\n))?)+)', 'gms');
+    return md.replace(regex, (match, title, content) => {
+        return `  ${title}${os_1.EOL}${os_1.EOL}${content.replace(/^    /gms, '')}`;
+    });
+}
 function convertCodeFences(md) {
     const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
     return md.replace(regex, (match, code) => {
-        return `  ${code}${os_1.EOL}`;
+        return `${code.replace(/^(.+)$/gm, '  $1')}${os_1.EOL}`;
     });
 }
 function removeInlineMarkup(md) {
@@ -65,6 +71,7 @@ const convertFunctions = [
     convertAdmonitions,
     convertDd,
     convertHyperlinks,
+    convertContentTabs,
     convertCodeFences,
     removeInlineMarkup,
     removeTooManyEmptyLines

package/dist/utils/pid.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pid = void 0;
+const os = require("os");
+const fs = require("fs");
+const child_process_1 = require("child_process");
+const cache_1 = require("./cache");
+function getProcessNameOnMacOs(pid) {
+    const stdout = (0, child_process_1.execSync)(`ps -o comm= ${pid}`, { encoding: 'utf8' });
+    return stdout.trim();
+}
+function getProcessNameOnLinux(pid) {
+    if (!fs.existsSync(`/proc/${pid}/stat`)) {
+        return undefined;
+    }
+    const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
+    const start = stat.indexOf('(');
+    const procName = stat.substring(start + 1, stat.indexOf(')') - start);
+    return procName;
+}
+function getProcessNameOnWindows(pid) {
+    const stdout = (0, child_process_1.execSync)(`wmic PROCESS where ProcessId=${pid} get Caption | find /V "Caption"`, { encoding: 'utf8' });
+    return stdout.trim();
+}
+exports.pid = {
+    getProcessName(pid) {
+        let processName = cache_1.cache.getValue(pid.toString());
+        if (processName) {
+            return processName;
+        }
+        let getPidName = undefined;
+        const platform = os.platform();
+        if (platform.indexOf('win') === 0) {
+            getPidName = getProcessNameOnWindows;
+        }
+        if (platform === 'darwin') {
+            getPidName = getProcessNameOnMacOs;
+        }
+        if (platform === 'linux') {
+            getPidName = getProcessNameOnLinux;
+        }
+        if (getPidName) {
+            try {
+                processName = getPidName(pid);
+                if (processName) {
+                    cache_1.cache.setValue(pid.toString(), processName);
+                }
+                return processName;
+            }
+            catch (_a) {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+};
+//# sourceMappingURL=pid.js.map

package/dist/utils/powerPlatform.js

@@ -0,0 +1,43 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.powerPlatform = void 0;
+const request_1 = require("../request");
+const formatting_1 = require("./formatting");
+const powerPlatformResource = 'https://api.bap.microsoft.com';
+exports.powerPlatform = {
+    getDynamicsInstanceApiUrl(environment, asAdmin) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let url = '';
+            if (asAdmin) {
+                url = `${powerPlatformResource}/providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/${formatting_1.formatting.encodeQueryParameter(environment)}`;
+            }
+            else {
+                url = `${powerPlatformResource}/providers/Microsoft.BusinessAppPlatform/environments/${formatting_1.formatting.encodeQueryParameter(environment)}`;
+            }
+            const requestOptions = {
+                url: `${url}?api-version=2020-10-01&$select=properties.linkedEnvironmentMetadata.instanceApiUrl`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            try {
+                const response = yield request_1.default.get(requestOptions);
+                return Promise.resolve(response.properties.linkedEnvironmentMetadata.instanceApiUrl);
+            }
+            catch (ex) {
+                throw Error(`The environment '${environment}' could not be retrieved. See the inner exception for more details: ${ex.message}`);
+            }
+        });
+    }
+};
+//# sourceMappingURL=powerPlatform.js.map

package/dist/utils/spo.js

@@ -8,6 +8,7 @@ const Auth_1 = require("../Auth");
 const config_1 = require("../config");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
+const formatting_1 = require("./formatting");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -285,7 +286,7 @@ exports.spo = {
             nextFolder += `/${folders[folderIndex]}`;
             const folderServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webFullUrl, nextFolder);
             const requestOptions = {
-                url: `${webFullUrl}/_api/web/GetFolderByServerRelativeUrl('${encodeURIComponent(folderServerRelativeUrl)}')`,
+                url: `${webFullUrl}/_api/web/GetFolderByServerRelativeUrl('${formatting_1.formatting.encodeQueryParameter(folderServerRelativeUrl)}')`,
                 headers: {
                     'accept': 'application/json;odata=nometadata'
                 }
@@ -299,7 +300,7 @@ exports.spo = {
                 .catch(() => {
                 const prevFolderServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webFullUrl, prevFolder);
                 const requestOptions = {
-                    url: `${webFullUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl=@a1)/AddSubFolderUsingPath(DecodedUrl=@a2)?@a1=%27${encodeURIComponent(prevFolderServerRelativeUrl)}%27&@a2=%27${encodeURIComponent(folders[folderIndex])}%27`,
+                    url: `${webFullUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl=@a1)/AddSubFolderUsingPath(DecodedUrl=@a2)?@a1=%27${formatting_1.formatting.encodeQueryParameter(prevFolderServerRelativeUrl)}%27&@a2=%27${formatting_1.formatting.encodeQueryParameter(folders[folderIndex])}%27`,
                     headers: {
                         'accept': 'application/json;odata=nometadata'
                     },

package/docs/docs/_clisettings.md

@@ -0,0 +1,18 @@
+## Available settings
+
+Following is the list of configuration settings available in CLI for Microsoft 365.
+
+Setting name|Definition|Default value
+------------|----------|-------------
+`autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
+`copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
+`csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
+`csvHeader`|Display the column names on the first line|`true`
+`csvQuote`|The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.|` `
+`csvQuoted`|Quote all the non-empty fields even if not required|`false`
+`csvQuotedEmpty`|Quote empty strings and overrides quoted_string on empty strings when defined|`false`
+`errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
+`output`|Defines the default output when issuing a command|`json`
+`printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
+`prompt`|Prompts for missing values in required options|`false`
+`showHelpOnFailure`|Automatically display help when executing a command failed|`true`

package/docs/docs/cmd/aad/app/app-add.md

@@ -11,61 +11,61 @@ m365 aad app add [options]
 ## Options
 
 `-n, --name [name]`
-: Name of the app
+: Name of the app. Specify either `name` or `manifest` but not both.
 
 `--multitenant`
-: Specify, to make the app available to other tenants
+: Specify, to make the app available to other tenants.
 
 `-r, --redirectUris [redirectUris]`
-: Comma-separated list of redirect URIs. Requires `platform` to be specified
+: 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`.
 
 `--implicitFlow`
-: Specify, to indicate that the authorization endpoint should return ID and access tokens
+: Specify, to indicate that the authorization endpoint should return ID and access tokens.
 
 `-s, --withSecret`
-: When specified, will create a secret named `Default` and set it to expire 1 year in the future
+: When specified, will create a secret named `Default` and set it to expire 1 year in the future.
 
 `--apisDelegated [apisDelegated]`
-: Comma-separated list of delegated permissions to register with the app
+: Comma-separated list of delegated permissions to register with the app.
 
 `--apisApplication [apisApplication]`
-: Comma-separated list of application permissions to register with the app
+: Comma-separated list of application permissions to register with the app.
 
 `-u, --uri [uri]`
-: Application ID URI
+: Application ID URI.
 
 `--scopeName [scopeName]`
-: Name of the scope to add. Requires `uri` to be specified
+: Name of the scope to add. Requires `uri` to be specified.
 
 `--scopeConsentBy [scopeConsentBy]`
-: Specifies if the scope can be consented only by admins or by admins and users. Allowed values `admins`, `adminsAndUsers`. Default `admins`
+: Specifies if the scope can be consented only by admins or by admins and users. Allowed values `admins`, `adminsAndUsers`. Default `admins`.
 
 `--scopeAdminConsentDisplayName [scopeAdminConsentDisplayName]`
-: Scope admin consent display name
+: Scope admin consent display name.
 
 `--scopeAdminConsentDescription [scopeAdminConsentDescription]`
-: Scope admin consent description
+: Scope admin consent description.
 
 `--certificateFile [certificateFile]`
-: Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`
+: Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
 
 `--certificateBase64Encoded [certificateBase64Encoded]`
-: Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`
+: Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
 
 `--certificateDisplayName [certificateDisplayName]`
-: Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`
+: Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`.
 
 `--grantAdminConsent`
-: When specified, grants application & delegated permissions through admin consent
+: When specified, grants application & delegated permissions through admin consent.
 
 `--manifest [manifest]`
-: Azure AD app manifest as retrieved from the Azure Portal to create the app registration from
+: Azure AD app manifest as retrieved from the Azure Portal to create the app registration from. Specify either `name` or `manifest` but not both.
 
 `--save`
-: Use to store the information about the created app in a local file
+: Use to store the information about the created app in a local file.
 
 --8<-- "docs/cmd/_global.md"