@pnp/cli-microsoft365 7.6.0-beta.c74fe4b → 7.6.0-beta.fc0eacc

package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx

@@ -44,9 +44,9 @@ m365 spfx project github workflow add [options]
 
 The `spfx project github workflow add` will create a workflow .yml file in the `.github/workflows` directory in your project. If such directory does not exist the command will automatically create it.
 
-For the `application` login method the command does not register AAD application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new AAD application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
+For the `application` login method the command does not register a Microsoft Entra application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new Microsoft Entra application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
 
-- `APP_ID` - client id of the registered AAD application
+- `APP_ID` - client id of the registered Microsoft Entra application
 - `CERTIFICATE_ENCODED` - application's encoded certificate
 - `CERTIFICATE_PASSWORD` - certificate password. This applies only if the certificate is encoded which is the recommended approach
 

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

@@ -26,16 +26,16 @@ m365 spo file roleassignment add [options]
 : 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` but not multiple.
 
 `--upn [upn]`
-: upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
+: The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
+: The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` 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/file/file-roleassignment-remove.mdx

@@ -26,10 +26,10 @@ m365 spo file roleassignment remove [options]
 : The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--upn [upn]`
-: Upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
+: The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--groupName [groupName]`
-: The group name of an Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
+: The group name of a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirmation.

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/report/report-activityfilecounts.mdx

@@ -21,6 +21,14 @@ m365 spo report activityfilecounts [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the number of unique, licensed users who interacted with files stored on SharePoint sites for the last week

package/docs/docs/cmd/spo/report/report-activitypages.mdx

@@ -21,6 +21,14 @@ m365 spo report activitypages [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the number of unique pages visited by users for the last week

package/docs/docs/cmd/spo/report/report-activityusercounts.mdx

@@ -25,6 +25,12 @@ m365 spo report activityusercounts [options]
 
 A user is considered active if he or she has executed a file activity (save, sync, modify, or share) or visited a page within the specified time period
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the trend in the number of active users for the last week

package/docs/docs/cmd/spo/report/report-activityuserdetail.mdx

@@ -28,6 +28,12 @@ m365 spo report activityuserdetail [options]
 
 As this report is only available for the past 28 days, date parameter value should be a date from that range.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets details about SharePoint activity by user for the last week

package/docs/docs/cmd/spo/report/report-siteusagedetail.mdx

@@ -28,6 +28,12 @@ m365 spo report siteusagedetail [options]
 
 As this report is only available for the past 28 days, date parameter value should be a date from that range.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets details about SharePoint site usage for the last week

package/docs/docs/cmd/spo/report/report-siteusagefilecounts.mdx

@@ -25,6 +25,12 @@ m365 spo report siteusagefilecounts [options]
 
 A file (user or system) is considered active if it has been saved, synced, modified, or shared within the specified time period.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Get the total number of files across all sites and the number of active files for the last week

package/docs/docs/cmd/spo/report/report-siteusagepages.mdx

@@ -21,6 +21,14 @@ m365 spo report siteusagepages [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the number of pages viewed across all sites for the last week

package/docs/docs/cmd/spo/report/report-siteusagesitecounts.mdx

@@ -25,6 +25,12 @@ m365 spo report siteusagesitecounts [options]
 
 A file (user or system) is considered active if it has been saved, synced, modified, or shared within the specified time period.
 
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the total number of files across all sites and the number of active files for the last week

package/docs/docs/cmd/spo/report/report-siteusagestorage.mdx

@@ -21,6 +21,14 @@ m365 spo report siteusagestorage [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+This command supports only csv and json output.
+
+:::
+
 ## Examples
 
 Gets the trend of storage allocated and consumed during the last week

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