@pnp/cli-microsoft365 6.1.0-beta.3e0114a → 6.1.0-beta.539ef23

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

@@ -0,0 +1,63 @@
+"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 _SpoWebRetentionLabelListCommand_instances, _SpoWebRetentionLabelListCommand_initOptions, _SpoWebRetentionLabelListCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const odata_1 = require("../../../../utils/odata");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+const formatting_1 = require("../../../../utils/formatting");
+class SpoWebRetentionLabelListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.WEB_RETENTIONLABEL_LIST;
+    }
+    get description() {
+        return `Get a list of retention labels that are available on a site.`;
+    }
+    defaultProperties() {
+        return ['TagId', 'TagName'];
+    }
+    constructor() {
+        super();
+        _SpoWebRetentionLabelListCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoWebRetentionLabelListCommand_instances, "m", _SpoWebRetentionLabelListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoWebRetentionLabelListCommand_instances, "m", _SpoWebRetentionLabelListCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving all retention labels that are available on ${args.options.webUrl}...`);
+            }
+            const requestUrl = `${args.options.webUrl}/_api/SP.CompliancePolicy.SPPolicyStoreProxy.GetAvailableTagsForSite(siteUrl=@a1)?@a1='${formatting_1.formatting.encodeQueryParameter(args.options.webUrl)}'`;
+            try {
+                const response = yield odata_1.odata.getAllItems(requestUrl);
+                logger.log(response);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_SpoWebRetentionLabelListCommand_instances = new WeakSet(), _SpoWebRetentionLabelListCommand_initOptions = function _SpoWebRetentionLabelListCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --webUrl <webUrl>'
+    });
+}, _SpoWebRetentionLabelListCommand_initValidators = function _SpoWebRetentionLabelListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () { return validation_1.validation.isValidSharePointUrl(args.options.webUrl); }));
+};
+module.exports = new SpoWebRetentionLabelListCommand();
+//# sourceMappingURL=web-retentionlabel-list.js.map

package/dist/m365/spo/commands.js

@@ -115,6 +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_ROLEASSIGNMENT_REMOVE: `${prefix} list roleassignment remove`,
     LIST_ROLEASSIGNMENT_ADD: `${prefix} list roleassignment add`,
     LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
@@ -143,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`,
@@ -204,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`,
@@ -288,6 +292,7 @@ exports.default = {
     WEB_LIST: `${prefix} web list`,
     WEB_REINDEX: `${prefix} web reindex`,
     WEB_REMOVE: `${prefix} web remove`,
+    WEB_RETENTIONLABEL_LIST: `${prefix} web retentionlabel list`,
     WEB_ROLEASSIGNMENT_REMOVE: `${prefix} web roleassignment remove`,
     WEB_ROLEASSIGNMENT_ADD: `${prefix} web roleassignment add`,
     WEB_ROLEINHERITANCE_BREAK: `${prefix} web roleinheritance break`,

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/dist/utils/pid.js

@@ -1,13 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pid = void 0;
-const os = require("os");
-const fs = require("fs");
 const child_process_1 = require("child_process");
+const fs = require("fs");
+const os = require("os");
 const cache_1 = require("./cache");
 function getProcessNameOnMacOs(pid) {
-    const stdout = (0, child_process_1.execSync)(`ps -o comm= ${pid}`, { encoding: 'utf8' });
-    return stdout.trim();
+    const res = (0, child_process_1.spawnSync)('ps', ['-o', 'comm=', pid.toString()], { encoding: 'utf8' });
+    if (res.error || res.stderr) {
+        return undefined;
+    }
+    else {
+        return res.stdout.trim();
+    }
 }
 function getProcessNameOnLinux(pid) {
     if (!fs.existsSync(`/proc/${pid}/stat`)) {
@@ -19,8 +24,24 @@ function getProcessNameOnLinux(pid) {
     return procName;
 }
 function getProcessNameOnWindows(pid) {
-    const stdout = (0, child_process_1.execSync)(`wmic PROCESS where ProcessId=${pid} get Caption | find /V "Caption"`, { encoding: 'utf8' });
-    return stdout.trim();
+    const findProcess = (0, child_process_1.spawnSync)('wmic', ['PROCESS', 'where', `ProcessId=${pid}`, 'get', 'Caption'], { encoding: 'utf8' });
+    if (findProcess.error || findProcess.stderr) {
+        return undefined;
+    }
+    else {
+        const getPid = (0, child_process_1.spawnSync)('find', ['/V', '"Caption"'], {
+            encoding: 'utf8',
+            input: findProcess.stdout,
+            // must include or passing quoted "Caption" will fail
+            windowsVerbatimArguments: true
+        });
+        if (getPid.error || getPid.stderr) {
+            return undefined;
+        }
+        else {
+            return getPid.stdout.trim();
+        }
+    }
 }
 exports.pid = {
     getProcessName(pid) {
@@ -40,16 +61,11 @@ exports.pid = {
             getPidName = getProcessNameOnLinux;
         }
         if (getPidName) {
-            try {
-                processName = getPidName(pid);
-                if (processName) {
-                    cache_1.cache.setValue(pid.toString(), processName);
-                }
-                return processName;
-            }
-            catch (_a) {
-                return undefined;
+            processName = getPidName(pid);
+            if (processName) {
+                cache_1.cache.setValue(pid.toString(), processName);
             }
+            return processName;
         }
         return undefined;
     }

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/aad/user/user-set.md

@@ -11,13 +11,25 @@ m365 aad user set [options]
 ## Options
 
 `-i, --objectId [objectId]`
-: The object ID of the user to update. Specify `objectId` or `userPrincipalName` but not both
+: The object ID of the user to update. Specify `objectId` or `userPrincipalName` but not both.
 
 `-n, --userPrincipalName [userPrincipalName]`
-: User principal name of the user to update. Specify `objectId` or `userPrincipalName` but not both
+: User principal name of the user to update. Specify `objectId` or `userPrincipalName` but not both.
 
 `--accountEnabled [accountEnabled]`
-: Boolean value specifying whether the account is enabled. Valid values are `true,false`
+: Boolean value specifying whether the account is enabled. Valid values are `true` or `false`.
+
+`--resetPassword`
+: If specified, the password of the user will be reset. This will make the parameter `newPassword` required.
+
+`--forceChangePasswordNextSignIn`
+: If specified, the user will have to change his password the next time they log in. Can only be set in combination with `resetPassword`.
+
+`--currentPassword [currentPassword]`
+: Current password of the user that is signed in. If this parameter is set, `newPassword` is mandatory. Can't be combined with `resetPassword`.
+
+`--newPassword [newPassword]`
+: New password to be set. Must be set when specifying either `resetPassword` or `currentPassword`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -58,3 +70,19 @@ Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 ```sh
 m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
 ```
+
+Reset password of a given user by userPrincipalName and require the user to change the password on the next sign in
+
+```sh
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --resetPassword --password 6NLUId79Lc24 --forceChangePasswordNextSignIn
+```
+
+Change password of the currently logged in user
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
+```
+
+### Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,25 @@
+# context init
+
+Initiates CLI for Microsoft 365 context in the current working folder
+
+## Usage
+
+```sh
+m365 context init [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Initiates CLI for Microsoft 365 context in the current working folder
+
+```sh
+m365 context init
+```
+
+## Response
+
+The command won't return a response on success.

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/dataverse/dataverse-table-row-remove.md

@@ -0,0 +1,61 @@
+# pp dataverse table row remove
+
+Removes a row from a dataverse table in a given environment.
+
+## Usage
+
+```sh
+pp dataverse table row remove [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment to remove a row from a table from.
+
+`-i, --id <id>`
+: The id of the row to remove.
+
+`--entitySetName [entitySetName]`
+: The entity set name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--tableName [tableName]`
+: The name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--confirm`
+: Don't prompt for confirmation
+
+`--asAdmin`
+: Set, to remove the row from the dataverse table as admin for environments you are not a member of.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a row from a dataverse table in a given environment
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4"
+```
+
+Removes a row from a dataverse table in a given environment as Admin
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --asAdmin
+```
+
+Removes a row from a dataverse table in a given environment without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --confirm
+```
+
+Removes a row from a dataverse table in a given environment based on the entity set name without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --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.