@pnp/cli-microsoft365 11.9.0-beta.606e85e → 11.9.0-beta.69c1186

package/dist/m365/viva/commands/engage/engage-community-user-add.js

@@ -35,16 +35,32 @@ class VivaEngageCommunityUserAddCommand extends GraphCommand {
     getRefinedSchema(schema) {
         return schema
             .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
-            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         })
             .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
-            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         })
             .refine(options => options.ids || options.userNames, {
-            error: 'Specify either of ids or userNames.'
+            error: 'Specify either of ids or userNames.',
+            params: {
+                customCode: 'optionSet',
+                options: ['ids', 'userNames']
+            }
         })
             .refine(options => typeof options.userNames !== 'undefined' || typeof options.ids !== 'undefined', {
-            error: 'Specify either ids or userNames, but not both.'
+            error: 'Specify either ids or userNames, but not both.',
+            params: {
+                customCode: 'optionSet',
+                options: ['ids', 'userNames']
+            }
         });
     }
     async commandAction(logger, args) {

package/dist/m365/viva/commands/engage/engage-community-user-list.js

@@ -24,10 +24,18 @@ class VivaEngageCommunityUserListCommand extends GraphCommand {
     getRefinedSchema(schema) {
         return schema
             .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
-            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         })
             .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
-            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         });
     }
     defaultProperties() {

package/dist/m365/viva/commands/engage/engage-community-user-remove.js

@@ -32,16 +32,25 @@ class VivaEngageCommunityUserRemoveCommand extends GraphCommand {
     getRefinedSchema(schema) {
         return schema
             .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
-            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+            error: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         })
             .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
-            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
-        })
-            .refine(options => options.id || options.userName, {
-            error: 'Specify either of id or userName.'
+            error: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.',
+            params: {
+                customCode: 'optionSet',
+                options: ['communityId', 'communityDisplayName', 'entraGroupId']
+            }
         })
-            .refine(options => typeof options.userName !== 'undefined' || typeof options.id !== 'undefined', {
-            error: 'Specify either id or userName, but not both.'
+            .refine(options => [options.id, options.userName].filter(o => o !== undefined).length === 1, {
+            error: 'Specify either id or userName, but not both.',
+            params: {
+                customCode: 'optionSet',
+                options: ['id', 'userName']
+            }
         });
     }
     async commandAction(logger, args) {

package/dist/m365/viva/commands/engage/engage-role-member-list.js

@@ -22,7 +22,11 @@ class VivaEngageRoleMemberListCommand extends GraphCommand {
     getRefinedSchema(schema) {
         return schema
             .refine(options => [options.roleId, options.roleName].filter(x => x !== undefined).length === 1, {
-            error: 'Specify either roleId, or roleName, but not both.'
+            error: 'Specify either roleId, or roleName, but not both.',
+            params: {
+                customCode: 'optionSet',
+                options: ['roleId', 'roleName']
+            }
         });
     }
     defaultProperties() {

package/dist/utils/prompt.js

@@ -13,13 +13,7 @@ export const prompt = {
         }
         const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
         return inquirerInput
-            .default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout })
-            .catch(error => {
-            if (error instanceof Error && error.name === 'ExitPromptError') {
-                return ''; // noop; handle Ctrl + C
-            }
-            throw error;
-        });
+            .default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
     },
     /* c8 ignore next 9 */
     async forConfirmation(config) {

package/docs/docs/cmd/outlook/calendar/calendar-get.mdx

@@ -41,16 +41,16 @@ m365 outlook calendar get [options]
 <Tabs>
   <TabItem value="Delegated">
 
-  | Resource        | Permissions        |
-  |-----------------|--------------------|
-  | Microsoft Graph | Calendar.ReadBasic |
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Calendars.Read |
 
   </TabItem>
   <TabItem value="Application">
 
-  | Resource        | Permissions        |
-  |-----------------|--------------------|
-  | Microsoft Graph | Calendar.ReadBasic |
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Calendars.Read |
 
   </TabItem>
 </Tabs>
@@ -162,4 +162,4 @@ m365 outlook calendar get --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calend
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/spe/container/container-get.mdx

@@ -15,8 +15,11 @@ m365 spe container get [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The Id of the container instance.
+`-i, --id [id]`
+: The Id of the container instance. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: Display name of the container. Specify either `id` or `name` but not both.
 ```
 
 <Global />
@@ -42,12 +45,18 @@ m365 spe container get [options]
 
 ## Examples
 
-Gets a container of a specific type.
+Gets a container of a specific type by id.
 
 ```sh
 m365 spe container get --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
 ```
 
+Gets a container of a specific type by display name.
+
+```sh
+m365 spe container get --name "My Application Storage Container"
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spe/container/container-set.mdx

@@ -0,0 +1,160 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container set
+
+Updates a SharePoint Embedded container
+
+## Usage
+
+```sh
+m365 spe container set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: The Id of the container.
+
+`--newName [newName]`
+: New display name for the container.
+
+`--description [description]`
+: Description of the container.
+
+`--isOcrEnabled [isOcrEnabled]`
+: Indicates whether OCR is enabled for the container. Possible values: `true`, `false`.
+
+`--isItemVersioningEnabled [isItemVersioningEnabled]`
+: Indicates whether item versioning is enabled. Possible values: `true`, `false`.
+
+`--itemMajorVersionLimit [itemMajorVersionLimit]`
+: Maximum number of major versions to keep. Requires versioning to be enabled.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
+## Remarks
+
+In addition to Graph permissions, the app/user must have container-type level permission for the respective container type. The caller must have write access to the container (for example, writer, manager, or owner role) to update metadata/settings.
+
+## Examples
+
+Update the container display name by Id.
+
+```sh
+m365 spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --newName "Contoso Project A"
+```
+
+Update description only.
+
+```sh
+m365 spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --description "Files for the Contoso Project A team"
+```
+
+Disable OCR for a container.
+
+```sh
+m365 spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --isOcrEnabled false
+```
+
+Enable versioning and set the major version limit.
+
+```sh
+m365 spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --isItemVersioningEnabled true --itemMajorVersionLimit 100
+```
+
+Update name, description, and settings together.
+
+```sh
+m365 spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --newName "Contoso Project A - Phase 2" --description "Phase 2 workspace" --isOcrEnabled true --isItemVersioningEnabled true --itemMajorVersionLimit 50
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
+    "displayName": "Contoso Project A",
+    "description": "Files for the Contoso Project A team",
+    "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
+    "status": "active",
+    "createdDateTime": "2021-11-24T15:41:52.347Z",
+    "lockState": "unlocked",
+    "settings": {
+      "isOcrEnabled": false,
+      "itemMajorVersionLimit": 50,
+      "isItemVersioningEnabled": true
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  containerTypeId: 91710488-5756-407f-9046-fbe5f0b4de73
+  createdDateTime: 2021-11-24T15:41:52.347Z
+  description    : Files for the Contoso Project A team
+  displayName    : Contoso Project A
+  id             : b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z
+  lockState      : unlocked
+  settings       : {"isOcrEnabled":false,"itemMajorVersionLimit":50,"isItemVersioningEnabled":true}
+  status         : active
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,containerTypeId,status,createdDateTime,lockState
+  b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z,Contoso Project A,Files for the Contoso Project A team,91710488-5756-407f-9046-fbe5f0b4de73,active,2021-11-24T15:41:52.347Z,unlocked
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe container set --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --newName "Contoso Project A"
+
+  Date: 07/04/2026
+
+  ## Contoso Project A (b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z)
+
+  Property | Value
+  ---------|-------
+  id | b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z
+  displayName | Contoso Project A
+  description | Files for the Contoso Project A team
+  containerTypeId | 91710488-5756-407f-9046-fbe5f0b4de73
+  status | active
+  createdDateTime | 2021-11-24T15:41:52.347Z
+  lockState | unlocked
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/app/app-instance-list.mdx

@@ -21,6 +21,25 @@ m365 spo app instance list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Return a list of installed apps on the specified site.

package/docs/docs/cmd/spo/app/app-teamspackage-download.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo app teamspackage download
 
@@ -39,6 +41,25 @@ If you try to download Teams app package for an SPFx solution that doesn't suppo
 
 For maximum performance, specify the URL of the tenant app catalog, the item ID (`appItemId`) of the SPFx package for which you want to download the Teams app package and the name of the file where you want to save the downloaded package to (`fileName`).
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Downloads the Teams app package for the SPFx solution deployed to the tenant app catalog with the specified ID to a file with .zip extension named after the .sppkg file.

package/docs/docs/cmd/spo/apppage/apppage-add.mdx

@@ -34,6 +34,25 @@ m365 spo apppage add [options]
 
 If you want to add the single-part app page to quick launch, use the addToQuickLaunch flag.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a single-part app page in the specified site, webpart data is stored in the `$webPartData` variable
@@ -42,7 +61,6 @@ Create a single-part app page in the specified site, webpart data is stored in t
 m365 spo apppage add --title "Contoso" --webUrl "https://contoso.sharepoint.com" --webPartData $webPartData --addToQuickLaunch
 ```
 
-
 ## Response
 
 <Tabs>

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo apppage set
 
@@ -25,6 +27,25 @@ m365 spo apppage set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Updates the single-part app page located in a specified site. Web part data is stored in the `$webPartData` variable.

package/docs/docs/cmd/spo/page/page-control-set.mdx

@@ -23,10 +23,13 @@ m365 spo page control set [options]
 : URL of the site where the page is located.
 
 `--webPartData [webPartData]`
-: JSON string with web part data as retrieved from the web part maintenance mode. Specify either `webPartProperties` or `webPartData` but not both.
+: JSON string with web part data as retrieved from the web part maintenance mode. Specify either `innerHtml`, `webPartProperties` or `webPartData` but not more than one.
 
 `--webPartProperties [webPartProperties]`
-: JSON string with web part data as retrieved from the web part maintenance mode. Specify either `webPartProperties` or `webPartData` but not both.
+: JSON string with web part data as retrieved from the web part maintenance mode. Specify either `innerHtml`, `webPartProperties` or `webPartData` but not more than one.
+
+`--innerHtml [innerHtml]`
+: Inner HTML to set on the control. Specify either `innerHtml`, `webPartProperties` or `webPartData` but not more than one.
 ```
 
 <Global />
@@ -37,7 +40,13 @@ If the specified `pageName` doesn't refer to an existing modern page, you will g
 
 :::warning[Escaping JSON in PowerShell]
 
-When using the `--webPartProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+When using the `webPartProperties` or `webPartData` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+:::note
+
+When using `webPartProperties` or `webPartData`, only the properties you specify will be updated. Any properties not included in the JSON string will remain unchanged.
 
 :::
 
@@ -55,6 +64,12 @@ Update web part properties for the control, placed on a modern page
 m365 spo page control set --id 3ede60d3-dc2c-438b-b5bf-cc40bb2351e1 --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --webPartProperties '{"description": "New description"}'
 ```
 
+Update the text of a text web part
+
+```sh
+m365 spo page control set --id 3ede60d3-dc2c-438b-b5bf-cc40bb2351e1 --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --innerHtml '<p>This text was updated by <a href="https://aka.ms/cli-m365">CLI for Microsoft 365</a></p>'
+```
+
 ## Response
 
 The command won't return a response on success.