@pnp/cli-microsoft365 10.9.0-beta.bc13e90 → 10.10.0-beta.1bb5ba0

package/docs/docs/cmd/spo/list/list-view-add.mdx

@@ -30,12 +30,33 @@ m365 spo list view add [options]
 `--title <title>`
 : Title of the view to be created for the list.
 
-`--fields <fields>`
-: Comma-separated list of **case-sensitive** internal names of the fields to add to the view.
+`--type [type]`
+: Type of the view. Possible values are: `list`, `calendar`, `gallery`, `kanban`. Defaults to `list`.
+
+`--fields [fields]`
+: Comma-separated list of **case-sensitive** internal names of the fields to add to the view. Optional when `type` is set to `calendar`.
 
 `--viewQuery [viewQuery]`
 : XML representation of the list query for the underlying view.
 
+`--calendarStartDateField [calendarStartDateField]`
+: Internal name of the field that contains the start date of the calendar event. Required when `type` is set to `calendar`.
+
+`--calendarEndDateField [calendarEndDateField]`
+: Internal name of the field that contains the end date of the calendar event. Required when `type` is set to `calendar`.
+
+`--calendarTitleField [calendarTitleField]`
+: Internal name of the field that contains the title of the calendar event. Required when `type` is set to `calendar`.
+
+`--calendarSubTitleField [calendarSubTitleField]`
+: Internal name of the field that contains the subtitle of the calendar event.
+
+`--calendarDefaultLayout [calendarDefaultLayout]`
+: Default layout of the calendar view. Possible values are: `month`, `week`, `workWeek`, `day`. Defaults to `month`.
+
+`--kanbanBucketField [kanbanBucketField]`
+: Internal name of the field that contains the bucket for the Kanban board view. Required when `type` is set to `kanban`.
+
 `--personal`
 : View will be created as personal view, if specified.
 
@@ -53,32 +74,54 @@ m365 spo list view add [options]
 
 ## Remarks
 
+:::tip
+
 We recommend using the `paged` option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the `rowLimit` is absolute, and there is no link to see more items.
 
+:::
+
 ## Examples
 
-Add a view called _All events_ to a list with specific title.
+Add a list view called to a list with specific title.
+
+```sh
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged
+```
+
+Add a gallery view as default view to a list with a specific URL.
+
+```sh
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --default
+```
+
+Add a view with defined filter and sorting.
+
+```sh
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>" --paged
+```
+
+Add a gallery view as personal view.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Test" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --personal
 ```
 
-Add a view as default view with title _All events_ to a list with a specific URL.
+Add a calendar view with month layout.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --paged
 ```
 
-Add a personal view called _All events_ to a list with a specific ID.
+Add a calendar view with week layout and subtitle.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week --paged
 ```
 
-Add a view called _All events_ with defined filter and sorting.
+Add a Kanban board view.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Test" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>" --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status --paged
 ```
 
 ## Response

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

@@ -0,0 +1,56 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo page control remove
+
+Removes a control from a modern page
+
+## Usage
+
+```sh
+m365 spo page control remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the page is located.
+
+`-n, --pageName <pageName>`
+: Name of the page where the control is located.
+
+`-i, --id <id>`
+: The ID of the control to be removed.
+
+`--draft`
+: Save the page as draft instead of republishing it.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove a control from a SharePoint page, with confirmation
+
+```sh
+m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName home.aspx --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1
+```
+
+Remove a control from a SharePoint page and don't republish the page
+
+```sh
+m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName "home.aspx" --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1 --draft
+```
+
+Remove a control from a SharePoint page, that is located in a folder
+
+```sh
+m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName "Archive/home.aspx" --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/page/page-section-add.mdx

@@ -20,7 +20,7 @@ m365 spo page section add [options]
 : URL of the site where the page to retrieve is located.
 
 `-t, --sectionTemplate <sectionTemplate>`
-: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`, `Vertical`.
+: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`, `Vertical`, `Flexible`.
 
 `--order [order]`
 : Order of the section to add.
@@ -43,6 +43,9 @@ m365 spo page section add [options]
 `--isExpanded`
 : Sets the default display state of the collapsible section. Sets `false` if not specified.
 
+`--headingLevel [headingLevel]`	
+: Heading level of collapsible section Allowed values `2`, `3`, `4`.
+
 `--gradientText [gradientText]`
 : Sets the gradient setting of the background of a section. Required when `zoneEmphasis` is `Gradient`.
 
@@ -68,7 +71,13 @@ m365 spo page section add [options]
 : The overlay opacity for the background. Applied only when `zoneEmphasis` is `Image` or `Gradient`. Sets `60` value if not specified.
 
 `--collapsibleTitle [collapsibleTitle]`	
-: The display name of the collapsible section
+: The display name of the collapsible section.
+
+`--zoneReflowStrategy [zoneReflowStrategy]`	
+: Mobile and email reflow. Allowed values `TopToBottom`, `LeftToRight`. Applied only for `Flexible` section.
+
+`--zoneHeight [zoneHeight]`	
+: Section height. Minimum value is `34`. Applied only for `Flexible` section.
 ```
 
 <Global />
@@ -115,6 +124,12 @@ Add OneColumn section as a collapsible section as expanded with icon aligned to
 m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --isCollapsibleSection --isExpanded --iconAlignment Left
 ```
 
+Add OneColumn section as a collapsible section as expanded with headingLevel 3
+
+```sh
+m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --isCollapsibleSection --isExpanded --headingLevel 3
+```
+
 Add TwoColumn section with Image background
 
 ```sh
@@ -127,6 +142,11 @@ Add OneColumn section with Gradient background
 m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate TwoColumn --zoneEmphasis Gradient --gradientText "linear-gradient(72.44deg, #E6FBFE 0%, #EDDDFB 100%)"
 ```
 
+Add a Flexible section to the modern page with mobile and email reflow and section height.
+
+```sh
+m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Flexible --zoneHeight 100 --zoneReflowStrategy LeftToRight
+```
 
 ## Response
 

package/docs/docs/cmd/spo/tenant/tenant-site-list.mdx

@@ -28,9 +28,12 @@ m365 spo site list
 : type of sites to list. To be used with values like `GROUP#0` and `SITEPAGEPUBLISHING#0`. Specify either `type` or `webTemplate`, but not both.  
 
 `--filter [filter]`
-: filter to apply when retrieving sites
+: filter to apply when retrieving sites.
 
 `--includeOneDriveSites`
+: (deprecated. Use option `withOneDriveSites` instead) use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
+
+`--withOneDriveSites`
 : use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
 ```
 
@@ -52,34 +55,34 @@ To use this command you have to have permissions to access the tenant admin site
 
 ## Examples
 
-List all sites in the currently connected tenant
+List all sites in the currently connected tenant.
 
 ```sh
 m365 spo tenant site list
 ```
 
-List all group connected team sites in the currently connected tenant
+List all group connected team sites in the currently connected tenant.
 
 ```sh
 m365 spo tenant site list --type TeamSite
 ```
 
-List all communication sites in the currently connected tenant
+List all communication sites in the currently connected tenant.
 
 ```sh
 m365 spo tenant site list --type CommunicationSite
 ```
 
-List all group connected team sites that contain _project_ in the URL
+List all group connected team sites that contain _project_ in the URL.
 
 ```sh
 m365 spo tenant site list --type TeamSite --filter "Url -like 'project'"
 ```
 
-List all sites in the currently connected tenant including OneDrive sites
+List all sites in the currently connected tenant including OneDrive sites.
 
 ```sh
-m365 spo tenant site list --includeOneDriveSites
+m365 spo tenant site list --withOneDriveSites
 ```
 
 ## Response

package/docs/docs/cmd/spo/term/term-list.mdx

@@ -31,6 +31,9 @@ m365 spo term list [options]
 : Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both.
 
 `--includeChildTerms`
+: (deprecated. Use option `withChildTerms` instead) If specified, child terms are loaded as well.
+
+`--withChildTerms`
 : If specified, child terms are loaded as well.
 ```
 
@@ -69,7 +72,7 @@ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetI
 List taxonomy terms from the term group and term set with the given ID including child terms if any are found.
 
 ```sh
-m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --includeChildTerms
+m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --withChildTerms
 ```
 
 ## Response
@@ -162,9 +165,9 @@ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetI
   </TabItem>
 </Tabs>
 
-### `includeChildTerms` response
+### `withChildTerms` response
 
-When we make use of the option `includeChildTerms` the response will differ. 
+When we make use of the option `withChildTerms` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -245,7 +248,7 @@ When we make use of the option `includeChildTerms` the response will differ.
   <TabItem value="Markdown">
 
   ```md
-  # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations" --includeChildTerms "true"
+  # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations" --withChildTerms "true"
 
   Date: 5/8/2023
 

package/docs/docs/cmd/teams/chat/chat-member-add.mdx

@@ -26,10 +26,13 @@ m365 teams chat member add [options]
 : The role for the user to add. Valid values are: `owner`, `guest`. Defaults to `owner`.
 
 `--visibleHistoryStartDateTime [visibleHistoryStartDateTime]`
-: Include chat history until a certain point in time. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, or neither.
+: Include chat history until a certain point in time. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
 
 `--includeAllHistory`
-: Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, or neither.
+: (deprecated. Use option `withChildTerms` instead) Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
+
+`--withAllHistory`
+: Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
 ```
 
 <Global />
@@ -58,7 +61,7 @@ m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031
 Add a guest member by UPN to a Teams chat and share all chat history.
 
 ```sh
-m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031bb31-22c0-4f6f-9f73-91d34ab2b32d@unq.gbl.spaces --userName nelson.wilke@fabrikam.com --role guest --includeAllHistory
+m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031bb31-22c0-4f6f-9f73-91d34ab2b32d@unq.gbl.spaces --userName nelson.wilke@fabrikam.com --role guest --withAllHistory
 ```
 
 ## Response

package/docs/docs/cmd/viva/engage/engage-community-remove.mdx

@@ -0,0 +1,61 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# viva engage community remove
+
+Removes a Viva Engage community
+
+## Usage
+
+```sh
+m365 viva engage community remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
+
+`-n, --displayName [displayName]`
+: The name of the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
+
+`--entraGroupId [entraGroupId]`
+: The id of the Microsoft 365 group associated with the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+When the Viva Engage community is removed, all the associated Microsoft 365 content, including the M365 group, the document library, OneNote notebook, and Planner plan is deleted.
+
+:::
+
+## Examples
+
+Remove a community specified by id without prompting
+
+```sh
+m365 viva engage community remove --id eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9 --force
+```
+
+Remove a community specified by name and prompt for confirmation
+
+```sh
+m365 viva engage community remove --displayName 'Software Engineers'
+```
+
+Remove a community specified by Entra group id and prompt for confirmation
+
+```sh
+m365 viva engage community remove --entraGroupId '0bed8b86-5026-4a93-ac7d-56750cc099f1'
+```
+
+## Response
+
+The command won't return a response on success

package/docs/docs/cmd/viva/engage/engage-network-list.mdx

@@ -16,7 +16,10 @@ m365 viva engage network list [options]
 
 ```md definition-list
 `--includeSuspended`
-: Include the networks in which the user is suspended
+: (deprecated. Use option `withSuspended` instead) Include the networks in which the user is suspended.
+
+`--withSuspended`
+: Include the networks in which the user is suspended.
 ```
 
 <Global />
@@ -31,16 +34,16 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 ## Examples
 
-Returns the current user's networks
+Returns the current user's networks.
 
 ```sh
 m365 viva engage network list
 ```
 
-Returns the current user's networks including the networks in which the user is suspended
+Returns the current user's networks including the networks in which the user is suspended.
 
 ```sh
-m365 viva engage network list --includeSuspended
+m365 viva engage network list --withSuspended
 ```
 
 ## Response