@pnp/cli-microsoft365 6.0.0-beta.37b9374 → 6.0.0-beta.3a40034

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

@@ -87,9 +87,9 @@ The value of the `--storageQuota` option must not exceed the company's available
 
 The value of the `--storageQuotaWarningLevel` option must not exceed the the value of the `--storageQuota` option.
 
-If you try to create a site with the same URL as a site that has been previously moved to the recycle bin, you will get an error. To avoid this error, you can use the `--removeDeletedSite` option. Prior to creating the site, the spo site classic add command will check if the site with the specified URL has been previously moved to the recycle bin and if so, will remove it. Because removing sites from the recycle bin might take a moment, it should be used in conjunction with the `--wait` option so that the new site is not created before the old site is fully removed.
+If you try to create a site with the same URL as a site that has been previously moved to the recycle bin, you will get an error. To avoid this error, you can use the `--removeDeletedSite` option. Prior to creating the site, the spo site add command will check if the site with the specified URL has been previously moved to the recycle bin and if so, will remove it. Because removing sites from the recycle bin might take a moment, it should be used in conjunction with the `--wait` option so that the new site is not created before the old site is fully removed.
 
-Deleting and creating classic site collections is by default asynchronous and depending on the current state of Office 365, might take up to few minutes. If you're building a script with steps that require the site to be fully provisioned, you should use the `--wait` flag. When using this flag, the spo site classic add command will keep running until it received confirmation from Office 365 that the site has been fully provisioned.
+Deleting and creating classic site collections is by default asynchronous and depending on the current state of Office 365, might take up to few minutes. If you're building a script with steps that require the site to be fully provisioned, you should use the `--wait` flag. When using this flag, the spo site add command will keep running until it received confirmation from Office 365 that the site has been fully provisioned.
 
 ## Remarks for modern sites
 

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/site/site-groupify.md

@@ -11,12 +11,6 @@ Connects site collection to an Microsoft 365 Group
 m365 spo site groupify [options]
 ```
 
-## Alias
-
-```sh
-m365 spo site groupify
-```
-
 ## Options
 
 `-u, --url <url>`

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

@@ -0,0 +1,57 @@
+# spo web roleassignment add
+
+Adds a role assignment to web permissions.
+
+## Usage
+
+```sh
+m365 spo web roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: upn/email of user to assign role to. Specify either upn or principalId
+
+`--groupName [groupName]`
+: enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
+
+`--roleDefinitionId [roleDefinitionId]`
+: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+
+`--roleDefinitionName [roleDefinitionName]`
+: enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+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 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 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 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

@@ -0,0 +1,54 @@
+# spo web roleassignment remove
+
+Removes a role assignment from web permissions.
+
+## Usage
+
+```sh
+m365 spo web roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: Upn/email of user to assign role to. Specify upn only when principalId or groupName are not used.
+
+`--groupName [groupName]`
+: Enter group name of Azure AD or SharePoint group. Specify groupName only when principalId or upn are not used.
+
+`--confirm [confirm]`
+: Don't prompt for confirming removing the roleassignment.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from web based on group name
+
+```sh
+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 web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2
+```
+
+Remove roleassignment from web based on upn
+
+```sh
+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 web roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2 --confirm
+```

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-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
 
@@ -8,12 +8,6 @@ Adds a specified member in the specified Microsoft Teams private team channel
 m365 teams channel member add [options]
 ```
 
-## Alias
-
-```sh
-m365 teams conversationmember add [options]
-```
-
 ## Options
 
 `-i, --teamId [teamId]`
@@ -23,10 +17,10 @@ m365 teams conversationmember 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.
@@ -41,9 +35,9 @@ m365 teams conversationmember 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-list.md

@@ -8,12 +8,6 @@ Lists members of the specified Microsoft Teams team channel
 m365 teams channel member list [options]
 ```
 
-## Alias
-
-```sh
-m365 teams conversationmember list [options]
-```
-
 ## Options
 
 `-i, --teamId [teamId]`

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
 
@@ -8,12 +8,6 @@ Remove the specified member from the specified Microsoft Teams private team chan
 m365 teams channel member remove [options]
 ```
 
-## Alias
-
-```sh
-m365 teams conversationmember remove [options]
-```
-
 ## Options
 
 `--teamId [teamId]`

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/funsettings/funsettings-set.md

@@ -1,11 +1,11 @@
-# graph teams funsettings set
+# teams funsettings set
 
 Updates fun settings of a Microsoft Teams team
 
 ## Usage
 
 ```sh
-m365 graph teams funsettings set [options]
+m365 teams funsettings set [options]
 ```
 
 ## Options
@@ -32,23 +32,23 @@ m365 graph teams funsettings set [options]
 Allow giphy usage within a given Microsoft Teams team, setting the content rating for giphy to Moderate
 
 ```sh
-m365 graph teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowGiphy true --giphyContentRating Moderate
+m365 teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowGiphy true --giphyContentRating Moderate
 ```
 
 Disable usage of giphy within a given Microsoft Teams team
 
 ```sh
-m365 graph teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowGiphy false
+m365 teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowGiphy false
 ```
 
 Allow usage of stickers and memes within a given Microsoft Teams team
 
 ```sh
-m365 graph teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowStickersAndMemes true
+m365 teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowStickersAndMemes true
 ```
 
 Disable usage custom memes within a given Microsoft Teams team
 
 ```sh
-m365 graph teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowCustomMemes false
+m365 teams funsettings set --teamId 83cece1e-938d-44a1-8b86-918cf6151957 --allowCustomMemes false
 ```

package/docs/docs/cmd/tenant/security/security-alerts-list.md

@@ -27,4 +27,4 @@ Get security alerts for a vendor with name _Azure Sentinel_
 
 ```sh
 m365 tenant security alerts list --vendor "Azure Sentinel"
-```
+```

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.md

@@ -1,4 +1,4 @@
-# tenant service announcement health get
+# tenant serviceannouncement health get
 
 Get the health report of a specified service for a tenant
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.md

@@ -1,4 +1,4 @@
-# tenant service announcement health list
+# tenant serviceannouncement health list
 
 Gets the health report of all subscribed services for a tenant
 

package/docs/docs/cmd/todo/task/task-set.md

@@ -25,18 +25,45 @@ m365 todo task set [options]
 `--listId [listId]`
 : The id of the task list in which the task exists. Specify either `listName` or `listId`, not both
 
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`.
+
+`--dueDateTime [dueDateTime]`
+: The date and time when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --title "Update doco" --listName "My task list"
 ```
 
-Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --status "inProgress" --listName "My task list"
 ```
+
+Update a task with bodyContent and reminder and flag it as important in Microsoft To Do tasks list with a specific name
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Update a task with due date in Microsoft To Do tasks list with list id
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```