@pnp/cli-microsoft365 5.1.0-beta.04832fc → 5.1.0-beta.7b2911b

package/.eslintrc.js

@@ -35,6 +35,7 @@ const dictionary = [
   'is',
   'issue',
   'list',
+  'management',
   'member',
   'messaging',
   'news',

package/dist/Auth.js

@@ -311,6 +311,16 @@ class Auth {
             }
             this._open(response.verificationUri);
         }
+        if (cli_1.Cli.getInstance().getSettingWithDefaultValue(settingsNames_1.settingsNames.copyDeviceCodeToClipboard, false)) {
+            // _clipboardy is never set before hitting this line, but this check
+            // is implemented so that we can support lazy loading
+            // but also stub it for testing
+            /* c8 ignore next 3 */
+            if (!this._clipboardy) {
+                this._clipboardy = require('clipboardy');
+            }
+            this._clipboardy.writeSync(response.userCode);
+        }
     }
     ensureAccessTokenWithPassword(resource, logger, debug) {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/Command.js

@@ -123,6 +123,9 @@ class Command {
             }
         ];
     }
+    optionSets() {
+        return;
+    }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     validate(args) {
         return true;

package/dist/cli/Cli.js

@@ -163,6 +163,19 @@ class Cli {
             if (optionsWithoutShorts.options.output === undefined) {
                 optionsWithoutShorts.options.output = this.getSettingWithDefaultValue(settingsNames_1.settingsNames.output, undefined);
             }
+            // validate options sets defined by the command
+            const optionsSets = this.commandToExecute.command.optionSets();
+            const argsOptions = Object.keys(this.optionsFromArgs.options);
+            const cmdArgs = this.optionsFromArgs;
+            optionsSets === null || optionsSets === void 0 ? void 0 : optionsSets.forEach((optionSet) => {
+                const commonOptions = argsOptions.filter(opt => optionSet.includes(opt));
+                if (commonOptions.length === 0) {
+                    return this.closeWithError(`Specify one of the following options: ${optionSet.map(opt => opt).join(', ')}.`, cmdArgs, true);
+                }
+                if (commonOptions.length > 1) {
+                    return this.closeWithError(`Specify one of the following options: ${optionSet.map(opt => opt).join(', ')}, but not multiple.`, cmdArgs, true);
+                }
+            });
             const validationResult = this.commandToExecute.command.validate(optionsWithoutShorts);
             if (typeof validationResult === 'string') {
                 return this.closeWithError(validationResult, optionsWithoutShorts, true);

package/dist/m365/aad/commands/app/app-add.js

@@ -58,6 +58,9 @@ class AadAppAddCommand extends GraphCommand_1.default {
             if (_appInfo.secret) {
                 appInfo.secret = _appInfo.secret;
             }
+            if (_appInfo.secrets) {
+                appInfo.secrets = _appInfo.secrets;
+            }
             logger.log(appInfo);
             cb();
         }, (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
@@ -111,6 +114,10 @@ class AadAppAddCommand extends GraphCommand_1.default {
         delete v2Manifest.id;
         delete v2Manifest.appId;
         delete v2Manifest.publisherDomain;
+        // extract secrets from the manifest. Store them in a separate variable
+        // and remove them from the manifest because we need to create them
+        // separately
+        const secrets = this.getSecretsFromManifest(v2Manifest);
         // Azure Portal returns v2 manifest whereas the Graph API expects a v1.6
         const graphManifest = this.transformManifest(v2Manifest);
         const updateAppRequestOptions = {
@@ -124,7 +131,26 @@ class AadAppAddCommand extends GraphCommand_1.default {
         return request_1.default
             .patch(updateAppRequestOptions)
             .then(_ => this.updatePreAuthorizedAppsFromManifest(v2Manifest, appInfo))
-            .then(_ => Promise.resolve(appInfo));
+            .then(_ => this.createSecrets(secrets, appInfo));
+    }
+    getSecretsFromManifest(manifest) {
+        if (!manifest.passwordCredentials || manifest.passwordCredentials.length === 0) {
+            return [];
+        }
+        const secrets = manifest.passwordCredentials.map((c) => {
+            const startDate = new Date(c.startDate);
+            const endDate = new Date(c.endDate);
+            const expirationDate = new Date();
+            expirationDate.setMilliseconds(endDate.valueOf() - startDate.valueOf());
+            return {
+                name: c.displayName,
+                expirationDate
+            };
+        });
+        // delete the secrets from the manifest so that we won't try to set them
+        // from the manifest
+        delete manifest.passwordCredentials;
+        return secrets;
     }
     updatePreAuthorizedAppsFromManifest(manifest, appInfo) {
         if (!manifest ||
@@ -153,6 +179,21 @@ class AadAppAddCommand extends GraphCommand_1.default {
             .patch(updateAppRequestOptions)
             .then(_ => Promise.resolve(appInfo));
     }
+    createSecrets(secrets, appInfo) {
+        if (secrets.length === 0) {
+            return Promise.resolve(appInfo);
+        }
+        return Promise
+            .all(secrets.map(secret => this.createSecret({
+            appObjectId: appInfo.id,
+            displayName: secret.name,
+            expirationDate: secret.expirationDate
+        })))
+            .then(secrets => {
+            appInfo.secrets = secrets;
+            return appInfo;
+        });
+    }
     transformManifest(v2Manifest) {
         var _a, _b, _c, _d;
         const graphManifest = JSON.parse(JSON.stringify(v2Manifest));
@@ -187,7 +228,7 @@ class AadAppAddCommand extends GraphCommand_1.default {
         unsupportedProperties.forEach(p => delete graphManifest[p]);
         graphManifest.api.acceptMappedClaims = v2Manifest.acceptMappedClaims;
         delete graphManifest.acceptMappedClaims;
-        graphManifest.publicClient = v2Manifest.allowPublicClient;
+        graphManifest.isFallbackPublicClient = v2Manifest.allowPublicClient;
         delete graphManifest.allowPublicClient;
         graphManifest.info.termsOfServiceUrl = (_a = v2Manifest.informationalUrls) === null || _a === void 0 ? void 0 : _a.termsOfService;
         graphManifest.info.supportUrl = (_b = v2Manifest.informationalUrls) === null || _b === void 0 ? void 0 : _b.support;
@@ -234,6 +275,11 @@ class AadAppAddCommand extends GraphCommand_1.default {
         }
         graphManifest.web.homePageUrl = v2Manifest.signInUrl;
         delete graphManifest.signInUrl;
+        if (graphManifest.appRoles) {
+            graphManifest.appRoles.forEach((role) => {
+                delete role.lang;
+            });
+        }
         return graphManifest;
     }
     configureUri(args, appInfo, logger) {
@@ -357,27 +403,39 @@ class AadAppAddCommand extends GraphCommand_1.default {
         if (this.verbose) {
             logger.logToStderr(`Configure Azure AD app secret...`);
         }
-        const secretExpirationDate = new Date();
-        secretExpirationDate.setFullYear(secretExpirationDate.getFullYear() + 1);
+        return this
+            .createSecret({ appObjectId: appInfo.id })
+            .then(secret => {
+            appInfo.secret = secret.value;
+            return Promise.resolve(appInfo);
+        });
+    }
+    createSecret({ appObjectId, displayName = undefined, expirationDate = undefined }) {
+        let secretExpirationDate = expirationDate;
+        if (!secretExpirationDate) {
+            secretExpirationDate = new Date();
+            secretExpirationDate.setFullYear(secretExpirationDate.getFullYear() + 1);
+        }
+        const secretName = displayName !== null && displayName !== void 0 ? displayName : 'Default';
         const requestOptions = {
-            url: `${this.resource}/v1.0/myorganization/applications/${appInfo.id}/addPassword`,
+            url: `${this.resource}/v1.0/myorganization/applications/${appObjectId}/addPassword`,
             headers: {
                 'content-type': 'application/json'
             },
             responseType: 'json',
             data: {
                 passwordCredential: {
-                    displayName: 'Default',
+                    displayName: secretName,
                     endDateTime: secretExpirationDate.toISOString()
                 }
             }
         };
         return request_1.default
             .post(requestOptions)
-            .then((password) => {
-            appInfo.secret = password.secretText;
-            return Promise.resolve(appInfo);
-        });
+            .then((password) => Promise.resolve({
+            displayName: secretName,
+            value: password.secretText
+        }));
     }
     saveAppInfo(args, appInfo, logger) {
         if (!args.options.save) {

package/dist/m365/aad/commands/app/{app-delete.js → app-remove.js}

@@ -5,9 +5,12 @@ const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
-class AadAppDeleteCommand extends GraphCommand_1.default {
+class AadAppRemoveCommand extends GraphCommand_1.default {
     get name() {
-        return commands_1.default.APP_DELETE;
+        return commands_1.default.APP_REMOVE;
+    }
+    alias() {
+        return [commands_1.default.APP_DELETE];
     }
     get description() {
         return 'Removes an Azure AD app registration';
@@ -21,6 +24,7 @@ class AadAppDeleteCommand extends GraphCommand_1.default {
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
+        this.showDeprecationWarning(logger, commands_1.default.APP_DELETE, commands_1.default.APP_REMOVE);
         const deleteApp = () => {
             this
                 .getObjectId(args, logger)
@@ -47,7 +51,7 @@ class AadAppDeleteCommand extends GraphCommand_1.default {
                 type: 'confirm',
                 name: 'continue',
                 default: false,
-                message: `Are you sure you want to delete the App?`
+                message: `Are you sure you want to remove the app?`
             }, (result) => {
                 if (!result.continue) {
                     cb();
@@ -119,5 +123,5 @@ class AadAppDeleteCommand extends GraphCommand_1.default {
         return true;
     }
 }
-module.exports = new AadAppDeleteCommand();
-//# sourceMappingURL=app-delete.js.map
+module.exports = new AadAppRemoveCommand();
+//# sourceMappingURL=app-remove.js.map

package/dist/m365/aad/commands/app/{app-role-delete.js → app-role-remove.js}

@@ -5,12 +5,15 @@ const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
-class AadAppRoleDeleteCommand extends GraphCommand_1.default {
+class AadAppRoleRemoveCommand extends GraphCommand_1.default {
     get name() {
-        return commands_1.default.APP_ROLE_DELETE;
+        return commands_1.default.APP_ROLE_REMOVE;
     }
     get description() {
-        return 'Deletes role from the specified Azure AD app registration';
+        return 'Removes role from the specified Azure AD app registration';
+    }
+    alias() {
+        return [commands_1.default.APP_ROLE_DELETE];
     }
     getTelemetryProperties(args) {
         const telemetryProps = super.getTelemetryProperties(args);
@@ -23,6 +26,7 @@ class AadAppRoleDeleteCommand extends GraphCommand_1.default {
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
+        this.showDeprecationWarning(logger, commands_1.default.APP_ROLE_DELETE, commands_1.default.APP_ROLE_REMOVE);
         const deleteAppRole = () => {
             this
                 .processAppRoleDelete(logger, args)
@@ -36,7 +40,7 @@ class AadAppRoleDeleteCommand extends GraphCommand_1.default {
                 type: 'confirm',
                 name: 'continue',
                 default: false,
-                message: `Are you sure you want to delete the App role ?`
+                message: `Are you sure you want to remove the app role ?`
             }, (result) => {
                 if (!result.continue) {
                     cb();
@@ -56,7 +60,7 @@ class AadAppRoleDeleteCommand extends GraphCommand_1.default {
             if (this.verbose) {
                 logger.logToStderr(`Deleting role with ${appRoleDeleteIdentifierNameValue} from Azure AD app ${aadApp.id}...`);
             }
-            // Find the role search criteria provided by the user.     
+            // Find the role search criteria provided by the user.
             const appRoleDeleteIdentifierProperty = args.options.name ? `displayName` : (args.options.claim ? `value` : `id`);
             const appRoleDeleteIdentifierValue = args.options.name ? args.options.name : (args.options.claim ? args.options.claim : args.options.id);
             const appRoleToDelete = aadApp.appRoles.filter((role) => role[appRoleDeleteIdentifierProperty] === appRoleDeleteIdentifierValue);
@@ -201,5 +205,5 @@ class AadAppRoleDeleteCommand extends GraphCommand_1.default {
         return true;
     }
 }
-module.exports = new AadAppRoleDeleteCommand();
-//# sourceMappingURL=app-role-delete.js.map
+module.exports = new AadAppRoleRemoveCommand();
+//# sourceMappingURL=app-role-remove.js.map

package/dist/m365/aad/commands.js

@@ -5,10 +5,12 @@ exports.default = {
     APP_ADD: `${prefix} app add`,
     APP_DELETE: `${prefix} app delete`,
     APP_GET: `${prefix} app get`,
+    APP_REMOVE: `${prefix} app remove`,
     APP_SET: `${prefix} app set`,
     APP_ROLE_ADD: `${prefix} app role add`,
-    APP_ROLE_LIST: `${prefix} app role list`,
     APP_ROLE_DELETE: `${prefix} app role delete`,
+    APP_ROLE_LIST: `${prefix} app role list`,
+    APP_ROLE_REMOVE: `${prefix} app role remove`,
     APPROLEASSIGNMENT_ADD: `${prefix} approleassignment add`,
     APPROLEASSIGNMENT_LIST: `${prefix} approleassignment list`,
     APPROLEASSIGNMENT_REMOVE: `${prefix} approleassignment remove`,

package/dist/m365/base/PowerPlatformCommand.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Command_1 = require("../../Command");
+class PowerPlatformCommand extends Command_1.default {
+    get resource() {
+        return 'https://api.bap.microsoft.com';
+    }
+}
+exports.default = PowerPlatformCommand;
+//# sourceMappingURL=PowerPlatformCommand.js.map

package/dist/m365/cli/commands/config/config-set.js

@@ -20,11 +20,12 @@ class CliConfigSetCommand extends AnonymousCommand_1.default {
         let value = undefined;
         switch (args.options.key) {
             case settingsNames_1.settingsNames.autoOpenBrowserOnLogin:
-            case settingsNames_1.settingsNames.showHelpOnFailure:
-            case settingsNames_1.settingsNames.printErrorsAsPlainText:
+            case settingsNames_1.settingsNames.copyDeviceCodeToClipboard:
             case settingsNames_1.settingsNames.csvHeader:
             case settingsNames_1.settingsNames.csvQuoted:
             case settingsNames_1.settingsNames.csvQuotedEmpty:
+            case settingsNames_1.settingsNames.printErrorsAsPlainText:
+            case settingsNames_1.settingsNames.showHelpOnFailure:
                 value = args.options.value === 'true';
                 break;
             default:

package/dist/m365/pp/commands/managementapp/managementapp-add.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
+const PowerPlatformCommand_1 = require("../../../base/PowerPlatformCommand");
+const commands_1 = require("../../commands");
+class PpManagementAppAddCommand extends PowerPlatformCommand_1.default {
+    get name() {
+        return commands_1.default.MANAGEMENTAPP_ADD;
+    }
+    get description() {
+        return 'Register management application for Power Platform';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.appId = typeof args.options.appId !== 'undefined';
+        telemetryProps.objectId = typeof args.options.objectId !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        this
+            .getAppId(args)
+            .then((appId) => {
+            const requestOptions = {
+                // This should be refactored once we implement a PowerPlatform base class as api.bap will differ between envs.
+                url: `${this.resource}/providers/Microsoft.BusinessAppPlatform/adminApplications/${appId}?api-version=2020-06-01`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.put(requestOptions);
+        })
+            .then((res) => {
+            logger.log(res);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    getAppId(args) {
+        if (args.options.appId) {
+            return Promise.resolve(args.options.appId);
+        }
+        const { objectId, name } = args.options;
+        const filter = objectId ?
+            `id eq '${encodeURIComponent(objectId)}'` :
+            `displayName eq '${encodeURIComponent(name)}'`;
+        const requestOptions = {
+            url: `https://graph.microsoft.com/v1.0/myorganization/applications?$filter=${filter}&$select=appId`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get((requestOptions))
+            .then((aadApps) => {
+            if (aadApps.value.length === 0) {
+                const applicationIdentifier = objectId ? `ID ${objectId}` : `name ${name}`;
+                return Promise.reject(`No Azure AD application registration with ${applicationIdentifier} found`);
+            }
+            if (aadApps.value.length === 1 && aadApps.value[0].appId) {
+                return Promise.resolve(aadApps.value[0].appId);
+            }
+            return Promise.reject(`Multiple Azure AD application registration with name ${name} found. Please disambiguate (app IDs): ${aadApps.value.map(a => a.appId).join(', ')}`);
+        });
+    }
+    options() {
+        const options = [
+            { option: '--appId [appId]' },
+            { option: '--objectId [objectId]' },
+            { option: '--name [name]' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.appId &&
+            !args.options.objectId &&
+            !args.options.name) {
+            return 'Specify either appId, objectId, or name';
+        }
+        if ((args.options.appId && args.options.objectId) ||
+            (args.options.appId && args.options.name) ||
+            (args.options.objectId && args.options.name)) {
+            return 'Specify either appId, objectId, or name but not both';
+        }
+        if (args.options.appId && !utils_1.validation.isValidGuid(args.options.appId)) {
+            return `${args.options.appId} is not a valid GUID`;
+        }
+        if (args.options.objectId && !utils_1.validation.isValidGuid(args.options.objectId)) {
+            return `${args.options.objectId} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new PpManagementAppAddCommand();
+//# sourceMappingURL=managementapp-add.js.map

package/dist/m365/pp/commands.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const prefix = 'pp';
+exports.default = {
+    MANAGEMENTAPP_ADD: `${prefix} managementapp add`
+};
+//# sourceMappingURL=commands.js.map

package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.12.0.js

@@ -40,7 +40,6 @@ const FN012017_TSC_extends_1 = require("./rules/FN012017_TSC_extends");
 const FN012018_TSC_lib_es2015_promise_1 = require("./rules/FN012018_TSC_lib_es2015_promise");
 const FN012019_TSC_types_es6_promise_1 = require("./rules/FN012019_TSC_types_es6_promise");
 const FN013002_GULP_serveTask_1 = require("./rules/FN013002_GULP_serveTask");
-const FN015006_FILE_editorconfig_1 = require("./rules/FN015006_FILE_editorconfig");
 const FN019002_TSL_extends_1 = require("./rules/FN019002_TSL_extends");
 const FN021002_PKG_engines_1 = require("./rules/FN021002_PKG_engines");
 module.exports = [
@@ -84,7 +83,6 @@ module.exports = [
     new FN012018_TSC_lib_es2015_promise_1.FN012018_TSC_lib_es2015_promise(),
     new FN012019_TSC_types_es6_promise_1.FN012019_TSC_types_es6_promise(false),
     new FN013002_GULP_serveTask_1.FN013002_GULP_serveTask(),
-    new FN015006_FILE_editorconfig_1.FN015006_FILE_editorconfig(false),
     new FN019002_TSL_extends_1.FN019002_TSL_extends('./node_modules/@microsoft/sp-tslint-rules/base-tslint.json'),
     new FN021002_PKG_engines_1.FN021002_PKG_engines(false)
 ];

package/dist/m365/spfx/commands/spfx-doctor.js

@@ -481,6 +481,9 @@ class SpfxDoctorCommand extends AnonymousCommand_1.default {
         return 'Verifies environment configuration for using the specific version of the SharePoint Framework';
     }
     commandAction(logger, args, cb) {
+        if (!args.options.output) {
+            args.options.output = 'text';
+        }
         logger.log(' ');
         logger.log('CLI for Microsoft 365 SharePoint Framework doctor');
         logger.log('Verifying configuration of your system for working with the SharePoint Framework');
@@ -758,6 +761,9 @@ class SpfxDoctorCommand extends AnonymousCommand_1.default {
                 return `${args.options.env} is not a valid SharePoint version. Valid versions are sp2016, sp2019 or spo`;
             }
         }
+        if (args.options.output && args.options.output !== 'text') {
+            return `The output option only accepts the type 'text'`;
+        }
         return true;
     }
 }

package/dist/m365/tenant/commands.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'tenant';
 exports.default = {
-    AUDITLOG_REPORT: `${prefix} auditlog report`,
     ID_GET: `${prefix} id get`,
     REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
     REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
@@ -11,14 +10,10 @@ exports.default = {
     REPORT_OFFICE365ACTIVATIONSUSERCOUNTS: `${prefix} report office365activationsusercounts`,
     REPORT_SERVICESUSERCOUNTS: `${prefix} report servicesusercounts`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_GET: `${prefix} serviceannouncement healthissue get`,
-    SERVICE_LIST: `${prefix} service list`,
-    SERVICE_MESSAGE_LIST: `${prefix} service message list`,
-    SERVICE_REPORT_HISTORICALSERVICESTATUS: `${prefix} service report historicalservicestatus`,
     SERVICEANNOUNCEMENT_HEALTH_GET: `${prefix} serviceannouncement health get`,
     SERVICEANNOUNCEMENT_HEALTH_LIST: `${prefix} serviceannouncement health list`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_LIST: `${prefix} serviceannouncement healthissue list`,
     SERVICEANNOUNCEMENT_MESSAGE_GET: `${prefix} serviceannouncement message get`,
-    SERVICEANNOUNCEMENT_MESSAGE_LIST: `${prefix} serviceannouncement message list`,
-    STATUS_LIST: `${prefix} status list`
+    SERVICEANNOUNCEMENT_MESSAGE_LIST: `${prefix} serviceannouncement message list`
 };
 //# sourceMappingURL=commands.js.map

package/dist/settingsNames.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.settingsNames = void 0;
 const settingsNames = {
     autoOpenBrowserOnLogin: 'autoOpenBrowserOnLogin',
+    copyDeviceCodeToClipboard: 'copyDeviceCodeToClipboard',
     csvEscape: 'csvEscape',
     csvHeader: 'csvHeader',
     csvQuote: 'csvQuote',

package/docs/docs/cmd/aad/app/{app-delete.md → app-remove.md}

@@ -1,9 +1,15 @@
-# aad app delete
+# aad app remove
 
 Removes an Azure AD app registration
 
 ## Usage
 
+```sh
+m365 aad app remove [options]
+```
+
+## Alias
+
 ```sh
 m365 aad app delete [options]
 ```
@@ -20,32 +26,32 @@ m365 aad app delete [options]
 : Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
 
 `--confirm`:
-: Don't prompt for confirmation to delete the app
+: Don't prompt for confirmation to remove the app
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-For best performance use the `objectId` option to reference the Azure AD application registration to delete. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
+For best performance use the `objectId` option to reference the Azure AD application registration to remove. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
 
 If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
 ## Examples
 
-Delete the Azure AD application registration by its app (client) ID
+Remove the Azure AD application registration by its app (client) ID
 
 ```sh
-m365 aad app delete --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+m365 aad app remove --appId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Delete the Azure AD application registration by its object ID
+Remove the Azure AD application registration by its object ID
 
 ```sh
-m365 aad app delete --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+m365 aad app remove --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Delete the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
+Remove the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
 
 ```sh
-m365 aad app delete --name "My app" --confirm
+m365 aad app remove --name "My app" --confirm
 ```