@pnp/cli-microsoft365 8.1.0-beta.3bc5759 → 8.1.0-beta.75a1364

package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx

@@ -14,7 +14,7 @@ m365 spo listitem roleassignment add [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the listitem is located
+: URL of the site where the list item is located
 
 `--listId [listId]`
 : ID of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment add [options]
 : Relative URL of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
 
 `--listItemId <listItemId>`
-: Id of the listitem to assign the role to.
+: Id of the list item to assign the role to.
 
 `--principalId [principalId]`
 : The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName` or `principalId`.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment add [options]
 : The upn/email of user to assign role to. Specify either `upn`, `groupName` or `principalId`.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName` or `principalId`.
+: The group name of the SharePoint group Specify either `upn`, `groupName` or `principalId`.
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -48,37 +48,37 @@ m365 spo listitem roleassignment add [options]
 
 ## Examples
 
-Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
 ```
 
-Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
 ```
 
-Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
 ```
 
-Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.
+Add role assignment to specified list item in specified list located in specified site for specified upn and specified role definition id.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
 ```
 
-Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.
+Add role assignment to specified list item in specified list located in specified site for specified group and specified role definition id.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829
 ```
 
-Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.
+Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition name.
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"

package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx

@@ -14,7 +14,7 @@ m365 spo listitem roleassignment remove [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the listitem is located.
+: URL of the site where the list item is located.
 
 `-i, --listId [listId]`
 : ID of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment remove [options]
 : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `--listItemId <listItemId>`
-: Id of the listitem to remove the role from.
+: Id of the list item to remove the role from.
 
 `--principalId [principalId]`
 : SharePoint ID of principal it may be either user id or group id we want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment remove [options]
 : The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the role assignment.
@@ -45,26 +45,26 @@ m365 spo listitem roleassignment remove [options]
 
 ## Examples
 
-Remove roleassignment from listitem getting list by title based on group name
+Remove roleassignment from list item getting list by title based on group name
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --listItemId 1 --groupName "saleGroup"
 ```
 
-Remove roleassignment from listitem getting list by title based on principal Id
+Remove roleassignment from list item getting list by title based on principal Id
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --listItemId 1 --principalId 2
 ```
 
-Remove roleassignment from listitem getting list by url based on principal Id
+Remove roleassignment from list item getting list by url based on principal Id
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2
 ```
 
 
-Remove roleassignment from listitem getting list by url based on principal Id without prompting for confirmation
+Remove roleassignment from list item getting list by url based on principal Id without prompting for confirmation
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --force

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

@@ -19,7 +19,7 @@ m365 spo site recyclebinitem list [options]
 : URL of the site for which to retrieve the recycle bin items
 
 `--type [type]`
-: Type of items which should be retrieved (listItems, folders, files)
+: Type of items which should be retrieved. Valid values: `listItems`, `folders`, `files`.
 
 `--secondary`
 : Use this switch to retrieve items from secondary recycle bin

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

@@ -23,7 +23,7 @@ m365 spo web roleassignment add [options]
 : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.

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

@@ -23,7 +23,7 @@ m365 spo web roleassignment remove [options]
 : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the roleassignment.

package/docs/docs/cmd/teams/message/message-remove.mdx

@@ -36,7 +36,6 @@ m365 teams message remove [options]
 
 ## Remarks
 
-You can only remove Microsoft Teams messages that you created yourself.  
 
 :::info
 
@@ -44,6 +43,8 @@ This command does only support delegated permissions.
 
 :::
 
+You can only remove Microsoft Teams messages that you created yourself.
+
 ## Examples
 
 Remove a message by using IDs

package/docs/docs/cmd/teams/message/message-restore.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams message restore
+
+Restores a deleted message from a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message restore [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: ID of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--teamName [teamName]`
+:	Name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--channelId [channelId]`
+:	Channel ID of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`--channelName [channelName]`
+:	Channel name of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`-i, --id <id>`
+:	The ID of the Teams message.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command does only support delegated permissions.
+
+:::
+
+You can only restore Microsoft Teams messages that you created yourself.
+
+## Examples
+
+Restore a deleted message by using IDs
+
+```sh
+m365 teams message restore --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2 --id 1540747442203
+```
+
+Restore a deleted message by using display names
+
+```sh
+m365 teams message restore --teamName Marketing --channelName Branding --id 1540747442203
+```
+
+## Response
+
+The command won't return a response on success.