@pnp/cli-microsoft365 6.0.0-beta.f782445 → 6.0.0-beta.fcd2cc9

package/docs/docs/cmd/spo/listitem/listitem-roleinheritance-reset.md

@@ -17,10 +17,16 @@ m365 spo listitem roleinheritance reset [options]
 : ID of the item for which to reset role inheritance
 
 `--listId [listId]`
-: ID of the list. Specify listId or listTitle but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list. Specify listId or listTitle but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`--confirm`
+: Do not prompt for confirmation before resetting role inheritance.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +43,9 @@ Restore role inheritance of list item with id 8 from list with title _test_ loca
 ```sh
 m365 spo listitem roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listItemId 8 --listTitle test
 ```
+
+Restore role inheritance of a list item with a specific id in a list retrieved by server relative URL located in a specific site without prompting for confirmation
+
+```sh
+m365 spo listitem roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listItemId 8 --listUrl /sites/project-x/lists/test --confirm
+```

package/docs/docs/cmd/spo/listitem/listitem-set.md

@@ -17,10 +17,13 @@ m365 spo listitem set [options]
 : ID of the list item to update.
 
 `-l, --listId [listId]`
-: ID of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-c, --contentType [contentType]`
 : The name or the ID of the content type to associate with the updated item
@@ -62,8 +65,8 @@ Update an item with id _147_ with Title _Demo Multi Person Field_ and a multi-se
 m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
 ```
 
-Update an item with id _147_ with Title _Demo Hyperlink Field_ and a hyperlink field named _CustomHyperlink_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in a list retrieved by server-relative URL in a specific site
 
 ```sh
-m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
+m365 spo listitem set --listUrl '/sites/project-x/lists/Demo List' --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
 ```

package/docs/docs/cmd/spo/page/page-clientsidewebpart-add.md

@@ -45,7 +45,8 @@ If the specified `pageName` doesn't refer to an existing modern page, you will g
 
 To add a standard web part to the page, specify one of the following values: _ContentRollup, BingMap, ContentEmbed, DocumentEmbed, Image, ImageGallery, LinkPreview, NewsFeed, NewsReel, PowerBIReportEmbed, QuickChart, SiteActivity, VideoEmbed, YammerEmbed, Events, GroupCalendar, Hero, List, PageTitle, People, QuickLinks, CustomMessageRegion, Divider, MicrosoftForms, Spacer_.
 
-When specifying the JSON string with web part properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _webPartProperties_ option: `{"Foo":"Bar"}`, you should specify the value as \`"{""Foo"":""Bar""}"\`. In addition, when using PowerShell, you should use the `--%` argument.
+!!! 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.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 ## Examples
 
@@ -67,20 +68,14 @@ Add a custom web part to the modern page
 m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --webPartId 3ede60d3-dc2c-438b-b5bf-cc40bb2351e1
 ```
 
-Using PowerShell, add the standard Bing Map web part with the specific properties to a modern page
-
-```PowerShell
-m365 --% spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties `"{""Title"":""Foo location""}"`
-```
-
-Using Windows command line, add the standard Bing Map web part with the specific properties to a modern page
+Add the standard Bing Map web part with the specific properties to a modern page
 
 ```sh
-m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties `"{""Title"":""Foo location""}"`
+m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties '{"Title":"Foo location"}'
 ```
 
 Add the standard Image web part with the preconfigured image
 
 ```sh
-m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart Image --webPartData '`{ "dataVersion": "1.8", "serverProcessedContent": {"htmlStrings":{},"searchablePlainTexts":{"captionText":""},"imageSources":{"imageSource":"/sites/team-a/SiteAssets/work-life-balance.png"},"links":{}}, "properties": {"imageSourceType":2,"altText":"a group of people on a beach","overlayText":"Work life balance","fileName":"48146-OFF12_Justice_01.png","siteId":"27664b85-067d-4be9-a7d7-89b2e804d09f","webId":"a7664b85-067d-4be9-a7d7-89b2e804d09f","listId":"37664b85-067d-4be9-a7d7-89b2e804d09f","uniqueId":"67664b85-067d-4be9-a7d7-89b2e804d09f","imgWidth":650,"imgHeight":433,"fixAspectRatio":false,"isOverlayTextEnabled":true}}`'
+m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart Image --webPartData '{ "dataVersion": "1.8", "serverProcessedContent": {"htmlStrings":{},"searchablePlainTexts":{"captionText":""},"imageSources":{"imageSource":"/sites/team-a/SiteAssets/work-life-balance.png"},"links":{}}, "properties": {"imageSourceType":2,"altText":"a group of people on a beach","overlayText":"Work life balance","fileName":"48146-OFF12_Justice_01.png","siteId":"27664b85-067d-4be9-a7d7-89b2e804d09f","webId":"a7664b85-067d-4be9-a7d7-89b2e804d09f","listId":"37664b85-067d-4be9-a7d7-89b2e804d09f","uniqueId":"67664b85-067d-4be9-a7d7-89b2e804d09f","imgWidth":650,"imgHeight":433,"fixAspectRatio":false,"isOverlayTextEnabled":true}}'
 ```

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

@@ -31,7 +31,8 @@ m365 spo page control set [options]
 
 If the specified `pageName` doesn't refer to an existing modern page, you will get a `File doesn't exists` error.
 
-When specifying the JSON string with web part properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _webPartProperties_ option: `{"Foo":"Bar"}`, you should specify the value as \`"{""Foo"":""Bar""}"\`. In addition, when using PowerShell, you should use the `--%` argument.
+!!! 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.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 ## Examples
 

package/docs/docs/cmd/spo/roledefinition/roledefinition-add.md

@@ -0,0 +1,43 @@
+# spo roledefinition add
+
+Adds a new roledefinition to web
+
+## Usage
+
+```sh
+m365 spo roledefinition add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site to which role should be added
+
+`-n, --name <name>`
+: role definition name
+
+`-d, --description [description]`
+: role definition description
+
+`--rights [rights]`
+: A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask,ViewListItems,AddListItems,EditListItems,DeleteListItems,ApproveItems,OpenItems,ViewVersions,DeleteVersions,CancelCheckout,ManagePersonalViews,ManageLists,ViewFormPages,AnonymousSearchAccessList,Open,ViewPages,AddAndCustomizePages,ApplyThemeAndBorder,ApplyStyleSheets,ViewUsageData,CreateSSCSite,ManageSubwebs,CreateGroups,ManagePermissions,BrowseDirectories,BrowseUserInfo,AddDelPrivateWebParts,UpdatePersonalWebParts,ManageWeb,AnonymousSearchAccessWebLists,UseClientIntegration,UseRemoteAPIs,ManageAlerts,CreateAlerts,EditMyUserInfo,EnumeratePermissions,FullMask`. Default `EmptyMask`
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+The `--rights` option accepts **case-sensitive** values.
+
+## Examples
+
+Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_
+
+```sh
+m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test
+```
+
+Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_ and description _test description_ and rights _ViewListItems,AddListItems,EditListItems,DeleteListItems_
+
+```sh
+m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test --description "test description" --rights "ViewListItems,AddListItems,EditListItems,DeleteListItems"
+```

package/docs/docs/cmd/spo/site/site-add.md

@@ -46,9 +46,6 @@ m365 spo site add [options]
 `--siteDesignId [siteDesignId]`
 : Id of the custom site design to use to create the site. When creating a communication site, specify either `siteDesign` or `siteDesignId` (applies to type CommunicationSite)
 
-`--allowFileSharingForGuestUsers`
-: (deprecated. Use `shareByEmailEnabled` instead) Determines whether it's allowed to share file with guests (applies to type CommunicationSite)
-
 `--shareByEmailEnabled`
 : Determines whether it's allowed to share file with guests (applies to type CommunicationSite)
 

package/docs/docs/cmd/spo/site/site-apppermission-add.md

@@ -14,7 +14,7 @@ m365 spo site apppermission add [options]
 : URL of the site collection to add the permission
 
 `-p, --permission <permission>`
-: Permission to site (`read`, `write`, or `owner`)
+: Permission to site (`read`, `write`, `manage` or `fullcontrol`)
 
 `-i, --appId [appId]`
 : Client ID of the Azure AD app for which to grant permissions

package/docs/docs/cmd/spo/site/site-apppermission-set.md

@@ -23,7 +23,7 @@ m365 spo site apppermission set [options]
 : Display name of the Azure AD app for which to update permissions. Specify `id`, `appId` or `appDisplayName`
 
 `-p, --permission <permission>`
-: Permission to site (`read`, `write`, or `owner`)
+: Permission to site (`read`, `write`, `manage` or `fullcontrol`)
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/spo/{hubsite/hubsite-connect.md → site/site-hubsite-connect.md}

@@ -1,11 +1,11 @@
-# spo hubsite connect
+# spo site hubsite connect
 
 Connects the specified site collection to the given hub site
 
 ## Usage
 
 ```sh
-m365 spo hubsite connect [options]
+m365 spo site hubsite connect [options]
 ```
 
 ## Options
@@ -29,10 +29,10 @@ If the specified `id` doesn't point to a valid hub site, you will get a `Resourc
 
 ## Examples
 
-Connect the site collection with URL _https://contoso.sharepoint.com/sites/contoso-sales_ to the hub site with ID _255a50b2-527f-4413-8485-57f4c17a24d1_
+Connect a specific site collection to a hub site
 
 ```sh
-m365 spo hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
+m365 spo site hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
 ```
 
 ## More information

package/docs/docs/cmd/spo/site/site-hubsite-disconnect.md

@@ -0,0 +1,42 @@
+# spo site hubsite disconnect
+
+Disconnects the specified site collection from its hub site
+
+## Usage
+
+```sh
+m365 spo site hubsite disconnect [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site collection to disconnect from its hub site
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Disconnect a specific site collection from its hub site. Will prompt for confirmation before disconnecting from the hub site.
+
+```sh
+m365 spo site hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales
+```
+
+Disconnect a specific site collection from its hub site without prompting for confirmation.
+
+```sh
+m365 spo site hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales --confirm
+```
+
+## More information
+
+- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/{hubsite/hubsite-theme-sync.md → site/site-hubsite-theme-sync.md}

@@ -1,11 +1,11 @@
-# spo hubsite theme sync
+# spo site hubsite theme sync
 
-Applies any theme updates from the parent hub site.
+Applies any theme updates from the hub site the site is connected to.
 
 ## Usage
 
 ```sh
-m365 spo hubsite theme sync [options]
+m365 spo site hubsite theme sync [options]
 ```
 
 ## Options
@@ -22,10 +22,10 @@ m365 spo hubsite theme sync [options]
 
 ## Examples
 
-Applies any theme updates from the parent hub site to the site with URL https://contoso.sharepoint.com/sites/project-x
+Applies any theme updates from the hub site to a specific site
 
 ```sh
-m365 spo hubsite theme sync --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo site hubsite theme sync --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
 ## More information

package/docs/docs/cmd/spo/term/term-add.md

@@ -45,6 +45,11 @@ m365 spo term add [options]
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 
+## Remarks
+
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--customProperties` and/or `--localCustomProperties` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
 ## Examples
 
 Add taxonomy term with the specified name to the term group and term set specified by their names

package/docs/docs/cmd/spo/term/term-set-add.md

@@ -33,6 +33,11 @@ m365 spo term set add [options]
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 
+## Remarks
+
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--customProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
 ## Examples
 
 Add taxonomy term set to the term group specified by ID
@@ -56,5 +61,5 @@ m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-
 Add taxonomy term set and set its custom properties
 
 ```sh
-m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --customProperties '`{"Property":"Value"}`'
+m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --customProperties '{"Property":"Value"}'
 ```

package/docs/docs/cmd/spo/web/web-roleassignment-add.md

@@ -35,23 +35,23 @@ m365 spo web roleassignment add [options]
 add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
 
 ```sh
-m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionId 1073741829
+m365 spo web roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionId 1073741829
 ```
 
 add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for upn _someaccount@tenant.onmicrosoft.com_ and role definition id _1073741829_
 
 ```sh
-m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+m365 spo web roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
 ```
 
 add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for group _someGroup_ and role definition id _1073741829_
 
 ```sh
-m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --groupName "someGroup" --roleDefinitionId 1073741829
+m365 spo web roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --groupName "someGroup" --roleDefinitionId 1073741829
 ```
 
 add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition name _Full Control_
 
 ```sh
-m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionName "Full Control"
-```
+m365 spo web roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionName "Full Control"
+```

package/docs/docs/cmd/spo/web/web-roleassignment-remove.md

@@ -32,23 +32,23 @@ m365 spo web roleassignment remove [options]
 Remove roleassignment from web based on group name
 
 ```sh
-m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --groupName "saleGroup"
+m365 spo web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --groupName "saleGroup"
 ```
 
 Remove roleassignment from web based on principal Id
 
 ```sh
-m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2
+m365 spo web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2
 ```
 
 Remove roleassignment from web based on upn
 
 ```sh
-m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --upn "someaccount@tenant.onmicrosoft.com"
+m365 spo web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --upn "someaccount@tenant.onmicrosoft.com"
 ```
 
 Remove roleassignment from web based on principal Id without prompting for confirmation
 
 ```sh
-m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2 --confirm
-```
+m365 spo web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2 --confirm
+```

package/docs/docs/cmd/spo/web/web-roleinheritance-break.md

@@ -0,0 +1,44 @@
+# spo web roleinheritance break
+
+Break role inheritance of subsite
+
+## Usage
+
+```sh
+m365 spo web roleinheritance break [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site.
+
+`-c, --clearExistingPermissions`
+: Clears all existing permissions from the web.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+By default, when breaking permissions inheritance, the web will retain existing permissions. To remove existing permissions, use the `--clearExistingPermissions` option.
+
+## Examples
+
+Break role inheritance of a web and keep the existing permissions
+
+```sh
+m365 spo web roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Break role inheritance of a web and clear the existing permissions
+
+```sh
+m365 spo web roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --clearExistingPermissions
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/web/web-roleinheritance-reset.md

@@ -13,6 +13,9 @@ m365 spo web roleinheritance reset [options]
 `-u, --webUrl <webUrl>`
 : URL of the site
 
+`--confirm`
+: Do not prompt for confirmation before resetting role inheritance.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -21,4 +24,10 @@ Restore role inheritance of subsite _https://contoso.sharepoint.com/sites/projec
 
 ```sh
 m365 spo web roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x
-```
+```
+
+Restore role inheritance of subsite _https://contoso.sharepoint.com/sites/project-x_ without prompting for confirmation
+
+```sh
+m365 spo web roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --confirm
+```

package/docs/docs/cmd/teams/cache/cache-remove.md

@@ -43,4 +43,4 @@ m365 teams cache remove
 
 ## More information
 
-- [Clear the Teams client cache guidance](https://docs.microsoft.com/microsoftteams/troubleshoot/teams-administration/clear-teams-cache)
+- [Clear the Teams client cache guidance](https://docs.microsoft.com/microsoftteams/troubleshoot/teams-administration/clear-teams-cache)

package/docs/docs/cmd/teams/channel/channel-add.md

@@ -23,10 +23,10 @@ m365 teams channel add [options]
 : The description of the channel to add
 
 `--type [type]`
-: Type of channel to create: `standard,private`. Default `standard`.
+: Type of channel to create: `standard`, `private`, `shared`. Default `standard`.
 
 `--owner [owner]`
-: User with this ID or UPN will be added as owner of the private channel. This option is required when type is `private`.
+: User with this ID or UPN will be added as owner of the channel. This option is required when type is `private` or `shared`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -54,8 +54,8 @@ Add private channel to the specified Microsoft Teams team with owner UPN
 m365 teams channel add --teamName "Team Name" --name climicrosoft365 --type private --owner john.doe@contoso.com
 ```
 
-Add private channel to the specified Microsoft Teams team with owner ID
+Add shared channel to the specified Microsoft Teams team with owner ID
 
 ```sh
-m365 teams channel add --teamId 6703ac8a-c49b-4fd4-8223-28f0ac3a6402 --name climicrosoft365 --type private --owner cc693a7d-4833-4911-a89a-f0fe6e49bf69
-```
+m365 teams channel add --teamId 6703ac8a-c49b-4fd4-8223-28f0ac3a6402 --name climicrosoft365 --type shared --owner cc693a7d-4833-4911-a89a-f0fe6e49bf69
+```

package/docs/docs/cmd/teams/channel/channel-get.md

@@ -10,20 +10,20 @@ m365 teams channel get [options]
 
 ## Options
 
-`-i, --teamId [teamId]`
-: The ID of the team to which the channel belongs to. Specify either teamId or teamName but not both
+`--teamId [teamId]`
+: The ID of the team to which the channel belongs to. Specify either `teamId` or `teamName` but not both.
 
 `--teamName [teamName]`
-: The display name of the team to which the channel belongs to. Specify either teamId or teamName but not both
+: The display name of the team to which the channel belongs to. Specify either `teamId` or `teamName` but not both.
 
-`-c, --id [id]`
-: The ID of the channel for which to retrieve more information. Specify either id or name but not both
+`-i, --id [id]`
+: The ID of the channel for which to retrieve more information. Specify either `id` or `name` but not both.
 
 `--name [name]`
-: The display name of the channel for which to retrieve more information. Specify either id or name but not both
+: The display name of the channel for which to retrieve more information. Specify either `id` or `name` but not both.
 
 `--primary`
-: Gets the default channel, General, of a team. If specified, id or name are not needed
+: Gets the default channel, General, of a team. If specified, id or name are not needed.
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/teams/channel/channel-list.md

@@ -17,7 +17,7 @@ m365 teams channel list [options]
 : The display name of the team to list the channels of. Specify either `teamId` or `teamName` but not both
 
 `--type [type]`
-: Filter the results to only channels of a given type: `standard, private`. By default all channels are listed.
+: Filter the results to only channels of a given type: `standard`, `private`, `shared`. By default all channels are listed.
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/teams/channel/channel-member-add.md

@@ -1,6 +1,6 @@
 # teams channel member add
 
-Adds a specified member in the specified Microsoft Teams private team channel
+Adds a specified member in the specified Microsoft Teams private or shared team channel
 
 ## Usage
 
@@ -17,10 +17,10 @@ m365 teams channel member add [options]
 : The name of the team where the channel is located. Specify either `teamId` or `teamName`, but not both.
 
 `-c, --channelId [channelId]`
-: The private channel's ID. Specify either `channelId` or `channelName`, but not both.
+: The Id of the Microsoft Teams team channel. Specify either `channelId` or `channelName`, but not both.
 
 `--channelName [channelName]`
-: The private channel's name. Specify either `channelId` or `channelName`, but not both.
+: The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName`, but not both.
 
 `--userId [userId]`
 : The user's ID or principal name. You can also pass a comma separated list of userIds.
@@ -35,9 +35,9 @@ m365 teams channel member add [options]
 
 ## Remarks
 
-At least one owner must be assigned to a private channel.
+At least one owner must be assigned to a private or shared channel.
 
-You can only add members and owners of a Team to a private channel.
+You can only add members and owners of a team to a private channel.
 
 ## Examples
 

package/docs/docs/cmd/teams/channel/channel-member-remove.md

@@ -1,6 +1,6 @@
 # teams channel member remove
 
-Remove the specified member from the specified Microsoft Teams private team channel
+Remove the specified member from the specified Microsoft Teams private or shared team channel
 
 ## Usage
 

package/docs/docs/cmd/teams/channel/channel-member-set.md

@@ -1,6 +1,6 @@
 # teams channel member set
 
-Updates the role of the specified member in the specified Microsoft Teams private team channel
+Updates the role of the specified member in the specified Microsoft Teams private or shared team channel
 
 ## Usage
 
@@ -48,4 +48,4 @@ Updates the role of the user with id 00000000-0000-0000-0000-000000000000 to mem
 
 ```sh
 m365 teams channel member set --teamName "Team Name" --channelName "Channel Name" --userId 00000000-0000-0000-0000-000000000000 --role member
-```
+```

package/docs/docs/cmd/teams/channel/channel-remove.md

@@ -10,17 +10,20 @@ m365 teams channel remove [options]
 
 ## Options
 
-`-c, --id [id]`
-: The ID of the channel to remove
+`--teamId [teamId]`
+: The ID of the team to which the channel to remove belongs. Specify either `teamId` or `teamName` but not both.
 
-`-n, --name [name]`
-: The name of the channel to remove. Specify id or name but not both
+`--teamName [teamName]`
+: The display name of the team to which the channel to remove belongs. Specify either `teamId` or `teamName` but not both.
+
+`-i, --id [id]`
+: The ID of the channel to remove. Specify `id` or `name` but not both.
 
-`-i, --teamId <teamId>`
-: The ID of the team to which the channel to remove belongs
+`-n, --name [name]`
+: The name of the channel to remove. Specify `id` or `name` but not both.
 
 `--confirm`
-: Don't prompt for confirmation
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -45,13 +48,13 @@ m365 teams channel remove --id 19:f3dcbb1674574677abcae89cb626f1e6@thread.skype
 Remove the specified Microsoft Teams channel by Name
 
 ```sh
-m365 teams channel remove --name 'name' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656
+m365 teams channel remove --name 'name' --teamName "Team Name"
 ```
 
 Remove the specified Microsoft Teams channel by Name without confirmation
 
 ```sh
-m365 teams channel remove --name 'name' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656 --confirm 
+m365 teams channel remove --name 'name' --teamName "Team Name" --confirm 
 ```
 
 ## More information