@pnp/cli-microsoft365 7.2.0-beta.2970c86 → 7.2.0-beta.41f58dd

package/dist/m365/yammer/commands/group/group-user-remove.js

@@ -31,13 +31,8 @@ class YammerGroupUserRemoveCommand extends YammerCommand {
             if (args.options.id) {
                 messagePrompt = `Are you sure you want to remove the user ${args.options.id} from the group ${args.options.groupId}?`;
             }
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: messagePrompt
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: messagePrompt });
+            if (result) {
                 await this.executeRemoveAction(args.options);
             }
         }

package/dist/m365/yammer/commands/message/message-like-set.js

@@ -29,14 +29,9 @@ class YammerMessageLikeSetCommand extends YammerCommand {
                 await this.executeLikeAction(args.options);
             }
             else {
-                const messagePrompt = `Are you sure you want to unlike message ${args.options.messageId}?`;
-                const result = await Cli.prompt({
-                    type: 'confirm',
-                    name: 'continue',
-                    default: false,
-                    message: messagePrompt
-                });
-                if (result.continue) {
+                const message = `Are you sure you want to unlike message ${args.options.messageId}?`;
+                const result = await Cli.promptForConfirmation({ message });
+                if (result) {
                     await this.executeLikeAction(args.options);
                 }
             }

package/dist/m365/yammer/commands/message/message-remove.js

@@ -27,13 +27,8 @@ class YammerMessageRemoveCommand extends YammerCommand {
             await this.removeMessage(args.options);
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the Yammer message ${args.options.id}?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the Yammer message ${args.options.id}?` });
+            if (result) {
                 await this.removeMessage(args.options);
             }
         }

package/dist/request.js

@@ -3,6 +3,7 @@ import { Stream } from 'stream';
 import auth, { Auth } from './Auth.js';
 import { app } from './utils/app.js';
 import { formatting } from './utils/formatting.js';
+import { timings } from './cli/timings.js';
 class Request {
     set debug(debug) {
         // if the value to set is the same as current value return early to avoid
@@ -125,6 +126,7 @@ class Request {
         return this.execute(options);
     }
     execute(options, resolve, reject) {
+        const start = process.hrtime.bigint();
         if (!this._logger) {
             return Promise.reject('Logger not set on the request object');
         }
@@ -159,6 +161,8 @@ class Request {
                     resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
                 else {
+                    const end = process.hrtime.bigint();
+                    timings.api.push(Number(end - start));
                     _resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
             }, (error) => {
@@ -181,6 +185,8 @@ class Request {
                         reject(error);
                     }
                     else {
+                        const end = process.hrtime.bigint();
+                        timings.api.push(Number(end - start));
                         _reject(error);
                     }
                 }

package/dist/settingsNames.js

@@ -1,4 +1,5 @@
 const settingsNames = {
+    authType: 'authType',
     autoOpenLinksInBrowser: 'autoOpenLinksInBrowser',
     copyDeviceCodeToClipboard: 'copyDeviceCodeToClipboard',
     csvEscape: 'csvEscape',

package/dist/utils/aadAdministrativeUnit.js

@@ -0,0 +1,25 @@
+import { odata } from "./odata.js";
+import { formatting } from "./formatting.js";
+import { Cli } from "../cli/Cli.js";
+const graphResource = 'https://graph.microsoft.com';
+export const aadAdministrativeUnit = {
+    /**
+     * Get an administrative unit by its display name.
+     * @param displayName Administrative unit display name.
+     * @returns The administrative unit.
+     * @throws Error when administrative unit was not found.
+     */
+    async getAdministrativeUnitByDisplayName(displayName) {
+        const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
+        if (administrativeUnits.length === 0) {
+            throw `The specified administrative unit '${displayName}' does not exist.`;
+        }
+        if (administrativeUnits.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', administrativeUnits);
+            const selectedAdministrativeUnit = await Cli.handleMultipleResultsFound(`Multiple administrative units with name '${displayName}' found.`, resultAsKeyValuePair);
+            return selectedAdministrativeUnit;
+        }
+        return administrativeUnits[0];
+    }
+};
+//# sourceMappingURL=aadAdministrativeUnit.js.map

package/dist/utils/prompt.js

@@ -1,16 +1,35 @@
-import { Cli } from '../cli/Cli.js';
 import { settingsNames } from '../settingsNames.js';
-let inquirer;
+import { Cli } from '../cli/Cli.js';
+let inquirerInput;
+let inquirerConfirm;
+let inquirerSelect;
 export const prompt = {
     /* c8 ignore next 10 */
-    async forInput(config, answers) {
-        if (!inquirer) {
-            inquirer = await import('inquirer');
+    async forInput(config) {
+        if (!inquirerInput) {
+            inquirerInput = await import('@inquirer/input');
+        }
+        const cli = Cli.getInstance();
+        const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
+        return inquirerInput.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+    },
+    /* c8 ignore next 10 */
+    async forConfirmation(config) {
+        if (!inquirerConfirm) {
+            inquirerConfirm = await import('@inquirer/confirm');
+        }
+        const cli = Cli.getInstance();
+        const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
+        return inquirerConfirm.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+    },
+    /* c8 ignore next 10 */
+    async forSelection(config) {
+        if (!inquirerSelect) {
+            inquirerSelect = await import('@inquirer/select');
         }
         const cli = Cli.getInstance();
         const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
-        const prompt = inquirer.createPromptModule({ output: errorOutput === 'stderr' ? process.stderr : process.stdout });
-        return await prompt(config, answers);
+        return inquirerSelect.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
     }
 };
 //# sourceMappingURL=prompt.js.map

package/dist/utils/spo.js

@@ -1203,6 +1203,115 @@ export const spo = {
         };
         const webProperties = await request.get(requestOptions);
         return webProperties;
+    },
+    /**
+     * Applies the retention label to the items in the given list.
+     * @param webUrl The url of the web
+     * @param name The name of the label
+     * @param listAbsoluteUrl The absolute Url to the list
+     * @param itemIds The list item Ids to apply the label to. (A maximum 100 is allowed)
+     * @param logger The logger object
+     * @param verbose Set for verbose logging
+     */
+    async applyRetentionLabelToListItems(webUrl, name, listAbsoluteUrl, itemIds, logger, verbose) {
+        if (verbose && logger) {
+            logger.logToStderr(`Applying retention label '${name}' to item(s) in list '${listAbsoluteUrl}'...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/SP_CompliancePolicy_SPPolicyStoreProxy_SetComplianceTagOnBulkItems`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            data: {
+                listUrl: listAbsoluteUrl,
+                complianceTagValue: name,
+                itemIds: itemIds
+            },
+            responseType: 'json'
+        };
+        await request.post(requestOptions);
+    },
+    /**
+     * Removes the retention label from the items in the given list.
+     * @param webUrl The url of the web
+     * @param listAbsoluteUrl The absolute Url to the list
+     * @param itemIds The list item Ids to clear the label from (A maximum 100 is allowed)
+     * @param logger The logger object
+     * @param verbose Set for verbose logging
+     */
+    async removeRetentionLabelFromListItems(webUrl, listAbsoluteUrl, itemIds, logger, verbose) {
+        if (verbose && logger) {
+            logger.logToStderr(`Removing retention label from item(s) in list '${listAbsoluteUrl}'...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/SP_CompliancePolicy_SPPolicyStoreProxy_SetComplianceTagOnBulkItems`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            data: {
+                listUrl: listAbsoluteUrl,
+                complianceTagValue: '',
+                itemIds: itemIds
+            },
+            responseType: 'json'
+        };
+        await request.post(requestOptions);
+    },
+    /**
+     * Applies a default retention label to a list or library.
+     * @param webUrl The url of the web
+     * @param name The name of the label
+     * @param listAbsoluteUrl The absolute Url to the list
+     * @param syncToItems If the label needs to be synced to existing items/files.
+     * @param logger The logger object
+     * @param verbose Set for verbose logging
+     */
+    async applyDefaultRetentionLabelToList(webUrl, name, listAbsoluteUrl, syncToItems, logger, verbose) {
+        if (verbose && logger) {
+            logger.logToStderr(`Applying default retention label '${name}' to the list '${listAbsoluteUrl}'...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/SP_CompliancePolicy_SPPolicyStoreProxy_SetListComplianceTag`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            data: {
+                listUrl: listAbsoluteUrl,
+                complianceTagValue: name,
+                blockDelete: false,
+                blockEdit: false,
+                syncToItems: syncToItems || false
+            },
+            responseType: 'json'
+        };
+        await request.post(requestOptions);
+    },
+    /**
+     * Removes the default retention label from a list or library.
+     * @param webUrl The url of the web
+     * @param listAbsoluteUrl The absolute Url to the list
+     * @param logger The logger object
+     * @param verbose Set for verbose logging
+     */
+    async removeDefaultRetentionLabelFromList(webUrl, listAbsoluteUrl, logger, verbose) {
+        if (verbose && logger) {
+            logger.logToStderr(`Removing the default retention label from the list '${listAbsoluteUrl}'...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/SP_CompliancePolicy_SPPolicyStoreProxy_SetListComplianceTag`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            data: {
+                listUrl: listAbsoluteUrl,
+                complianceTagValue: '',
+                blockDelete: false,
+                blockEdit: false,
+                syncToItems: false
+            },
+            responseType: 'json'
+        };
+        await request.post(requestOptions);
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/_clisettings.mdx

@@ -1,5 +1,6 @@
 Setting name|Definition|Default value
 ------------|----------|-------------
+`authType`|Default login method to use when running `m365 login` without the `--authType` option.|`deviceCode`
 `autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
 `copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
 `csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`

package/docs/docs/cmd/aad/approleassignment/approleassignment-add.mdx

@@ -124,4 +124,4 @@ m365 aad approleassignment add --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e4
 
 ## More information
 
-- Microsoft Graph permissions reference: [https://docs.microsoft.com/en-us/graph/permissions-reference](https://docs.microsoft.com/en-us/graph/permissions-reference)
+- Microsoft Graph permissions reference: [https://learn.microsoft.com/graph/permissions-reference](https://learn.microsoft.com/graph/permissions-reference)

package/docs/docs/cmd/aad/approleassignment/approleassignment-list.mdx

@@ -53,7 +53,7 @@ m365 aad approleassignment list --appObjectId b2307a39-e878-458b-bc90-03bc578531
 
 ## 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://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
 
 ## Response
 
@@ -110,4 +110,4 @@ m365 aad approleassignment list --appObjectId b2307a39-e878-458b-bc90-03bc578531
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.mdx

@@ -70,4 +70,4 @@ The command won't return a response on success.
 
 ## More information
 
-- Microsoft Graph permissions reference: [https://docs.microsoft.com/en-us/graph/permissions-reference](https://docs.microsoft.com/en-us/graph/permissions-reference)
+- Microsoft Graph permissions reference: [https://learn.microsoft.com/graph/permissions-reference](https://learn.microsoft.com/graph/permissions-reference)

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-add.mdx

@@ -55,4 +55,4 @@ The command won't return a response on success.
 
 ## 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://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-list.mdx

@@ -94,5 +94,5 @@ m365 aad oauth2grant list --spObjectId 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)
-- List oauth2PermissionGrants: [https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-list?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-list?view=graph-rest-1.0)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- List oauth2PermissionGrants: [https://learn.microsoft.com/graph/api/oauth2permissiongrant-list?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/oauth2permissiongrant-list?view=graph-rest-1.0)

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

@@ -52,5 +52,5 @@ The command won't return a response on success.
 
 ## 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)
-- 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)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Delete a delegated permission grant (oAuth2PermissionGrant): [https://learn.microsoft.com/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0)

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

@@ -46,5 +46,5 @@ The command won't return a response on success.
 
 ## 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)
-- 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)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Update a delegated permission grant (oAuth2PermissionGrant): [https://learn.microsoft.com/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0)

package/docs/docs/cmd/aad/policy/policy-list.mdx

@@ -112,4 +112,4 @@ m365 aad policy list --type "claimsMapping"
 
 ## More information
 
-- Microsoft Graph Azure AD policy overview: [https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0)
+- Microsoft Graph Azure AD policy overview: [https://learn.microsoft.com/graph/api/resources/policy-overview?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/resources/policy-overview?view=graph-rest-1.0)

package/docs/docs/cmd/aad/siteclassification/siteclassification-disable.mdx

@@ -39,4 +39,4 @@ The command won't return a response on success.
 
 ## More information
 
-- SharePoint "modern" sites classification: [https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification)
+- SharePoint "modern" sites classification: [https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification)

package/docs/docs/cmd/aad/siteclassification/siteclassification-enable.mdx

@@ -54,4 +54,4 @@ The command won't return a response on success.
 
 ## More information
 
-- SharePoint "modern" sites classification: [https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification)
+- SharePoint "modern" sites classification: [https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification)

package/docs/docs/cmd/aad/siteclassification/siteclassification-get.mdx

@@ -81,4 +81,4 @@ m365 aad siteclassification get
 
 ## More information
 
-- SharePoint "modern" sites classification: [https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification)
+- SharePoint "modern" sites classification: [https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification)

package/docs/docs/cmd/aad/siteclassification/siteclassification-set.mdx

@@ -61,4 +61,4 @@ The command won't return a response on success.
 
 ## More information
 
-- SharePoint "modern" sites classification: [https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/modern-experience-site-classification)
+- SharePoint "modern" sites classification: [https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification](https://learn.microsoft.com/sharepoint/dev/solution-guidance/modern-experience-site-classification)

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

@@ -189,5 +189,5 @@ 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)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Create servicePrincipal: [https://learn.microsoft.com/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0)

package/docs/docs/cmd/aad/sp/sp-get.mdx

@@ -217,5 +217,5 @@ m365 aad sp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
 
 ## 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)
-- Get servicePrincipal: [https://docs.microsoft.com/en-us/graph/api/serviceprincipal-get?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/serviceprincipal-get?view=graph-rest-1.0)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
+- Get servicePrincipal: [https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0)

package/docs/docs/cmd/aad/user/user-add.mdx

@@ -43,7 +43,7 @@ m365 aad user add [options]
 : Whether the user should change his/her password on the next login and setup MFA.
 
 `--usageLocation [usageLocation]`
-: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+: A two letter [country code](https://learn.microsoft.com/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
 
 `--officeLocation [officeLocation]` 
 : The office location in the user's place of business.
@@ -58,7 +58,7 @@ m365 aad user add [options]
 : The name for the department in which the user works. Maximum length is 64 characters.
 
 `--preferredLanguage [preferredLanguage]`
-: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
 
 `--managerUserId [managerUserId]`
 : User ID of the user's manager. Specify `managerUserId` or `managerUserName` but not both.
@@ -83,7 +83,7 @@ After running this command, it may take a minute before the user is effectively
 
 :::
 
-This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties).
+This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/graph/api/resources/user?view=graph-rest-1.0#properties).
 
 If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
 

package/docs/docs/cmd/aad/user/user-guest-add.mdx

@@ -31,7 +31,7 @@ m365 aad user guest add [options]
 : Additional recipients the invitation message should be sent to. Currently only 1 additional recipient is supported.
 
 `--messageLanguage [messageLanguage]`
-: The language you want to send the default message in. The language format should be in [ISO 639](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/ed06cf15-306c-43be-9053-ca81ca51e656). The default is `en-US`.
+: The language you want to send the default message in. The language format should be in [ISO 639](https://learn.microsoft.com/openspecs/office_standards/ms-oi29500/ed06cf15-306c-43be-9053-ca81ca51e656). The default is `en-US`.
 
 `--sendInvitationMessage`
 : Indicates whether an email should be sent to the user.

package/docs/docs/cmd/aad/user/user-set.mdx

@@ -47,7 +47,7 @@ m365 aad user set [options]
 : The user's surname (family name or last name). Maximum length is 64 characters.
 
 `--usageLocation [usageLocation]`
-: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+: A two letter [country code](https://learn.microsoft.com/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
 
 `--officeLocation [officeLocation]` 
 : The office location in the user's place of business.
@@ -62,7 +62,7 @@ m365 aad user set [options]
 : The name for the department in which the user works. Maximum length is 64 characters.
 
 `--preferredLanguage [preferredLanguage]`
-: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
 
 `--managerUserId [managerUserId]`
 : User ID of the user's manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
@@ -78,7 +78,7 @@ m365 aad user set [options]
 
 ## Remarks
 
-This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties).
+This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/graph/api/resources/user?view=graph-rest-1.0#properties).
 
 If the user with the specified ID or username doesn't exist, or if the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
 

package/docs/docs/cmd/{search/externalconnection/externalconnection-add.mdx → external/connection/connection-add.mdx}

@@ -1,26 +1,32 @@
 import Global from '/docs/cmd/_global.mdx';
 
-# search externalconnection add
+# external connection add
 
-Add a new external connection to be defined for Microsoft Search
+Add a new external connection
 
 ## Usage
 
 ```sh
-m365 search externalconnection add [options]
+m365 external connection add [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection add
 ```
 
 ## Options
 
 ```md definition-list
 `-i, --id <id>`
-: Developer-provided unique ID of the connection within the Azure Active Directory tenant
+: 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
+: 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
+: 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.
@@ -34,16 +40,16 @@ The `id` must be at least 3 and no more than 32 characters long. It can contain
 
 ## Examples
 
-Adds a new external connection with name and description of test app
+Adds a new external connection with name and description of test app.
 
 ```sh
-m365 search externalconnection add --id MyApp --name "Test" --description "Test"
+m365 external connection add --id MyApp --name "Test" --description "Test"
 ```
 
-Adds a new external connection with a limited number of authorized apps
+Adds a new external connection with a limited number of authorized apps.
 
 ```sh
-m365 search externalconnection add --id MyApp --name "Test" --description "Test" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
+m365 external connection add --id MyApp --name "Test" --description "Test" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
 ```
 
 ## Response

package/docs/docs/cmd/{search/externalconnection/externalconnection-get.mdx → external/connection/connection-get.mdx}

@@ -2,40 +2,46 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# search externalconnection get
+# external connection get
 
-Allow the administrator to get a specific external connection for use in Microsoft Search.
+Allow the administrator to get a specific external connection
 
 ## Usage
 
 ```sh
-m365 search externalconnection get [options]
+m365 external connection get [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection get
 ```
 
 ## Options
 
 ```md definition-list
 `-i, --id [id]`
-: ID of the External Connection to get. Specify either `id` or `name`
+: ID of the External Connection to get. Specify either `id` or `name`.
 
 `-n, --name [name]`
-: Name of the External Connection to get. Specify either `id` or `name`
+: Name of the External Connection to get. Specify either `id` or `name`.
 ```
 
 <Global />
 
 ## Examples
 
-Get the External Connection by its id
+Get the External Connection by its id.
 
 ```sh
-m365 search externalconnection get --id "MyApp"
+m365 external connection get --id "MyApp"
 ```
 
-Get the External Connection by its name
+Get the External Connection by its name.
 
 ```sh
-m365 search externalconnection get --name "Test"
+m365 external connection get --name "Test"
 ```
 
 ## Response
@@ -83,7 +89,7 @@ m365 search externalconnection get --name "Test"
   <TabItem value="Markdown">
 
   ```md
-  # search externalconnection get --id "CLITest"
+  # external connection get --id "CLITest"
 
   Date: 2022-11-05
 
@@ -99,4 +105,3 @@ m365 search externalconnection get --name "Test"
 
   </TabItem>
 </Tabs>
-