@pnp/cli-microsoft365 7.2.0-beta.f440e15 → 7.3.0-beta.01256d2

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,39 @@
-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');
-        const prompt = inquirer.createPromptModule({ output: errorOutput === 'stderr' ? process.stderr : process.stdout });
-        return await prompt(config, answers);
+        return inquirerConfirm.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+    },
+    /* c8 ignore next 15 */
+    async forSelection(config) {
+        if (!inquirerSelect) {
+            inquirerSelect = await import('@inquirer/select');
+        }
+        const cli = Cli.getInstance();
+        const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
+        const promptPageSizeCap = cli.getSettingWithDefaultValue(settingsNames.promptListPageSize, 7);
+        if (!config.pageSize) {
+            config.pageSize = Math.min(config.choices.length, promptPageSizeCap);
+        }
+        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/dist/utils/validation.js

@@ -7,8 +7,11 @@ export const validation = {
             return false;
         }
         const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        // verify if the guid is a valid guid. @meid will be replaced in a later stage with the actual user id of the logged in user
-        return guidRegEx.test(guid) || guid.toLowerCase().trim() === '@meid';
+        // verify if the guid is a valid guid. @meid will be replaced in a later
+        // stage with the actual user id of the logged in user
+        // we also need to make it toString in case the args is resolved as number
+        // or boolean
+        return guidRegEx.test(guid) || guid.toString().toLowerCase().trim() === '@meid';
     },
     isValidTeamsChannelId(guid) {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);

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|`"`
@@ -13,5 +14,6 @@ Setting name|Definition|Default value
 `output`|Defines the default output when issuing a command. Allowed values are `json`, `text`, `csv`, `md`, `none`|`json`
 `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
 `prompt`|Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved.|`true`
+`promptListPageSize`|By default, lists of choices longer than 7 will be paginated. Use this option to control how many choices will appear on the screen at once.|7
 `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
 `showSpinner`|Display spinner when executing commands|`true`

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

@@ -21,7 +21,7 @@ m365 aad administrativeunit add [options]
 `-d, --description [description]`
 : Description for the administrative unit.
 
-`--hiddenMembership [hiddenMembership]`
+`--hiddenMembership`
 : Indicates whether the administrative unit and its members are hidden.
 ```
 
@@ -112,4 +112,8 @@ m365 aad administrativeunit add --displayName 'Marketing Division' --hiddenMembe
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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

@@ -95,4 +95,8 @@ m365 aad administrativeunit get --displayName 'Marketing Division'
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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

@@ -80,4 +80,8 @@ m365 aad administrativeunit list
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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

@@ -19,7 +19,7 @@ m365 aad administrativeunit remove [options]
 `-n, --displayName [displayName]`
 : The display name of the administrative unit. Specify either `id` or `displayName` but not both.
 
-`-f, --force [force]`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 
@@ -49,4 +49,8 @@ m365 aad administrativeunit remove --displayName 'Marketing Division'
 
 ## Response
 
-The command won't return a response on success
+The command won't return a response on success
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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/group/group-list.mdx

@@ -14,6 +14,11 @@ m365 aad group list [options]
 
 ## Options
 
+```md definition-list
+`--type [type]`
+: Filter the results to only groups of a given type. Allowed values: `microsoft365`, `security`, `distribution`, `mailEnabledSecurity`. By default, all groups are listed.
+```
+
 <Global />
 
 ## Examples
@@ -24,6 +29,12 @@ Lists all groups defined in Azure Active Directory.
 m365 aad group list
 ```
 
+List all security groups defined in Azure Active Directory.
+
+```sh
+m365 aad group list --type security
+```
+
 ## Response
 
 <Tabs>

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