@pnp/cli-microsoft365 4.2.0 → 4.3.0-beta.5bf07a3

package/dist/m365/search/commands/externalconnection/externalconnection-add.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class SearchExternalConnectionAddCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.EXTERNALCONNECTION_ADD;
+    }
+    get description() {
+        return 'Adds a new External Connection for Microsoft Search';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.authorizedAppIds = typeof args.options.authorizedAppIds !== undefined;
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        let appIds = [];
+        if (args.options.authorizedAppIds !== undefined &&
+            args.options.authorizedAppIds !== '') {
+            appIds = args.options.authorizedAppIds.split(',');
+        }
+        const commandData = {
+            id: args.options.id,
+            name: args.options.name,
+            description: args.options.description,
+            configuration: {
+                authorizedAppIds: appIds
+            }
+        };
+        const requestOptions = {
+            url: `${this.resource}/v1.0/external/connections`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json',
+            data: commandData
+        };
+        request_1.default
+            .post(requestOptions)
+            .then(_ => cb(), err => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-i, --id <id>'
+            },
+            {
+                option: '-n, --name <name>'
+            },
+            {
+                option: '-d, --description <description>'
+            },
+            {
+                option: '--authorizedAppIds [authorizedAppIds]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        const id = args.options.id;
+        if (id.length < 3 || id.length > 32) {
+            return 'ID must be between 3 and 32 characters in length.';
+        }
+        const alphaNumericRegEx = /[^\w]|_/g;
+        if (alphaNumericRegEx.test(id)) {
+            return 'ID must only contain alphanumeric characters.';
+        }
+        if (id.length > 9 &&
+            id.startsWith('Microsoft')) {
+            return 'ID cannot begin with Microsoft';
+        }
+        const invalidIds = ['None',
+            'Directory',
+            'Exchange',
+            'ExchangeArchive',
+            'LinkedIn',
+            'Mailbox',
+            'OneDriveBusiness',
+            'SharePoint',
+            'Teams',
+            'Yammer',
+            'Connectors',
+            'TaskFabric',
+            'PowerBI',
+            'Assistant',
+            'TopicEngine',
+            'MSFT_All_Connectors'
+        ];
+        if (invalidIds.indexOf(id) > -1) {
+            return `ID cannot be one of the following values: ${invalidIds.join(', ')}.`;
+        }
+        return true;
+    }
+}
+module.exports = new SearchExternalConnectionAddCommand();
+//# sourceMappingURL=externalconnection-add.js.map

package/dist/m365/search/commands.js

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

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

@@ -0,0 +1,43 @@
+# search externalconnection add
+
+Add a new external connection to be defined for Microsoft Search
+
+## Usage
+
+```sh
+m365 search externalconnection add [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: Developer-provided unique ID of the connection within the Azure Active Directory tenant
+
+`-n, --name <name>`
+: The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters
+
+`-d, --description <description>`
+: Description of the connection displayed in the Microsoft 365 admin center
+
+`--authorizedAppIds [authorizedAppIds]`
+: Comma-separated collection of application IDs for registered Azure Active Directory apps that are allowed to manage the external connection and to index content in the external connection.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+The `id` must be at least 3 and no more than 32 characters long. It can contain only alphanumeric characters, can't begin with _Microsoft_ and can be any of the following values: *None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, OneDriveBusiness, SharePoint, Teams, Yammer, Connectors, TaskFabric, PowerBI, Assistant, TopicEngine, MSFT_All_Connectors*.
+
+## Examples
+
+Adds a new external connection with name and description of test
+
+```sh
+m365 search externalconnection add --id MyApp --name "My application" --description "Description of your application"
+```
+
+Adds a new external connection with a limited number of authorized apps
+
+```sh
+m365 search externalconnection add --id MyApp --name "My application" --description "Description of your application" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
+```

package/npm-shrinkwrap.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "4.2.0",
+  "version": "4.3.0-beta.5bf07a3",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -122,6 +122,7 @@
     "Levert, Sebastien <slevert@outlook.com>",
     "Maillot, Michaël <battosaimykle@gmail.com>",
     "Mastykarz, Waldek <waldek@mastykarz.nl>",
+    "McDonnell, Kevin <kevin@mcd79.com>",
     "Menon, Arjun <arjun.umenon@gmail.com>",
     "Moujahid, Abderahman <rags_place@hotmail.com>",
     "Mücklisch, Steve <steve.muecklisch@gmail.com>",
@@ -219,4 +220,4 @@
     "rimraf": "^3.0.2",
     "sinon": "^11.1.2"
   }
-}
+}