@pnp/cli-microsoft365 5.7.0-beta.b3dfced → 5.7.0-beta.bb14b6c

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

@@ -1,4 +1,19 @@
 "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());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _YammerUserListCommand_instances, _YammerUserListCommand_initTelemetry, _YammerUserListCommand_initOptions, _YammerUserListCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
 const YammerCommand_1 = require("../../../base/YammerCommand");
@@ -6,7 +21,11 @@ const commands_1 = require("../../commands");
 class YammerUserListCommand extends YammerCommand_1.default {
     constructor() {
         super();
+        _YammerUserListCommand_instances.add(this);
         this.items = [];
+        __classPrivateFieldGet(this, _YammerUserListCommand_instances, "m", _YammerUserListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _YammerUserListCommand_instances, "m", _YammerUserListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _YammerUserListCommand_instances, "m", _YammerUserListCommand_initValidators).call(this);
     }
     get name() {
         return commands_1.default.USER_LIST;
@@ -14,15 +33,6 @@ class YammerUserListCommand extends YammerCommand_1.default {
     get description() {
         return 'Returns users from the current network';
     }
-    getTelemetryProperties(args) {
-        const telemetryProps = super.getTelemetryProperties(args);
-        telemetryProps.letter = args.options.letter !== undefined;
-        telemetryProps.sortBy = args.options.sortBy !== undefined;
-        telemetryProps.reverse = args.options.reverse !== undefined;
-        telemetryProps.limit = args.options.limit !== undefined;
-        telemetryProps.groupId = args.options.groupId !== undefined;
-        return telemetryProps;
-    }
     defaultProperties() {
         return ['id', 'full_name', 'email'];
     }
@@ -97,29 +107,32 @@ class YammerUserListCommand extends YammerCommand_1.default {
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
-    options() {
-        const options = [
-            {
-                option: '-g, --groupId [groupId]'
-            },
-            {
-                option: '-l, --letter [letter]'
-            },
-            {
-                option: '--reverse'
-            },
-            {
-                option: '--limit [limit]'
-            },
-            {
-                option: '--sortBy [sortBy]',
-                autocomplete: ['messages', 'followers']
-            }
-        ];
-        const parentOptions = super.options();
-        return options.concat(parentOptions);
-    }
-    validate(args) {
+}
+_YammerUserListCommand_instances = new WeakSet(), _YammerUserListCommand_initTelemetry = function _YammerUserListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            letter: args.options.letter !== undefined,
+            sortBy: args.options.sortBy !== undefined,
+            reverse: args.options.reverse !== undefined,
+            limit: args.options.limit !== undefined,
+            groupId: args.options.groupId !== undefined
+        });
+    });
+}, _YammerUserListCommand_initOptions = function _YammerUserListCommand_initOptions() {
+    this.options.unshift({
+        option: '-g, --groupId [groupId]'
+    }, {
+        option: '-l, --letter [letter]'
+    }, {
+        option: '--reverse'
+    }, {
+        option: '--limit [limit]'
+    }, {
+        option: '--sortBy [sortBy]',
+        autocomplete: ['messages', 'followers']
+    });
+}, _YammerUserListCommand_initValidators = function _YammerUserListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
         if (args.options.groupId && typeof args.options.groupId !== 'number') {
             return `${args.options.groupId} is not a number`;
         }
@@ -136,7 +149,7 @@ class YammerUserListCommand extends YammerCommand_1.default {
             return `Only one char as value of 'letter' accepted.`;
         }
         return true;
-    }
-}
+    }));
+};
 module.exports = new YammerUserListCommand();
 //# sourceMappingURL=user-list.js.map

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

@@ -1,4 +1,19 @@
 "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());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _YammerSearchCommand_instances, _YammerSearchCommand_initTelemetry, _YammerSearchCommand_initOptions, _YammerSearchCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../request");
 const YammerCommand_1 = require("../../base/YammerCommand");
@@ -6,6 +21,7 @@ const commands_1 = require("../commands");
 class YammerSearchCommand extends YammerCommand_1.default {
     constructor() {
         super();
+        _YammerSearchCommand_instances.add(this);
         this.summary = {
             messages: 0,
             groups: 0,
@@ -16,6 +32,9 @@ class YammerSearchCommand extends YammerCommand_1.default {
         this.groups = [];
         this.topics = [];
         this.users = [];
+        __classPrivateFieldGet(this, _YammerSearchCommand_instances, "m", _YammerSearchCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _YammerSearchCommand_instances, "m", _YammerSearchCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _YammerSearchCommand_instances, "m", _YammerSearchCommand_initValidators).call(this);
     }
     get name() {
         return commands_1.default.SEARCH;
@@ -23,12 +42,6 @@ class YammerSearchCommand extends YammerCommand_1.default {
     get description() {
         return 'Returns a list of messages, users, topics and groups that match the specified query.';
     }
-    getTelemetryProperties(args) {
-        const telemetryProps = super.getTelemetryProperties(args);
-        telemetryProps.show = typeof args.options.show !== 'undefined';
-        telemetryProps.limit = typeof args.options.limit !== 'undefined';
-        return telemetryProps;
-    }
     getAllItems(logger, args, page) {
         return new Promise((resolve, reject) => {
             const endpoint = `${this.resource}/v1/search.json?search=${encodeURIComponent(args.options.queryText)}&page=${page}`;
@@ -177,23 +190,25 @@ class YammerSearchCommand extends YammerCommand_1.default {
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
-    options() {
-        const options = [
-            {
-                option: '--queryText <queryText>'
-            },
-            {
-                option: '--show [show]',
-                autocomplete: YammerSearchCommand.showOptions
-            },
-            {
-                option: '--limit [limit]'
-            }
-        ];
-        const parentOptions = super.options();
-        return options.concat(parentOptions);
-    }
-    validate(args) {
+}
+_YammerSearchCommand_instances = new WeakSet(), _YammerSearchCommand_initTelemetry = function _YammerSearchCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            show: typeof args.options.show !== 'undefined',
+            limit: typeof args.options.limit !== 'undefined'
+        });
+    });
+}, _YammerSearchCommand_initOptions = function _YammerSearchCommand_initOptions() {
+    this.options.unshift({
+        option: '--queryText <queryText>'
+    }, {
+        option: '--show [show]',
+        autocomplete: YammerSearchCommand.showOptions
+    }, {
+        option: '--limit [limit]'
+    });
+}, _YammerSearchCommand_initValidators = function _YammerSearchCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
         if (args.options.queryText && typeof args.options.queryText !== 'string') {
             return `${args.options.queryText} is not a string`;
         }
@@ -214,8 +229,8 @@ class YammerSearchCommand extends YammerCommand_1.default {
             }
         }
         return true;
-    }
-}
+    }));
+};
 YammerSearchCommand.showOptions = [
     'summary', 'messages', 'users', 'topics', 'groups'
 ];

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

@@ -58,6 +58,9 @@ m365 aad app add [options]
 `--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`
 
+`--grantAdminConsent`
+: 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
 
@@ -94,6 +97,8 @@ After creating the Azure AD app registration, this command returns the app ID an
 
 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.
 
+When specifying `--grantAdminConsent` option, a service principal will be created for the app registration.
+
 ## Examples
 
 Create new Azure AD app registration with the specified name
@@ -156,6 +161,12 @@ Create new Azure AD app registration with Application ID URI set to a value that
 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 for a deamon app with specified Microsoft Graph application permissions, including admin consent
+
+```sh
+ m365 aad app add --name 'My AAD app' --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All' --grantAdminConsent
+```
+
 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
@@ -165,5 +176,5 @@ m365 aad app add --name 'My AAD app' --save
 Create new Azure AD app registration with a certificate
 
 ```sh
-m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate name" --certificateFile c:\temp\some-certificate.cer
+m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
 ```

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

@@ -85,5 +85,5 @@ m365 aad app set --objectId 95cfe30d-ed44-4f9d-b73d-c66560f72e83 --redirectUris
 Add a certificate to the app
 
 ```sh
-m365 aad app set --certificateDisplayName "Some certificate name" --certificateFile c:\temp\some-certificate.cer
+m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
 ```

package/docs/docs/cmd/booking/business/business-get.md

@@ -0,0 +1,33 @@
+# booking business get
+
+Retrieve the specified Microsoft Bookings business.
+
+## Usage
+
+```sh
+m365 booking business get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the business. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: Name of the business. Specify either `id` or `name` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieve the specified Microsoft Bookings business with id _business@contoso.onmicrosoft.com_.
+
+```sh
+m365 booking business get --id 'business@contoso.onmicrosoft.com'
+```
+
+Retrieve the specified Microsoft Bookings business with name _business name_.
+
+```sh
+m365 booking business get --name 'business name'
+```

package/docs/docs/cmd/booking/business/business-list.md

@@ -0,0 +1,21 @@
+# booking business list
+
+Lists all Microsoft Bookings businesses that are created for the tenant.
+
+## Usage
+
+```sh
+m365 booking business list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Returns a list of all Microsoft Bookings businesses that are created for the tenant.
+
+```sh
+m365 booking business list
+```

package/docs/docs/cmd/search/externalconnection/externalconnection-remove.md

@@ -0,0 +1,40 @@
+# search externalconnection remove
+
+Allow the administrator to remove a specific external connection used in Microsoft Search.
+
+## Usage
+
+```sh
+m365 search externalconnection remove [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the External Connection to remove. Specify either `id` or `name`
+
+`-n, --name [name]`
+: Name of the External Connection to remove. Specify either `id` or `name`
+
+`--confirm`
+: Don't prompt for confirming removing the connection
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+If the command finds multiple external connections used in Microsoft Search with the specified name, it will prompt you to disambiguate which external connection it should remove, listing the discovered IDs.
+
+## Examples
+
+Removes external connection with id _MyApp_
+
+```sh
+m365 search externalconnection remove --id "MyApp"
+```
+
+Removes external connection with name _Test_. Will NOT prompt for confirmation before removing.
+
+```sh
+m365 search externalconnection remove --name "Test" --confirm
+```

package/docs/docs/cmd/spo/list/list-roleassignment-add.md

@@ -0,0 +1,78 @@
+# spo list roleassignment add
+
+Adds a role assignment to list permissions
+
+## Usage
+
+```sh
+m365 spo list roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located
+
+`-i, --listId [listId]`
+: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--listUrl [listUrl]`
+: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: Upn/email of user to assign role to. Specify either upn or princpialId
+
+`--groupName [groupName]`
+: Enter group name of Azure AD or SharePoint group.. Specify either groupName or princpialId
+
+`--roleDefinitionId [roleDefinitionId]`
+: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+
+`--roleDefinitionName [roleDefinitionName]`
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _0CD891EF-AFCE-4E55-B836-FCE03286CCCF_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _sites/documents_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for upn _someaccount@tenant.onmicrosoft.com_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for group _someGroup_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition name _Full Control_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
+```

package/docs/docs/cmd/spo/list/list-roleassignment-remove.md

@@ -0,0 +1,54 @@
+# spo list roleassignment remove
+
+Removes a role assignment from list permissions
+
+## Usage
+
+```sh
+m365 spo list roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located
+
+`-i, --listId [listId]`
+: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--listUrl [listUrl]`
+: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to remove permissions Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: upn/email of user. Specify either upn or princpialId.
+
+`--groupName [groupName]`
+: enter group name of Azure AD or SharePoint group. Specify either groupName or princpialId.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from list by title based on group name
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --groupName "saleGroup"
+```
+
+Remove roleassignment from list by title based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --principalId 2
+```
+
+Remove roleassignment from list by url based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
+```

package/docs/docs/cmd/spo/navigation/navigation-node-add.md

@@ -13,7 +13,7 @@ m365 spo navigation node add [options]
 `-u, --webUrl <webUrl>`
 : Absolute URL of the site to which navigation should be modified
 
-`-l, --location <location>`
+`-l, --location [location]`
 : Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`
 
 `-t, --title <title>`

package/docs/docs/cmd/spo/roledefinition/roledefinition-get.md

@@ -1,6 +1,6 @@
 # spo roledefinition get
 
-Gets specified role definition from web by id
+Gets specified role definition from web
 
 ## Usage
 

package/docs/docs/cmd/spo/web/web-roleinheritance-reset.md

@@ -0,0 +1,24 @@
+# spo web roleinheritance reset
+
+Restores role inheritance of subsite.
+
+## Usage
+
+```sh
+m365 spo web roleinheritance reset [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Restore role inheritance of subsite _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo web roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x
+```

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "5.6.0",
+      "version": "5.7.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.11.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.7.0-beta.b3dfced",
+  "version": "5.7.0-beta.bb14b6c",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -86,6 +86,16 @@
       "name": "Martin Lingstuyl",
       "email": "mlingstuyl@live.com",
       "web": "https://www.blimped.nl/"
+    },
+    {
+      "name": "Jasey Waegebaert",
+      "email": "jaseyw@gmigroup.be",
+      "web": "https://github.com/Jwaegebaert"
+    },
+    {
+      "name": "Milan Holemans",
+      "email": "Milan.Holemans@vanroey.be",
+      "web": "https://github.com/milanholemans"
     }
   ],
   "contributors": [