@pnp/cli-microsoft365 7.6.0-beta.443bfd8 → 7.6.0-beta.480812d

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

@@ -23,10 +23,36 @@ m365 spo folder add [options]
 
 `-n, --name <name>`
 : Name of the new folder to be created.
+
+`--color [color]`
+: Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
 ```
 
 <Global />
 
+## Remarks
+
+When you specify a value for `color`, consider the following:
+
+| Color        | Number value | String value |
+|--------------|--------------|--------------|
+| Yellow       | 0            | yellow       |
+| Dark red     | 1            | darkRed      |
+| Dark orange  | 2            | darkOrange   |
+| Dark green   | 3            | darkGreen    |
+| Dark teal    | 4            | darkTeal     |
+| Dark blue    | 5            | darkBlue     |
+| Dark purple  | 6            | darkPurple   |
+| Dark pink    | 7            | darkPink     |
+| Grey         | 8            | grey         |
+| Light red    | 9            | lightRed     |
+| Light orange | 10           | lightOrange  |
+| Light green  | 11           | lightGreen   |
+| Light teal   | 12           | lightTeal    |
+| Light blue   | 13           | lightBlue    |
+| Light purple | 14           | lightPurple  |
+| Light pink   | 15           | lightPink    |
+
 ## Examples
 
 Creates folder in a specific library within the site.
@@ -41,6 +67,18 @@ Creates folder in a specific folder within the site.
 m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'
 ```
 
+Create a folder with a dark blue look
+
+```sh
+m365 spo folder add --webUrl https://contoso.sharepoint.com --parentFolder '/ProjectFiles' --name 'Project-x' --color 5
+```
+
+Create a folder with a light teal look
+
+```sh
+m365 spo folder add --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
+```
+
 ## Response
 
 <Tabs>

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

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

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

@@ -26,7 +26,7 @@ m365 spo folder roleassignment remove [options]
 : The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
 
 `--groupName [groupName]`
-: The Azure AD or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
+: The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirmation when removing the role assignment.

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

@@ -0,0 +1,88 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo folder set
+
+Updates a folder
+
+## Usage
+
+```sh
+m365 spo folder set [options]
+```
+
+## Alias
+
+```sh
+m365 spo folder rename [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--url <url>`
+: The server- or site-relative decoded URL of the folder.
+
+`-n, --name [name]`
+: New name for the folder.
+
+`--color [color]`
+: Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
+```
+
+<Global />
+
+## Remarks
+
+When you specify a value for `color`, consider the following:
+
+| Color        | Number value | String value |
+|--------------|--------------|--------------|
+| Yellow       | 0            | yellow       |
+| Dark red     | 1            | darkRed      |
+| Dark orange  | 2            | darkOrange   |
+| Dark green   | 3            | darkGreen    |
+| Dark teal    | 4            | darkTeal     |
+| Dark blue    | 5            | darkBlue     |
+| Dark purple  | 6            | darkPurple   |
+| Dark pink    | 7            | darkPink     |
+| Grey         | 8            | grey         |
+| Light red    | 9            | lightRed     |
+| Light orange | 10           | lightOrange  |
+| Light green  | 11           | lightGreen   |
+| Light teal   | 12           | lightTeal    |
+| Light blue   | 13           | lightBlue    |
+| Light purple | 14           | lightPurple  |
+| Light pink   | 15           | lightPink    |
+
+## Examples
+
+Set the folder name to 'My Folder 2'
+
+```sh
+m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
+```
+
+Set the folder name to 'My folder 2'
+
+```sh
+m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder 1' --name 'My Folder 2'
+```
+
+Set the folder color to dark blue
+
+```sh
+m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color 5
+```
+
+Set the folder color to light teal
+
+```sh
+m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/group/group-member-add.mdx

@@ -37,13 +37,13 @@ m365 spo group member add [options]
 : The object Id of the Entra group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
 
 `--aadGroupIds [aadGroupIds]`
-: (deprecated. Use `entraGroupIds` instead) The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
+: (deprecated. Use `entraGroupIds` instead) The object ID of the Microsoft Entra group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
 
 `--entraGroupNames [entraGroupNames]`
 : The name of the Entra group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
 
 `--aadGroupNames [aadGroupNames]`
-: (deprecated. Use `entraGroupNames` instead) The name of the Azure AD group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
+: (deprecated. Use `entraGroupNames` instead) The name of the Microsoft Entra group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
 ```
 
 <Global />

package/docs/docs/cmd/spo/group/group-member-remove.mdx

@@ -35,13 +35,13 @@ m365 spo group member remove [options]
 : The object Id of the Entra group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
 
 `--aadGroupId [aadGroupId]`
-: (deprecated. Use `entraGroupId` instead) The object Id of the Azure AD group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
+: (deprecated. Use `entraGroupId` instead) The object ID of the Microsoft Entra group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
 
 `--entraGroupName [entraGroupName]`
 : The name of the Entra group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
 
 `--aadGroupName [aadGroupName]`
-: (deprecated. Use `entraGroupName` instead) The name of the Azure AD group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
+: (deprecated. Use `entraGroupName` instead) The name of the Microsoft Entra group to remove as a member. Specify either `userName`, `email`, `userId`, `aadGroupId`, `entraGroupId`, `aadGroupName`, or `entraGroupName`.
 ```
 
 <Global />
@@ -69,7 +69,7 @@ m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA
 Remove an Entra group from a SharePoint group based on the Entra group name on a given web.
 
 ```sh
-m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --entraGroupName "Azure AD Security Group"
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --entraGroupName "Microsoft Entra ID Security Group"
 ```
 
 Remove an Entra group from a SharePoint group based on the Entra group ID on a given web.

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

@@ -29,16 +29,16 @@ m365 spo list roleassignment add [options]
 : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: Upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: Enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of Microsoft Entra or 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.
 
 `--roleDefinitionName [roleDefinitionName]`
-: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
+: The name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 ```
 
 <Global />

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

@@ -29,10 +29,10 @@ m365 spo list roleassignment remove [options]
 : SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the role assignment.

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

@@ -17,31 +17,31 @@ m365 spo listitem roleassignment add [options]
 : URL of the site where the listitem is located
 
 `--listId [listId]`
-: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
 
 `--listTitle [listTitle]`
-: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
 
 `--listUrl [listUrl]`
-: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+: 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.
 
 `--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.
+: 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`.
 
 `--upn [upn]`
-: upn/email of user to assign role to. Specify either upn, groupName or principalId.
+: The upn/email of user to assign role to. Specify either `upn`, `groupName` or `principalId`.
 
 `--groupName [groupName]`
-: The group name of Azure AD or SharePoint group. Specify either upn, groupName or principalId.
+: The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName` or `principalId`.
 
 `--roleDefinitionId [roleDefinitionId]`
-: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+: 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
+: The name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 ```
 
 <Global />

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

@@ -32,10 +32,10 @@ m365 spo listitem roleassignment remove [options]
 : 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.
 
 `--upn [upn]`
-: upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the role assignment.

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

@@ -22,10 +22,10 @@ m365 spo site apppermission add [options]
 : Permission to site (`read`, `write`, `manage` or `fullcontrol`)
 
 `-i, --appId [appId]`
-: Client ID of the Azure AD app for which to grant permissions
+: Client ID of the Microsoft Entra app for which to grant permissions
 
 `-n, --appDisplayName [appDisplayName]`
-: Display name of the Azure AD app for which to grant permissions
+: Display name of the Microsoft Entra app for which to grant permissions
 ```
 
 <Global />

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

@@ -22,10 +22,10 @@ m365 spo site apppermission set [options]
 : ID of the permission to update. Specify `id`, `appId` or `appDisplayName`
 
 `--appId [appId]`
-: Client ID of the Azure AD app for which to update permissions. Specify `id`, `appId` or `appDisplayName`
+: Client ID of the Microsoft Entra app for which to update permissions. Specify `id`, `appId` or `appDisplayName`
 
 `-n, --appDisplayName [appDisplayName]`
-: Display name of the Azure AD app for which to update permissions. Specify `id`, `appId` or `appDisplayName`
+: Display name of the Microsoft Entra app for which to update permissions. Specify `id`, `appId` or `appDisplayName`
 
 `-p, --permission <permission>`
 : Permission to site (`read`, `write`, `manage` or `fullcontrol`)

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

@@ -14,20 +14,44 @@ m365 spo site recyclebinitem restore [options]
 
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
-: URL of the site for which to restore the recycle bin items
+: URL of the site.
 
-`-i, --ids <ids>`
-: List of ids of items which will be restored from the site recycle bin
+`-i, --ids [ids]`
+: List of ids of items which will be restored from the site recycle bin. Specify `ids` or `allPrimary` and/or `allSecondary`.
+
+`--allPrimary`
+: Restore all items from the first-stage recycle bin. Specify `ids` or `allPrimary` and/or `allSecondary`.
+
+`--allSecondary`
+: Restore all items from the second-stage recycle bin. Specify `ids` or `allPrimary` and/or `allSecondary`.
 ```
 
 <Global />
 
 ## Examples
 
-Restore specific items by given ids from recycle bin for site _https://contoso.sharepoint.com/site_
+Restore specific items by given ids from recycle bin of given site.
+
+```sh
+m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/project --ids "ae6f97a7-280e-48d6-b481-0ea986c323da,aadbf916-1f71-42ee-abf2-8ee4802ae291"
+```
+
+Restore all items from the first-stage recycle bin of a given site.
+
+```sh
+m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/project --allPrimary
+```
+
+Restore all items from the second-stage recycle bin of a given site.
+
+```sh
+m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com --allSecondary
+```
+
+Restore all items from both the first-stage and second-stage recycle bins of a given site.
 
 ```sh
-m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com/site --ids "ae6f97a7-280e-48d6-b481-0ea986c323da,aadbf916-1f71-42ee-abf2-8ee4802ae291"
+m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com --allPrimary --allSecondary
 ```
 
 ## Response