@pnp/cli-microsoft365 4.2.0-beta.bf7382d → 4.3.0-beta.0aaa522

package/dist/m365/spo/commands/page/page-add.js

@@ -284,11 +284,11 @@ class SpoPageAddCommand extends SpoCommand_1.default {
             },
             {
                 option: '-l, --layoutType [layoutType]',
-                autocomplete: ['Article', 'Home']
+                autocomplete: Page_1.supportedPageLayouts
             },
             {
                 option: '-p, --promoteAs [promoteAs]',
-                autocomplete: ['HomePage', 'NewsPage', 'Template']
+                autocomplete: Page_1.supportedPromoteAs
             },
             {
                 option: '--commentsEnabled'
@@ -312,20 +312,17 @@ class SpoPageAddCommand extends SpoCommand_1.default {
             return isValidSharePointUrl;
         }
         if (args.options.layoutType &&
-            args.options.layoutType !== 'Article' &&
-            args.options.layoutType !== 'Home') {
-            return `${args.options.layoutType} is not a valid option for layoutType. Allowed values Article|Home`;
+            Page_1.supportedPageLayouts.indexOf(args.options.layoutType) < 0) {
+            return `${args.options.layoutType} is not a valid option for layoutType. Allowed values ${Page_1.supportedPageLayouts.join(', ')}`;
         }
         if (args.options.promoteAs &&
-            args.options.promoteAs !== 'HomePage' &&
-            args.options.promoteAs !== 'NewsPage' &&
-            args.options.promoteAs !== 'Template') {
-            return `${args.options.promoteAs} is not a valid option for promoteAs. Allowed values HomePage|NewsPage|Template`;
+            Page_1.supportedPromoteAs.indexOf(args.options.promoteAs) < 0) {
+            return `${args.options.promoteAs} is not a valid option for promoteAs. Allowed values ${Page_1.supportedPromoteAs.join(', ')}`;
         }
         if (args.options.promoteAs === 'HomePage' && args.options.layoutType !== 'Home') {
             return 'You can only promote home pages as site home page';
         }
-        if (args.options.promoteAs === 'NewsPage' && args.options.layoutType === 'Home') {
+        if (args.options.promoteAs === 'NewsPage' && args.options.layoutType && args.options.layoutType !== 'Article') {
             return 'You can only promote article pages as news article';
         }
         return true;

package/dist/m365/spo/commands/page/page-set.js

@@ -283,11 +283,11 @@ class SpoPageSetCommand extends SpoCommand_1.default {
             },
             {
                 option: '-l, --layoutType [layoutType]',
-                autocomplete: ['Article', 'Home']
+                autocomplete: Page_1.supportedPageLayouts
             },
             {
                 option: '-p, --promoteAs [promoteAs]',
-                autocomplete: ['HomePage', 'NewsPage', 'Template']
+                autocomplete: Page_1.supportedPromoteAs
             },
             {
                 option: '--commentsEnabled [commentsEnabled]',
@@ -315,20 +315,17 @@ class SpoPageSetCommand extends SpoCommand_1.default {
             return isValidSharePointUrl;
         }
         if (args.options.layoutType &&
-            args.options.layoutType !== 'Article' &&
-            args.options.layoutType !== 'Home') {
-            return `${args.options.layoutType} is not a valid option for layoutType. Allowed values Article|Home`;
+            Page_1.supportedPageLayouts.indexOf(args.options.layoutType) < 0) {
+            return `${args.options.layoutType} is not a valid option for layoutType. Allowed values ${Page_1.supportedPageLayouts.join(', ')}`;
         }
         if (args.options.promoteAs &&
-            args.options.promoteAs !== 'HomePage' &&
-            args.options.promoteAs !== 'NewsPage' &&
-            args.options.promoteAs !== 'Template') {
-            return `${args.options.promoteAs} is not a valid option for promoteAs. Allowed values HomePage|NewsPage|Template`;
+            Page_1.supportedPromoteAs.indexOf(args.options.promoteAs) < 0) {
+            return `${args.options.promoteAs} is not a valid option for promoteAs. Allowed values ${Page_1.supportedPromoteAs.join(', ')}`;
         }
         if (args.options.promoteAs === 'HomePage' && args.options.layoutType !== 'Home') {
             return 'You can only promote home pages as site home page';
         }
-        if (args.options.promoteAs === 'NewsPage' && args.options.layoutType === 'Home') {
+        if (args.options.promoteAs === 'NewsPage' && args.options.layoutType && args.options.layoutType !== 'Article') {
             return 'You can only promote article pages as news article';
         }
         if (typeof args.options.commentsEnabled !== 'undefined' &&

package/dist/m365/spo/commands/site/site-remove.js

@@ -25,26 +25,65 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
     commandAction(logger, args, cb) {
         const removeSite = () => {
             this.dots = '';
-            this
-                .getSiteGroupId(args.options.url, logger)
-                .then((_groupId) => {
-                if (_groupId === '00000000-0000-0000-0000-000000000000') {
-                    if (this.debug) {
-                        logger.logToStderr('Site is not groupified. Going ahead with the conventional site deletion options');
-                    }
-                    return this.deleteSiteWithoutGroup(logger, args);
-                }
-                else {
-                    if (this.debug) {
-                        logger.logToStderr(`Site attached to group ${_groupId}. Initiating group delete operation via Graph API`);
+            if (args.options.fromRecycleBin) {
+                this
+                    .deleteSiteWithoutGroup(logger, args)
+                    .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
+            }
+            else {
+                this
+                    .getSiteGroupId(args.options.url, logger)
+                    .then((groupId) => {
+                    if (groupId === '00000000-0000-0000-0000-000000000000') {
+                        if (this.debug) {
+                            logger.logToStderr('Site is not groupified. Going ahead with the conventional site deletion options');
+                        }
+                        return this.deleteSiteWithoutGroup(logger, args);
                     }
-                    if (args.options.fromRecycleBin || args.options.skipRecycleBin || args.options.wait) {
-                        logger.log(chalk.yellow(`Entered site is a groupified site. Hence, the parameters 'fromRecycleBin' or 'skipRecycleBin' or 'wait' will not be applicable.`));
+                    else {
+                        if (this.debug) {
+                            logger.logToStderr(`Site attached to group ${groupId}. Initiating group delete operation via Graph API`);
+                        }
+                        return this
+                            .getSiteGroup(groupId)
+                            .then((group) => {
+                            if (args.options.skipRecycleBin || args.options.wait) {
+                                logger.logToStderr(chalk.yellow(`Entered site is a groupified site. Hence, the parameters 'skipRecycleBin' and 'wait' will not be applicable.`));
+                            }
+                            return this.deleteGroupifiedSite(group.id, logger);
+                        })
+                            .catch((err) => {
+                            if (err.response.status === 404) {
+                                if (this.verbose) {
+                                    logger.logToStderr(`Site group doesn't exist. Searching in the Microsoft 365 deleted groups.`);
+                                }
+                                return this
+                                    .isSiteGroupDeleted(groupId)
+                                    .then((deletedGroups) => {
+                                    if (deletedGroups.value.length === 0) {
+                                        if (this.verbose) {
+                                            logger.logToStderr("Site group doesn't exist anymore. Deleting the site.");
+                                        }
+                                        if (args.options.wait) {
+                                            logger.logToStderr(chalk.yellow(`Entered site is a groupified site. Hence, the parameter 'wait' will not be applicable.`));
+                                        }
+                                        return Promise.resolve();
+                                    }
+                                    else {
+                                        return Promise.reject(`Site group still exists in the deleted groups. The site won't be removed.`);
+                                    }
+                                })
+                                    .then(_ => this.deleteOrphanedSite(logger, args.options.url))
+                                    .catch((err) => Promise.reject(err));
+                            }
+                            else {
+                                return Promise.reject(err);
+                            }
+                        });
                     }
-                    return this.deleteGroupifiedSite(_groupId, logger);
-                }
-            })
-                .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
+                })
+                    .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
+            }
         };
         if (args.options.confirm) {
             removeSite();
@@ -65,32 +104,64 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
             });
         }
     }
+    getSiteGroup(groupId) {
+        const requestOptions = {
+            url: `https://graph.microsoft.com/v1.0/groups/${groupId}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default.get(requestOptions);
+    }
+    isSiteGroupDeleted(groupId) {
+        const requestOptions = {
+            url: `https://graph.microsoft.com/v1.0/directory/deletedItems/Microsoft.Graph.Group?$select=id&$filter=groupTypes/any(c:c+eq+'Unified') and startswith(id, '${groupId}')`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default.get(requestOptions);
+    }
+    deleteOrphanedSite(logger, url) {
+        return this
+            .getSpoAdminUrl(logger, this.debug)
+            .then((spoAdminUrl) => {
+            const requestOptions = {
+                url: `${spoAdminUrl}/_api/GroupSiteManager/Delete?siteUrl='${url}'`,
+                headers: {
+                    'content-type': 'application/json;odata=nometadata',
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.post(requestOptions);
+        });
+    }
     deleteSiteWithoutGroup(logger, args) {
         return this
             .getSpoAdminUrl(logger, this.debug)
-            .then((_spoAdminUrl) => {
-            this.spoAdminUrl = _spoAdminUrl;
+            .then((spoAdminUrl) => {
+            this.spoAdminUrl = spoAdminUrl;
             return this.ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug);
         })
             .then((res) => {
             this.context = res;
             if (args.options.fromRecycleBin) {
                 if (this.verbose) {
-                    logger.logToStderr(`Deleting site collection from recycle bin ${args.options.url}...`);
+                    logger.logToStderr(`Deleting site from recycle bin ${args.options.url}...`);
                 }
                 return this.deleteSiteFromTheRecycleBin(args.options.url, args.options.wait, logger);
             }
             else {
-                if (this.verbose) {
-                    logger.logToStderr(`Deleting site collection ${args.options.url}...`);
-                }
                 return this.deleteSite(args.options.url, args.options.wait, logger);
             }
         })
             .then(() => {
             if (args.options.skipRecycleBin) {
                 if (this.verbose) {
-                    logger.logToStderr(`Also deleting site collection from recycle bin ${args.options.url}...`);
+                    logger.logToStderr(`Also deleting site from tenant recycle bin ${args.options.url}...`);
                 }
                 return this.deleteSiteFromTheRecycleBin(args.options.url, args.options.wait, logger);
             }
@@ -106,7 +177,7 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
                 .then((res) => {
                 this.context = res;
                 if (this.verbose) {
-                    logger.logToStderr(`Deleting site ${url} ...`);
+                    logger.logToStderr(`Deleting site ${url}...`);
                 }
                 const requestOptions = {
                     url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
@@ -143,9 +214,6 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
                 .ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug)
                 .then((res) => {
                 this.context = res;
-                if (this.verbose) {
-                    logger.logToStderr(`Deleting site ${url} from the recycle bin...`);
-                }
                 const requestOptions = {
                     url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
                     headers: {
@@ -185,7 +253,7 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
             .then((res) => {
             this.context = res;
             if (this.verbose) {
-                logger.logToStderr(`Retrieving the GroupId of the site  ${url}`);
+                logger.logToStderr(`Retrieving the group Id of the site ${url}`);
             }
             const requestOptions = {
                 url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,

package/dist/m365/spo/commands/web/web-installedlanguage-list.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoWebInstalledLanguageListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.WEB_INSTALLEDLANGUAGE_LIST;
+    }
+    get description() {
+        return 'Lists all installed languages on site';
+    }
+    defaultProperties() {
+        return ['DisplayName', 'LanguageTag', 'Lcid'];
+    }
+    commandAction(logger, args, cb) {
+        if (this.verbose) {
+            logger.logToStderr(`Retrieving all installed languages on site ${args.options.webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${args.options.webUrl}/_api/web/RegionalSettings/InstalledLanguages`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((webInstalledLanguageProperties) => {
+            logger.log(webInstalledLanguageProperties.Items);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-u, --webUrl <webUrl>'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        return SpoCommand_1.default.isValidSharePointUrl(args.options.webUrl);
+    }
+}
+module.exports = new SpoWebInstalledLanguageListCommand();
+//# sourceMappingURL=web-installedlanguage-list.js.map

package/dist/m365/spo/commands.js

@@ -22,9 +22,10 @@ exports.default = {
     CDN_POLICY_SET: `${prefix} cdn policy set`,
     CDN_SET: `${prefix} cdn set`,
     CONTENTTYPE_ADD: `${prefix} contenttype add`,
-    CONTENTTYPE_GET: `${prefix} contenttype get`,
     CONTENTTYPE_FIELD_REMOVE: `${prefix} contenttype field remove`,
     CONTENTTYPE_FIELD_SET: `${prefix} contenttype field set`,
+    CONTENTTYPE_GET: `${prefix} contenttype get`,
+    CONTENTTYPE_LIST: `${prefix} contenttype list`,
     CONTENTTYPE_REMOVE: `${prefix} contenttype remove`,
     CONTENTTYPEHUB_GET: `${prefix} contenttypehub get`,
     CUSTOMACTION_ADD: `${prefix} customaction add`,
@@ -107,6 +108,7 @@ exports.default = {
     LIST_WEBHOOK_REMOVE: `${prefix} list webhook remove`,
     LIST_WEBHOOK_SET: `${prefix} list webhook set`,
     LISTITEM_ADD: `${prefix} listitem add`,
+    LISTITEM_ATTACHMENT_LIST: `${prefix} listitem attachment list`,
     LISTITEM_GET: `${prefix} listitem get`,
     LISTITEM_ISRECORD: `${prefix} listitem isrecord`,
     LISTITEM_LIST: `${prefix} listitem list`,
@@ -244,6 +246,7 @@ exports.default = {
     WEB_ADD: `${prefix} web add`,
     WEB_CLIENTSIDEWEBPART_LIST: `${prefix} web clientsidewebpart list`,
     WEB_GET: `${prefix} web get`,
+    WEB_INSTALLEDLANGUAGE_LIST: `${prefix} web installedlanguage list`,
     WEB_LIST: `${prefix} web list`,
     WEB_REINDEX: `${prefix} web reindex`,
     WEB_REMOVE: `${prefix} web remove`,

package/dist/m365/teams/commands/report/report-directroutingcalls.js

@@ -22,7 +22,7 @@ class TeamsReportDirectroutingcallsCommand extends GraphCommand_1.default {
     commandAction(logger, args, cb) {
         const toDateTimeParameter = encodeURIComponent(args.options.toDateTime ? args.options.toDateTime : new Date().toISOString());
         const requestOptions = {
-            url: `${this.resource}/beta/communications/callRecords/getDirectRoutingCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
+            url: `${this.resource}/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

package/dist/m365/teams/commands/report/report-pstncalls.js

@@ -22,7 +22,7 @@ class TeamsReportPstncallsCommand extends GraphCommand_1.default {
     commandAction(logger, args, cb) {
         const toDateTimeParameter = encodeURIComponent(args.options.toDateTime ? args.options.toDateTime : new Date().toISOString());
         const requestOptions = {
-            url: `${this.resource}/beta/communications/callRecords/getPstnCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
+            url: `${this.resource}/v1.0/communications/callRecords/getPstnCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

package/dist/request.js

@@ -16,7 +16,9 @@ class Request {
             decompress: true,
             responseType: 'text',
             /* c8 ignore next */
-            transformResponse: [data => data]
+            transformResponse: [data => data],
+            maxBodyLength: Infinity,
+            maxContentLength: Infinity
         });
         // since we're stubbing requests, request interceptor is never called in
         // tests, so let's exclude it from coverage
@@ -64,7 +66,7 @@ class Request {
             });
             // since we're stubbing requests, response interceptor is never called in
             // tests, so let's exclude it from coverage
-            /* c8 ignore next 22 */
+            /* c8 ignore next 26 */
             this.req.interceptors.response.use((response) => {
                 if (this._logger) {
                     this._logger.logToStderr('Response:');
@@ -73,19 +75,22 @@ class Request {
                         response.headers['content-type'].indexOf('json') > -1) {
                         properties.push('data');
                     }
-                    this._logger.logToStderr(JSON.stringify(Utils_1.default.filterObject(response, properties), null, 2));
+                    this._logger.logToStderr(JSON.stringify(Object.assign({ url: response.config.url }, Utils_1.default.filterObject(response, properties)), null, 2));
                 }
                 return response;
             }, (error) => {
                 if (this._logger) {
                     const properties = ['status', 'statusText', 'headers'];
                     this._logger.logToStderr('Request error:');
-                    this._logger.logToStderr(JSON.stringify(Object.assign(Object.assign({}, Utils_1.default.filterObject(error.response, properties)), { error: error.error }), null, 2));
+                    this._logger.logToStderr(JSON.stringify(Object.assign(Object.assign({ url: error.config.url }, Utils_1.default.filterObject(error.response, properties)), { error: error.error }), null, 2));
                 }
                 throw error;
             });
         }
     }
+    get logger() {
+        return this._logger;
+    }
     set logger(logger) {
         this._logger = logger;
     }

package/docs/docs/cmd/_global.md

@@ -5,10 +5,10 @@
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples
 
 `-o, --output [output]`
-: Output type. `json,text`. Default `text`
+: Output type. `json,text,csv`. Default `json`
 
 `--verbose`
 : Runs command with verbose logging
 
 `--debug`
-: Runs command with debug logging
+: Runs command with debug logging

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

@@ -52,6 +52,9 @@ m365 aad app add [options]
 `--manifest [manifest]`
 : Azure AD app manifest as retrieved from the Azure Portal to create the app registration from
 
+`--save`
+: Use to store the information about the created app in a local file
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -80,6 +83,8 @@ When using the `withSecret` option, this command will automatically generate a s
 
 After creating the Azure AD app registration, this command returns the app ID and object ID of the created app registration. If you used the `withSecret` option, it will also return the generated secret.
 
+If you want to store the information about the created Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you create the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the to it, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
+
 ## Examples
 
 Create new Azure AD app registration with the specified name
@@ -141,3 +146,9 @@ Create new Azure AD app registration with Application ID URI set to a value that
 ```sh
 m365 aad app add --name 'My AAD app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
 ```
+
+Create new Azure AD app registration with the specified name. Store information about the created app registration in the _.m365rc.json_ file in the current directory.
+
+```sh
+m365 aad app add --name 'My AAD app' --save
+```

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

@@ -0,0 +1,48 @@
+# aad app get
+
+Gets an Azure AD app registration
+
+## Usage
+
+```sh
+m365 aad app get [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Azure AD application registration to update. 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
+
+Get the Azure AD application registration by its app (client) ID
+
+```sh
+m365 aad app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Get the Azure AD application registration by its object ID
+
+```sh
+m365 aad app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Get the Azure AD application registration by its name
+
+```sh
+m365 aad app get --name "My app"
+```

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

@@ -36,6 +36,7 @@ m365 aad o365group add [options]
 ## Remarks
 
 When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
+If an invalid user is provided in the comma-separated list or Owners or Members, the command operation will fail and the Micrsoft 365 Group will not be created.
 
 ## Examples
 

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-remove.md

@@ -35,4 +35,5 @@ m365 aad oauth2grant remove --grantId YgA60KYa4UOPSdc-lpxYEnQkr8KVLDpCsOXkiV8i-e
 
 ## More information
 
-- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Delete a delegated permission grant (oAuth2PermissionGrant): [https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0)

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-set.md

@@ -22,7 +22,7 @@ m365 aad oauth2grant set [options]
 
 Before you can update service principal's OAuth2 permissions, you need to get the `objectId` of the permissions grant to update. You can retrieve it using the [aad oauth2grant list](./oauth2grant-list.md) command.
 
-If the `objectId` listed when using the [aad oauth2grant list](./oauth2grant-list.md) command has a minus sign ('-') prefix, you may receive an error indicating `--grantId` is missing.  To resolve this issue simply escape the leading '-'.  
+If the `objectId` listed when using the [aad oauth2grant list](./oauth2grant-list.md) command has a minus sign ('-') prefix, you may receive an error indicating `--grantId` is missing. To resolve this issue simply escape the leading '-'.  
 
 ```sh
 m365 aad oauth2grant set --grantId \\-Zc1JRY8REeLxmXz5KtixAYU3Q6noCBPlhwGiX7pxmU
@@ -38,4 +38,5 @@ m365 aad oauth2grant set --grantId YgA60KYa4UOPSdc-lpxYEnQkr8KVLDpCsOXkiV8i-ek -
 
 ## More information
 
-- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Update a delegated permission grant (oAuth2PermissionGrant): [https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0)

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

@@ -0,0 +1,53 @@
+# aad sp add
+
+Adds a service principal to a registered Azure AD app
+
+## Usage
+
+```sh
+m365 aad sp add [options]
+```
+
+## Options
+
+`--appId [appId]`
+: ID of the application to which the service principal should be added
+
+`--appName [appName]`
+: Display name of the application to which the service principal should be added
+
+`--objectId [objectId]`
+: ObjectId of the application to which the service principal should be added
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Specify either the `appId`, `appName` or `objectId`. If you specify more than one option value, the command will fail with an error.
+
+If you register an application in the portal, an application object as well as a service principal object are automatically created in your home tenant. If you register an application using CLI for Microsoft 365 or the Microsoft Graph, you'll need to create the service principal separately. To register/create an application using the CLI for Microsoft 365, use the [m365 aad app add](../app/app-add.md) command.
+
+## Examples
+
+Adds a service principal to a registered Azure AD app with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
+
+```sh
+m365 aad sp add --appId b2307a39-e878-458b-bc90-03bc578531d6
+```
+
+Adds a service principal to a registered Azure AD app with appName _Microsoft Graph_.
+
+```sh
+m365 aad sp add --appName "Microsoft Graph"
+```
+
+Adds a service principal to a registered Azure AD app with objectId _b2307a39-e878-458b-bc90-03bc578531d6_.
+
+```sh
+m365 aad sp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
+```
+
+## More information
+
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Create servicePrincipal: [https://docs.microsoft.com/en-us/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0)

package/docs/docs/cmd/aad/user/user-password-validate.md

@@ -0,0 +1,29 @@
+# aad user password validate
+
+Check a user's password against the organization's password validation policy
+
+## Usage
+
+```sh
+m365 aad user password validate [options]
+```
+
+## Options
+
+`-p, --password <password>`
+: The password to be validated.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Validate password _cli365P@ssW0rd_ against the organization's password validation policy
+
+```sh
+m365 aad user password validate --password "cli365P@ssW0rd"
+```