@pnp/cli-microsoft365 11.7.0-beta.bd906c5 → 11.7.0

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # external connection schema add
 
@@ -31,6 +33,25 @@ m365 search externalconnection schema add
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds a new schema to a specific external connection.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # external connection urltoitemresolver add
 
@@ -30,6 +32,25 @@ m365 external connection urltoitemresolver add [options]
 ```
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds a URL to item resolver to an existing connection

package/docs/docs/cmd/external/item/item-add.mdx

@@ -58,6 +58,25 @@ You can use the following types:
 
 For more information about using these options, see the Microsoft Graph API documentation and documentation about Microsoft Graph connectors.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ExternalItem.ReadWrite.OwnedBy |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ExternalItem.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Creates an external item with simple properties that everyone is allowed to access

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

@@ -0,0 +1,178 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar set
+
+Updates a calendar for a user.
+
+## Usage
+
+```sh
+m365 outlook calendar set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the calendar.
+
+`-n, --name [name]`
+: New name of the calendar.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--calendarGroupId [calendarGroupId]`
+: ID of the calendar group where the calendar belongs. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the calendar group where the calendar belongs. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--color [color]`
+: The color of the calendar in the UI. Allowed values: `auto`, `lightBlue`, `lightGreen`, `lightOrange`, `lightGray`, `lightYellow`, `lightTeal`, `lightPink`, `lightBrown`, `lightRed`, `maxColor`.
+
+`--isDefault [isDefault]`
+: Mark whether the calendar is the user's default calendar. Allowed values: `true`, `false`.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                     |
+  |-----------------|-------------------------------------------------|
+  | Microsoft Graph | Calendars.ReadWrite, Calendars.ReadWrite.Shared |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+:::note
+
+When using delegated permissions, specifying `userId` or `userName` for a different user requires the `Calendars.ReadWrite.Shared` scope. When the specified user matches the signed-in user, no shared scope is needed.
+
+:::
+
+## Examples
+
+Update the name of a calendar for the signed-in user.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --name 'Team planning'
+```
+
+Change the color of a specific calendar for a user by UPN.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --userName 'john.doe@contoso.com' --color 'lightGreen'
+```
+
+Mark a calendar as the default calendar for a user.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --userId 'b743445a-112c-4fda-9afd-05943f9c7b36' --isDefault true
+```
+
+Update a calendar within a specific calendar group by name.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --name 'Team planning' --calendarGroupName 'My Calendars'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AAMkAGI2TQpZAAA=",
+    "name": "Team planning",
+    "color": "auto",
+    "hexColor": "",
+    "isDefaultCalendar": false,
+    "changeKey": "DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": true,
+    "isRemovable": false,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : DxYSthXJXEWwAQSYQnXvIgAAIxGttg==
+  color                        : auto
+  defaultOnlineMeetingProvider : teamsForBusiness
+  hexColor                     :
+  id                           : AAMkAGI2TQpZAAA=
+  isDefaultCalendar            : false
+  isRemovable                  : false
+  isTallyingResponses          : true
+  name                         : Team planning
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AAMkAGI2TQpZAAA=,Team planning,auto,,false,DxYSthXJXEWwAQSYQnXvIgAAIxGttg==,true,true,true,teamsForBusiness,true,false
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar set
+
+  Date: 4/2/2026
+
+  Property | Value
+  ---------|-------
+  id | AAMkAGI2TQpZAAA=
+  name | Team planning
+  color | auto
+  hexColor |
+  isDefaultCalendar | false
+  changeKey | DxYSthXJXEWwAQSYQnXvIgAAIxGttg==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | true
+  isRemovable | false
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -0,0 +1,125 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendargroup get
+
+Retrieves a calendar group for a user.
+
+## Usage
+
+```sh
+m365 outlook calendargroup get [options]
+```
+
+## Options
+
+```md definition-list
+`--id [id]`
+: ID of the calendar group. Specify either `id` or `name`, but not both.
+
+`--name [name]`
+: Name of the calendar group. Specify either `id` or `name`, but not both.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                |
+  |-----------------|------------------------------------------------------------|
+  | Microsoft Graph | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Calendars.ReadBasic, Calendars.Read |
+
+  </TabItem>
+</Tabs>
+
+:::note
+
+When using delegated permissions, specifying `userId` or `userName` for a different user requires the `Calendars.Read.Shared` or `Calendars.ReadWrite.Shared` scope. When the specified user matches the signed-in user, no shared scope is needed.
+
+:::
+
+## Examples
+
+Get the calendar group specified by name for the signed-in user.
+
+```sh
+m365 outlook calendargroup get --name "Personal Events"
+```
+
+Get the calendar group specified by name for a user using application permissions.
+
+```sh
+m365 outlook calendargroup get --name "Personal Events" --userId "44288f7d-7710-4293-8c8e-36f310ed2e6a"
+```
+
+Get the calendar group specified by id for a user using application permissions.
+
+```sh
+m365 outlook calendargroup get --id "AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAAABuC34AAA=" --userId "44288f7d-7710-4293-8c8e-36f310ed2e6a"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmYyY2I5NTM3ZAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAbfYq5lmBxQ6a4t1fGbeYAAAAAAEOAAA=",
+    "name": "My Calendars",
+    "changeKey": "nfZyf7VcrEKLNoU37KWlkQAAA0x0+w==",
+    "classId": "0006f0b7-0000-0000-c000-000000000046"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                                                                       name
+  -----------------------------------------------------------------------------------------------------------------------  ----------------
+  AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmYyY2I5NTM3ZAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAbfYq5lmBxQ6a4t1fGbeYAAAAAAEOAAA=  My Calendars
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name
+  AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmYyY2I5NTM3ZAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAbfYq5lmBxQ6a4t1fGbeYAAAAAAEOAAA=,My Calendars
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendargroup get
+
+  Date: 3/20/2026
+
+  Property | Value
+  ---------|-------
+  id | AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmYyY2I5NTM3ZAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAbfYq5lmBxQ6a4t1fGbeYAAAAAAEOAAA=
+  name | My Calendars
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -2,7 +2,7 @@ import Global from '../../_global.mdx';
 
 # spo applicationcustomizer add
 
-Add an application customizer to a site
+Add an Application Customizer to a site
 
 ## Usage
 
@@ -14,29 +14,32 @@ m365 spo applicationcustomizer add [options]
 
 ```md definition-list
 `-t, --title <title>`
-: The title of the application customizer.
+: The title of the Application Customizer.
 
 `-u, --webUrl <webUrl>`
 : URL of the site.
 
 `-i, --clientSideComponentId <clientSideComponentId>`
-: Client-side component ID of the application customizer (GUID).
+: Client-side component ID of the Application Customizer (GUID).
 
 `--description [description]`
-: Description of the application customizer.
+: Description of the Application Customizer.
 
 `--clientSideComponentProperties [clientSideComponentProperties]`
-: JSON string with application customizer properties.
+: JSON string with Application Customizer properties.
+
+`--hostProperties [hostProperties]`
+: Set the host properties of the Application Customizer.
 
 `-s, --scope [scope]`
-: Scope of the application customizer. Allowed values: `Site`, `Web`. Defaults to `Site`.
+: Scope of the Application Customizer. Allowed values: `Site`, `Web`. Defaults to `Site`.
 ```
 
 <Global />
 
 ## Remarks
 
-Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treats quotes differently. For example, this is how an application customizer can be created from the Windows cmd.exe:
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treats quotes differently. For example, this is how an Application Customizer can be created from the Windows cmd.exe:
 
 ```sh
 m365 spo applicationcustomizer add --webUrl https://contoso.sharepoint.com/sites/test --title "YourAppCustomizer" --clientSideComponentId b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
@@ -46,21 +49,21 @@ Note, how the clientSideComponentProperties option has escaped double quotes `'{
 
 :::warning[Escaping JSON in PowerShell]
 
-When using the `--clientSideComponentProperties` 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 `--clientSideComponentProperties` or `--hostProperties` 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.
 
 :::
 
-This command can be used for configuring an application customizer on a specific site. To configure an application customizer tenant-wide, view our dedicated [spo tenant applicationcustomizer add](../tenant/tenant-applicationcustomizer-add.mdx) command.
+This command can be used for configuring an Application Customizer on a specific site. To configure an Application Customizer tenant-wide, view our dedicated [spo tenant applicationcustomizer add](../tenant/tenant-applicationcustomizer-add.mdx) command.
 
 ## Examples
 
-Adds an application customizer to the sales site.
+Adds an Application Customizer to the sales site.
 
 ```sh
 m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --webUrl https://contoso.sharepoint.com/sites/sales
 ```
 
-Adds an application customizer to the sales site with some properties.
+Adds an Application Customizer to the sales site with some properties.
 
 ```sh
 m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales --scope 'Site'

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

@@ -29,11 +29,14 @@ m365 spo applicationcustomizer set [options]
 : The new title of the Application Customizer.
 
 `--description [description]`
-: Description of the application customizer. Specify an empty string to clear.
+: Description of the Application Customizer. Specify an empty string to clear.
 
 `-p, --clientSideComponentProperties  [clientSideComponentProperties]`
 : The Client Side Component properties of the Application Customizer.
 
+`--hostProperties [hostProperties]`
+: Set the host properties for the Application Customizer. Set to an empty string to clear the value.
+
 `-s, --scope [scope]`
 : The scope where to lookup the Application Customizer. Allowed values: `Site`, `Web`, and `All`. Defaults to `All`.
 ```
@@ -42,7 +45,7 @@ m365 spo applicationcustomizer set [options]
 
 ## Remarks
 
-Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for clientSideComponentProperties option that has JSON value because the command shell treats quotes differently. For example, this is how Application Customizer can be updated from the Windows cmd.exe:
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for `clientSideComponentProperties` and `hostProperties` options that have JSON value because the command shell treats quotes differently. For example, this is how Application Customizer can be updated from the Windows cmd.exe:
 
 ```sh
 m365 spo applicationcustomizer set --webUrl https://contoso.sharepoint.com/sites/sales --id b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --newTitle "Some customizer" --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
@@ -52,21 +55,21 @@ Note, how the clientSideComponentProperties option (--clientSideComponentPropert
 
 :::warning[Escaping JSON in PowerShell]
 
-When using the `--clientSideComponentProperties` 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 `--clientSideComponentProperties` or `--hostProperties` 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.
 
 :::
 
-This command can be used for updating an application customizer on a specific site. To update an application customizer that's installed tenant-wide, view our dedicated [spo tenant applicationcustomizer set](../tenant/tenant-applicationcustomizer-set.mdx) command.
+This command can be used for updating an Application Customizer on a specific site. To update an Application Customizer that's installed tenant-wide, view our dedicated [spo tenant applicationcustomizer set](../tenant/tenant-applicationcustomizer-set.mdx) command.
 
 ## Examples
 
-Updates the title of an application customizer on the sales site.
+Updates the title of an Application Customizer on the sales site.
 
 ```sh
 m365 spo applicationcustomizer set --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --newTitle "Some customizer" --webUrl https://contoso.sharepoint.com/sites/sales
 ```
 
-Updates the properties of an application customizer on the sales site.
+Updates the properties of an Application Customizer on the sales site.
 
 ```sh
 m365 spo applicationcustomizer set --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{ "testMessage": "Test message" }' --webUrl https://contoso.sharepoint.com/sites/sales

package/docs/docs/cmd/spo/brandcenter/brandcenter-colors-list.mdx

@@ -0,0 +1,115 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo brandcenter colors list
+
+Lists the brand center colors
+
+## Usage
+
+```sh
+m365 spo brandcenter colors list [options]
+```
+
+## Options
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
+## Remarks
+
+If the brand colors list has not been created yet in the Brand Center, the command will return an empty array.
+
+## Examples
+
+List all brand center colors
+
+```sh
+m365 spo brandcenter colors list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Title": "Primary",
+      "ColorCode": "#0078D4",
+      "IsVisible": true
+    },
+    {
+      "Title": "Secondary",
+      "ColorCode": "#FF4500",
+      "IsVisible": false
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```txt
+  Title      ColorCode  IsVisible
+  ---------  ---------  ---------
+  Primary    #0078D4    true
+  Secondary  #FF4500    false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Title,ColorCode,IsVisible
+  Primary,#0078D4,true
+  Secondary,#FF4500,false
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo brandcenter colors list
+
+  Date: 4/4/2026
+
+  ## Primary
+
+  Property | Value
+  ---------|-------
+  Title | Primary
+  ColorCode | #0078D4
+  IsVisible | true
+
+  ## Secondary
+
+  Property | Value
+  ---------|-------
+  Title | Secondary
+  ColorCode | #FF4500
+  IsVisible | false
+  ```
+
+  </TabItem>
+</Tabs>