@pnp/cli-microsoft365 6.1.0-beta.c68d208 → 6.1.0-beta.d3a109a

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

@@ -77,28 +77,21 @@ class SpoPageSetCommand extends SpoCommand_1.default {
                     authorByline = page.AuthorByline;
                 }
                 if (args.options.layoutType) {
-                    const requestOptions = {
-                        url: `${args.options.webUrl}/_api/web/getfilebyserverrelativeurl('${serverRelativeFileUrl}')/ListItemAllFields`,
-                        headers: {
-                            'X-RequestDigest': requestDigest,
-                            'content-type': 'application/json;odata=nometadata',
-                            'X-HTTP-Method': 'MERGE',
-                            'IF-MATCH': '*',
-                            accept: 'application/json;odata=nometadata'
-                        },
-                        data: {
-                            PageLayoutType: args.options.layoutType
-                        },
-                        responseType: 'json'
+                    const itemId = yield this.getFileListItemId(args.options.webUrl, serverRelativeFileUrl);
+                    const listItemSetOptions = {
+                        webUrl: args.options.webUrl,
+                        listUrl: listServerRelativeUrl,
+                        id: itemId,
+                        systemUpdate: true,
+                        PageLayoutType: args.options.layoutType,
+                        verbose: this.verbose,
+                        debug: this.debug
                     };
                     if (args.options.layoutType === 'Article') {
-                        requestOptions.data.PromotedState = 0;
-                        requestOptions.data.BannerImageUrl = {
-                            Description: '/_layouts/15/images/sitepagethumbnail.png',
-                            Url: `${resource}/_layouts/15/images/sitepagethumbnail.png`
-                        };
+                        listItemSetOptions.PromotedState = 0;
+                        listItemSetOptions.BannerImageUrl = `${resource}/_layouts/15/images/sitepagethumbnail.png, /_layouts/15/images/sitepagethumbnail.png`;
                     }
-                    yield request_1.default.post(requestOptions);
+                    yield Cli_1.Cli.executeCommand(spoListItemSetCommand, { options: Object.assign(Object.assign({}, listItemSetOptions), { _: [] }) });
                 }
                 if (args.options.promoteAs) {
                     const requestOptions = {
@@ -117,60 +110,50 @@ class SpoPageSetCommand extends SpoCommand_1.default {
                             requestOptions.data = {
                                 WelcomePage: `SitePages/${pageName}`
                             };
+                            yield request_1.default.post(requestOptions);
                             break;
                         case 'NewsPage':
-                            requestOptions.url = `${args.options.webUrl}/_api/web/getfilebyserverrelativeurl('${serverRelativeFileUrl}')/ListItemAllFields`;
-                            requestOptions.headers = {
-                                'X-RequestDigest': requestDigest,
-                                'X-HTTP-Method': 'MERGE',
-                                'IF-MATCH': '*',
-                                'content-type': 'application/json;odata=nometadata',
-                                accept: 'application/json;odata=nometadata'
-                            };
-                            requestOptions.data = {
+                            const newsPageItemId = yield this.getFileListItemId(args.options.webUrl, serverRelativeFileUrl);
+                            const listItemSetOptions = {
+                                webUrl: args.options.webUrl,
+                                listUrl: listServerRelativeUrl,
+                                id: newsPageItemId,
+                                systemUpdate: true,
                                 PromotedState: 2,
-                                FirstPublishedDate: new Date().toISOString().replace('Z', '')
+                                FirstPublishedDate: new Date().toISOString(),
+                                verbose: this.verbose,
+                                debug: this.debug
                             };
+                            yield Cli_1.Cli.executeCommand(spoListItemSetCommand, { options: Object.assign(Object.assign({}, listItemSetOptions), { _: [] }) });
                             break;
                         case 'Template':
-                            requestOptions.url = `${args.options.webUrl}/_api/web/getfilebyserverrelativeurl('${serverRelativeFileUrl}')/ListItemAllFields`;
+                            const templateItemId = yield this.getFileListItemId(args.options.webUrl, serverRelativeFileUrl);
                             requestOptions.headers = {
-                                'X-RequestDigest': requestDigest,
-                                'content-type': 'application/json;odata=nometadata',
-                                accept: 'application/json;odata=nometadata'
-                            };
-                            break;
-                    }
-                    const pageRes = yield request_1.default.post(requestOptions);
-                    if (args.options.promoteAs === 'Template') {
-                        const requestOptions = {
-                            responseType: 'json',
-                            url: `${args.options.webUrl}/_api/SitePages/Pages(${pageRes.Id})/SavePageAsTemplate`,
-                            headers: {
                                 'X-RequestDigest': requestDigest,
                                 'content-type': 'application/json;odata=nometadata',
                                 'X-HTTP-Method': 'POST',
                                 'IF-MATCH': '*',
                                 accept: 'application/json;odata=nometadata'
+                            };
+                            requestOptions.url = `${args.options.webUrl}/_api/SitePages/Pages(${templateItemId})/SavePageAsTemplate`;
+                            const res = yield request_1.default.post(requestOptions);
+                            if (fileNameWithoutExtension) {
+                                pageData.Title = fileNameWithoutExtension;
+                            }
+                            if (pageDescription) {
+                                pageData.Description = pageDescription;
                             }
-                        };
-                        const res = yield request_1.default.post(requestOptions);
-                        if (fileNameWithoutExtension) {
-                            pageData.Title = fileNameWithoutExtension;
-                        }
-                        if (pageDescription) {
-                            pageData.Description = pageDescription;
-                        }
-                        if (res.BannerImageUrl) {
-                            pageData.BannerImageUrl = res.BannerImageUrl;
-                        }
-                        if (res.LayoutWebpartsContent) {
-                            pageData.LayoutWebpartsContent = res.LayoutWebpartsContent;
-                        }
-                        if (res.CanvasContent1) {
-                            pageData.CanvasContent1 = res.CanvasContent1;
-                        }
-                        pageId = res.Id;
+                            if (res.BannerImageUrl) {
+                                pageData.BannerImageUrl = res.BannerImageUrl;
+                            }
+                            if (res.LayoutWebpartsContent) {
+                                pageData.LayoutWebpartsContent = res.LayoutWebpartsContent;
+                            }
+                            if (res.CanvasContent1) {
+                                pageData.CanvasContent1 = res.CanvasContent1;
+                            }
+                            pageId = res.Id;
+                            break;
                     }
                 }
                 if (args.options.promoteAs !== 'Template') {
@@ -239,19 +222,11 @@ class SpoPageSetCommand extends SpoCommand_1.default {
                     yield request_1.default.post(requestOptions);
                 }
                 if (args.options.demoteFrom === 'NewsPage') {
-                    const fileGetOptions = {
-                        webUrl: args.options.webUrl,
-                        url: serverRelativeFileUrl,
-                        asListItem: true,
-                        verbose: this.verbose,
-                        debug: this.debug
-                    };
-                    const fileGetOutput = yield Cli_1.Cli.executeCommandWithOutput(spoFileGetCommand, { options: Object.assign(Object.assign({}, fileGetOptions), { _: [] }) });
-                    const fileGetOutputJson = JSON.parse(fileGetOutput.stdout);
+                    const fileId = yield this.getFileListItemId(args.options.webUrl, serverRelativeFileUrl);
                     const listItemSetOptions = {
                         webUrl: args.options.webUrl,
                         listUrl: listServerRelativeUrl,
-                        id: fileGetOutputJson.Id,
+                        id: fileId,
                         systemUpdate: true,
                         PromotedState: 0,
                         verbose: this.verbose,
@@ -292,6 +267,20 @@ class SpoPageSetCommand extends SpoCommand_1.default {
             }
         });
     }
+    getFileListItemId(webUrl, serverRelativeFileUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const fileGetOptions = {
+                webUrl: webUrl,
+                url: serverRelativeFileUrl,
+                asListItem: true,
+                verbose: this.verbose,
+                debug: this.debug
+            };
+            const fileGetOutput = yield Cli_1.Cli.executeCommandWithOutput(spoFileGetCommand, { options: Object.assign(Object.assign({}, fileGetOptions), { _: [] }) });
+            const fileGetOutputJson = JSON.parse(fileGetOutput.stdout);
+            return fileGetOutputJson.Id;
+        });
+    }
 }
 _SpoPageSetCommand_instances = new WeakSet(), _SpoPageSetCommand_initTelemetry = function _SpoPageSetCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/spo/commands/site/site-appcatalog-list.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 });
+const odata_1 = require("../../../../utils/odata");
+const spo_1 = require("../../../../utils/spo");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoSiteAppCatalogListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.SITE_APPCATALOG_LIST;
+    }
+    get description() {
+        return 'List all site collection app catalogs within the tenant';
+    }
+    defaultProperties() {
+        return ['AbsoluteUrl', 'SiteID'];
+    }
+    commandAction(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.verbose) {
+                    logger.logToStderr('Retrieving site collection app catalogs...');
+                }
+                const spoUrl = yield spo_1.spo.getSpoUrl(logger, this.debug);
+                const appCatalogs = yield odata_1.odata.getAllItems(`${spoUrl}/_api/Web/TenantAppCatalog/SiteCollectionAppCatalogsSites`);
+                logger.log(appCatalogs);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+module.exports = new SpoSiteAppCatalogListCommand();
+//# sourceMappingURL=site-appcatalog-list.js.map

package/dist/m365/spo/commands.js

@@ -115,8 +115,8 @@ exports.default = {
     LIST_LABEL_SET: `${prefix} list label set`,
     LIST_LIST: `${prefix} list list`,
     LIST_REMOVE: `${prefix} list remove`,
+    LIST_RETENTIONLABEL_ENSURE: `${prefix} list retentionlabel ensure`,
     LIST_RETENTIONLABEL_GET: `${prefix} list retentionlabel get`,
-    LIST_RETENTIONLABEL_SET: `${prefix} list retentionlabel set`,
     LIST_ROLEASSIGNMENT_REMOVE: `${prefix} list roleassignment remove`,
     LIST_ROLEASSIGNMENT_ADD: `${prefix} list roleassignment add`,
     LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
@@ -145,6 +145,7 @@ exports.default = {
     LISTITEM_RECORD_DECLARE: `${prefix} listitem record declare`,
     LISTITEM_RECORD_UNDECLARE: `${prefix} listitem record undeclare`,
     LISTITEM_REMOVE: `${prefix} listitem remove`,
+    LISTITEM_RETENTIONLABEL_REMOVE: `${prefix} listitem retentionlabel remove`,
     LISTITEM_ROLEASSIGNMENT_ADD: `${prefix} listitem roleassignment add`,
     LISTITEM_ROLEASSIGNMENT_REMOVE: `${prefix} listitem roleassignment remove`,
     LISTITEM_ROLEINHERITANCE_BREAK: `${prefix} listitem roleinheritance break`,
@@ -206,6 +207,7 @@ exports.default = {
     SET: `${prefix} set`,
     SITE_ADD: `${prefix} site add`,
     SITE_APPCATALOG_ADD: `${prefix} site appcatalog add`,
+    SITE_APPCATALOG_LIST: `${prefix} site appcatalog list`,
     SITE_APPCATALOG_REMOVE: `${prefix} site appcatalog remove`,
     SITE_APPPERMISSION_ADD: `${prefix} site apppermission add`,
     SITE_APPPERMISSION_GET: `${prefix} site apppermission get`,

package/dist/request.js

@@ -61,7 +61,8 @@ class Request {
         this.req = axios_1.default.create({
             headers: {
                 'user-agent': `NONISV|SharePointPnP|CLIMicrosoft365/${packageJSON.version}`,
-                'accept-encoding': 'gzip, deflate'
+                'accept-encoding': 'gzip, deflate',
+                'X-ClientService-ClientTag': `M365CLI:${packageJSON.version}`
             },
             decompress: true,
             responseType: 'text',

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

@@ -0,0 +1,127 @@
+# aad group get
+
+Gets information about the specified Azure AD Group
+
+## Usage
+
+```sh
+m365 aad group get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: The object Id of the Azure AD group. Specify either `id` or `title` but not both
+
+`-t, --title [title]`
+: The display name of the Azure AD group. Specify either `id` or `title` but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get information about an Azure AD Group by id
+
+```sh
+m365 aad group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+```
+
+Get information about an Azure AD Group by title
+
+```sh
+m365 aad group get --title "Finance"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "c541afac-508e-40c7-8880-5a601b41737b",
+      "deletedDateTime": null,
+      "classification": null,
+      "createdDateTime": "2022-11-13T19:16:32Z",
+      "creationOptions": [
+        "YammerProvisioning"
+      ],
+      "description": "This is the default group for everyone in the network",
+      "displayName": "All Company",
+      "expirationDateTime": null,
+      "groupTypes": [
+        "Unified"
+      ],
+      "isAssignableToRole": null,
+      "mail": "allcompany@contoso.onmicrosoft.com",
+      "mailEnabled": true,
+      "mailNickname": "allcompany",
+      "membershipRule": null,
+      "membershipRuleProcessingState": null,
+      "onPremisesDomainName": null,
+      "onPremisesLastSyncDateTime": null,
+      "onPremisesNetBiosName": null,
+      "onPremisesSamAccountName": null,
+      "onPremisesSecurityIdentifier": null,
+      "onPremisesSyncEnabled": null,
+      "preferredDataLocation": null,
+      "preferredLanguage": null,
+      "proxyAddresses": [
+        "SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac",
+        "SMTP:allcompany@contoso.onmicrosoft.com"
+      ],
+      "renewedDateTime": "2022-11-13T19:16:32Z",
+      "resourceBehaviorOptions": [
+        "CalendarMemberReadOnly"
+      ],
+      "resourceProvisioningOptions": [],
+      "securityEnabled": false,
+      "securityIdentifier": "S-1-12-1-4076547856-1079300050-1399127439-2879739702",
+      "theme": null,
+      "visibility": "Public",
+      "onPremisesProvisioningErrors": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    classification               : null
+    createdDateTime              : 2022-11-13T19:16:32Z
+    creationOptions              : ["YammerProvisioning"]
+    deletedDateTime              : null
+    description                  : This is the default group for everyone in the network
+    displayName                  : All Company
+    expirationDateTime           : null
+    groupTypes                   : ["Unified"]
+    id                           : c541afac-508e-40c7-8880-5a601b41737b
+    isAssignableToRole           : null
+    mail                         : allcompany@contoso.onmicrosoft.com
+    mailEnabled                  : true
+    mailNickname                 : allcompany
+    membershipRule               : null
+    membershipRuleProcessingState: null
+    onPremisesDomainName         : null
+    onPremisesLastSyncDateTime   : null
+    onPremisesNetBiosName        : null
+    onPremisesProvisioningErrors : []
+    onPremisesSamAccountName     : null
+    onPremisesSecurityIdentifier : null
+    onPremisesSyncEnabled        : null
+    preferredDataLocation        : null
+    preferredLanguage            : null
+    proxyAddresses               : ["SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac","SMTP:allcompany@contoso.onmicrosoft.com"]
+    renewedDateTime              : 2022-11-13T19:16:32Z
+    resourceBehaviorOptions      : ["CalendarMemberReadOnly"]
+    resourceProvisioningOptions  : []
+    securityEnabled              : false
+    securityIdentifier           : S-1-12-1-4076547856-1079300050-1399127439-2879739702
+    theme                        : null
+    visibility                   : Public
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,deletedDateTime,classification,createdDateTime,creationOptions,description,displayName,expirationDateTime,groupTypes,isAssignableToRole,mail,mailEnabled,mailNickname,membershipRule,membershipRuleProcessingState,onPremisesDomainName,onPremisesLastSyncDateTime,onPremisesNetBiosName,onPremisesSamAccountName,onPremisesSecurityIdentifier,onPremisesSyncEnabled,preferredDataLocation,preferredLanguage,proxyAddresses,renewedDateTime,resourceBehaviorOptions,resourceProvisioningOptions,securityEnabled,securityIdentifier,theme,visibility,onPremisesProvisioningErrors
+    c541afac-508e-40c7-8880-5a601b41737b,,,2022-11-13T19:16:32Z,"[""YammerProvisioning""]",This is the default group for everyone in the network,All Company,,"[""Unified""]",,allcompany@contoso.onmicrosoft.com,1,allcompany,,,,,,,,,,,"[""SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac"",""SMTP:allcompany@contoso.onmicrosoft.com""]",2022-11-13T19:16:32Z,"[""CalendarMemberReadOnly""]",[],,S-1-12-1-4076547856-1079300050-1399127439-2879739702,,Public,[]
+    ```

package/docs/docs/cmd/context/context-remove.md

@@ -0,0 +1,34 @@
+# context remove
+
+Removes the CLI for Microsoft 365 context in the current working folder
+
+## Usage
+
+```sh
+m365 context remove [options]
+```
+
+## Options
+
+`--confirm`
+: Don't prompt for confirmation to remove the context
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the CLI for Microsoft 365 context in the current working folder
+
+```sh
+m365 context remove
+```
+
+Removes the CLI for Microsoft 365 context in the current working folder and does not prompt for confirmation before deleting.
+
+```sh
+m365 context remove --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/environment/environment-get.md

@@ -10,11 +10,11 @@ m365 pp environment get [options]
 
 ## Options
 
-`-n, --name <name>`
-: The name of the environment to get information about
+`-n, --name [name]`
+: The name of the environment. When not specified, the default environment is retrieved.
 
 `--asAdmin`
-: Run the command as admin and retrieve details of environments you do not have explicitly assigned permissions to
+: Run the command as admin and retrieve details of environments you do not have explicitly assigned permissions to.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -39,6 +39,12 @@ Get information as admin about the Power Platform environment by name
 m365 pp environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
+Get information about the default Power Platform environment
+
+```sh
+m365 pp environment get
+```
+
 ## Response
 
 === "JSON"

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-set.md

@@ -0,0 +1,63 @@
+# purview retentionlabel set
+
+Update a retention label
+
+## Usage
+
+```sh
+m365 purview retentionlabel set [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention label.
+
+`--behaviorDuringRetentionPeriod [behaviorDuringRetentionPeriod]`
+: Specifies how the behavior of a document with this label should be during the retention period. Allowed values: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`.
+
+`--actionAfterRetentionPeriod [actionAfterRetentionPeriod]`
+: Specifies the action to take on a document with this label applied after the retention period. Allowed values: `none`, `delete`, `startDispositionReview`.
+
+`--retentionDuration [retentionDuration]`
+: The number of days to retain the content.
+
+`-t, --retentionTrigger [retentionTrigger]`
+: Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. Allowed values: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`.
+
+`--defaultRecordBehavior [defaultRecordBehavior]`
+: Specifies the locked or unlocked state of a record label when it is created. Allowed values: `startLocked`, `startUnlocked`.
+
+`--descriptionForUsers [descriptionForUsers]`
+: The label information for the user.
+
+`--descriptionForAdmins [descriptionForAdmins]`
+: The label information for the admin.
+
+`--labelToBeApplied [labelToBeApplied]`
+: Specifies the replacement label to be applied automatically after the retention period of the current label ends.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Update a retention label so that it retains documents as records and deletes them after one year.
+
+```sh
+m365 purview retentionlabel set --id c37d695e-d581-4ae9-82a0-9364eba4291e --behaviorDuringRetentionPeriod retainAsRecord --actionAfterRetentionPeriod delete --retentionDuration 365
+```
+
+Update a retention label so that it retains documents as regulatory records and starts a disposition review one year after the last modification date.
+
+```sh
+m365 purview retentionlabel set --id c37d695e-d581-4ae9-82a0-9364eba4291e --behaviorDuringRetentionPeriod retainAsRegulatoryRecord --actionAfterRetentionPeriod startDispositionReview --retentionDuration 365 --retentionTrigger dateModified
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/search/externalconnection/externalconnection-schema-add.md

@@ -0,0 +1,31 @@
+# search externalconnection schema add
+
+This command allows the administrator to add a schema to a specific external connection for use in Microsoft Search.
+
+## Usage
+
+```sh
+m365 search externalconnection schema add [options]
+```
+
+## Options
+
+`-i, --externalConnectionId  <externalConnectionId>`
+: ID of the External Connection.
+
+`-s, --schema [schema]`
+: The schema object to be added.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Adds a new schema to a specific external connection.
+
+```sh
+m365 search externalconnection schema add --externalConnectionId 'CliConnectionId' --schema '{"baseType":"microsoft.graph.externalItem","properties":[{"name":"ticketTitle","type":"String","isSearchable":"true","isRetrievable":"true","labels":["title"]},{"name":"priority","type":"String","isQueryable":"true","isRetrievable":"true","isSearchable":"false"},{"name":"assignee","type":"String","isRetrievable":"true"}]}'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/group/group-member-add.md

@@ -20,10 +20,13 @@ m365 spo group member add [options]
 : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
 
 `--userName [userName]`
-: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
 
 `--email [email]`
-: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
+: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
+
+`--userId [userId]`
+: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Id's have to be comma separated. Specify either `userName`, `email` or `userId`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,26 +36,75 @@ For the `--userName` or `--email` options you can specify multiple values by sep
 
 ## Examples
 
-Add a user with name _Alex.Wilber@contoso.com_ to the SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+Add a user with the userName parameter to a SharePoint group with the groupId parameter
 
 ```sh
 m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
 ```
 
-Add multiple users by name to the SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+Add multiple users with the userName parameter to a SharePoint group with the groupId parameter
 
 ```sh
 m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```
 
-Add a user with email _Alex.Wilber@contoso.com_ to the SharePoint group with name _Contoso Site Owners_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+Add a user with the email parameter to a SharePoint group with the groupName parameter
 
 ```sh
 m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com"
 ```
 
-Add multiple users by email to the SharePoint group with name _Contoso Site Owners_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+Add multiple users with the email parameter to a SharePoint group with the groupName parameter
 
 ```sh
 m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```
+
+Add a user with the userId parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId 5
+```
+
+Add multiple users with the userId parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "AllowedRoles": [
+          0
+        ],
+        "CurrentRole": 0,
+        "DisplayName": "John Doe",
+        "Email": "john.doe@contoso.onmicrosoft.com",
+        "InvitationLink": null,
+        "IsUserKnown": true,
+        "Message": null,
+        "Status": true,
+        "User": "i:0#.f|membership|john.doe@contoso.onmicrosoft.com"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    DisplayName  Email
+    -----------  ---------------------------------
+    John Doe     john.doe@contoso.onmicrosoft.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    DisplayName,Email
+    John Doe,john.doe@contoso.onmicrosoft.com
+    ```