@pnp/cli-microsoft365 7.2.0-beta.a021bb1 → 7.2.0-beta.c7e1c03

package/dist/m365/tenant/commands/people/people-profilecardproperty-remove.js

@@ -47,13 +47,8 @@ class TenantPeopleProfileCardPropertyRemoveCommand extends GraphCommand {
             await removeProfileCardProperty();
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the profile card property '${directoryPropertyName}'?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the profile card property '${directoryPropertyName}'?` });
+            if (result) {
                 await removeProfileCardProperty();
             }
         }

package/dist/m365/todo/commands/list/list-remove.js

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

package/dist/m365/todo/commands/task/task-remove.js

@@ -27,13 +27,8 @@ class TodoTaskRemoveCommand extends GraphCommand {
             await this.removeToDoTask(args.options);
         }
         else {
-            const result = await Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the task ${args.options.id} from list ${args.options.listId || args.options.listName}?`
-            });
-            if (result.continue) {
+            const result = await Cli.promptForConfirmation({ message: `Are you sure you want to remove the task ${args.options.id} from list ${args.options.listId || args.options.listName}?` });
+            if (result) {
                 await this.removeToDoTask(args.options);
             }
         }

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/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/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>
-

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

@@ -2,14 +2,20 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# search externalconnection list
+# external connection list
 
-Lists external connections defined in Microsoft Search
+Lists external connections
 
 ## Usage
 
 ```sh
-m365 search externalconnection list [options]
+m365 external connection list [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection list
 ```
 
 ## Options
@@ -18,10 +24,10 @@ m365 search externalconnection list [options]
 
 ## Examples
 
-List external connections defined in Microsoft Search
+List external connections.
 
 ```sh
-m365 search externalconnection list
+m365 external connection list
 ```
 
 ## Response
@@ -69,7 +75,7 @@ m365 search externalconnection list
   <TabItem value="Markdown">
 
   ```md
-  # search externalconnection list
+  # external connection list
 
   Date: 2022-09-05
 
@@ -85,4 +91,3 @@ m365 search externalconnection list
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/external/connection/connection-remove.mdx

@@ -0,0 +1,54 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# external connection remove
+
+Allow the administrator to remove a specific external connection
+
+## Usage
+
+```sh
+m365 external connection remove [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection remove
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the External Connection to remove. Specify either `id` or `name`.
+
+`-n, --name [name]`
+: Name of the External Connection to remove. Specify either `id` or `name`.
+
+`-f, --force`
+: Don't prompt for confirming removing the connection.
+```
+
+<Global />
+
+## Remarks
+
+If the command finds multiple external connections with the specified name, it will prompt you to disambiguate which external connection it should remove, listing the discovered IDs.
+
+## Examples
+
+Removes external connection by its id.
+
+```sh
+m365 external connection remove --id "MyApp"
+```
+
+Removes external connection by its name. Will NOT prompt for confirmation before removing.
+
+```sh
+m365 external connection remove --name "Test" --force
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/external/connection/connection-schema-add.mdx

@@ -0,0 +1,41 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# external connection schema add
+
+Allow the administrator to add a schema to a specific external connection
+
+## Usage
+
+```sh
+m365 external connection schema add [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection schema add
+```
+
+## Options
+
+```md definition-list
+`-i, --externalConnectionId  <externalConnectionId>`
+: ID of the External Connection.
+
+`-s, --schema [schema]`
+: The schema object to be added.
+```
+
+<Global />
+
+## Examples
+
+Adds a new schema to a specific external connection.
+
+```sh
+m365 external connection 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.

package/docs/docs/cmd/spo/file/file-rename.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file rename
 

package/docs/docs/cmd/spo/site/site-set.mdx

@@ -49,6 +49,9 @@ m365 spo site set [options]
 `--siteLogoUrl [siteLogoUrl]`
 : Set the logo for the site collection. This can be an absolute or relative URL to a file on the current site collection.
 
+`--siteThumbnailUrl [siteThumbnailUrl]`
+: Set the thumbnail for the site collection. This can be an absolute or relative URL to a file on the current site collection.
+
 `--resourceQuota [resourceQuota]`
 : The quota for this site collection in Sandboxed Solutions units
 
@@ -184,6 +187,18 @@ Unset the logo on the site
 m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl ""
 ```
 
+Set the thumbnail on the site
+
+```sh
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteThumbnailUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
+```
+
+Unset the thumbnail on the site
+
+```sh
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteThumbnailUrl ""
+```
+
 Lock the site preventing users from accessing it. Wait for the configuration to complete
 
 ```sh

package/docs/docs/cmd/teams/user/user-app-remove.mdx

@@ -16,8 +16,11 @@ m365 teams user app remove [options]
 `--id <id>`
 : The unique id of the app instance installed for the user.
 
-`--userId <userId>`
-: The ID of the user to uninstall the app for.
+`--userId [userId]`
+: The ID of the user to uninstall the app for. Specify `userId` or `userName` but not both.
+
+`--userName [userName]`
+: The UPN of the user to uninstall the app for. Specify `userId` or `userName` but not both.
 
 `-f, --force`
 : Confirm removal of app for user.
@@ -38,6 +41,12 @@ Uninstall an app for the specified user.
 m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```
 
+Uninstall an app for the specified user using its UPN.
+
+```sh
+m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userName admin@contoso.com
+```
+
 ## Response
 
 The command won't return a response on success.