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

package/docs/docs/cmd/spfx/project/project-azuredevops-pipeline-add.mdx

@@ -0,0 +1,87 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spfx project azuredevops pipeline add
+
+Adds a Azure DevOps Pipeline for a SharePoint Framework project
+
+## Usage
+
+```sh
+m365 spfx project azuredevops pipeline add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name [name]`
+: Name of the pipeline run that will be created. If none is specified a default name generated by Azure DevOps will be used
+
+`-b, --branchName [branchName]`
+: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
+
+`-l, --loginMethod [loginMethod]`
+: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`
+
+`-s, --scope [scope]`
+: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
+
+`-u, --siteUrl [siteUrl]`
+: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
+
+`--skipFeatureDeployment`
+: When specified the app will be added to all sites. When deployed to the site app catalog it will be added to all sub-sites of that site.
+```
+
+<Global />
+
+## Remarks
+
+The `spfx project azuredevops pipeline add` will create a workflow .yml file in the `.azuredevops/pipelines` directory in your project. If such directory does not exist the command will automatically create it.
+
+The command will not create the Azure DevOps pipeline. You will need to manually create it in Azure DevOps. The command will only create the workflow file which you can then push to your repo and create a new yaml pipline based on it.
+
+For the `application` login method the command does not register an Entra application nor does it create the required certificate. In order to proceed, obtain (create) a self-signed certificate and register a new Entra application with certificate authentication. After that you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
+
+- `CertificateBase64Encoded` - base 64 encoded certificate. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
+- `CertificateSecureFileId` - id of a certificate file in the secure files section of the DevOps library. `.pfx` file. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
+- `CertificatePassword` - certificate password. This applies only if the certificate is encoded which is the recommended approach
+- `EntraAppId` - client id of the registered Entra application
+
+This use case is perfect in a production context as it does not create any dependencies on an account
+
+For the `user` login method you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
+
+- `UserName` - user email
+- `Password` - password
+
+This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
+
+:::info
+
+Run this command in the SPFx solution folder.
+
+:::
+    
+## Examples
+
+Adds an Azure DevOps Pipeline for a SharePoint Framework project triggered on push to main
+
+```sh
+m365 spfx project azuredevops pipeline add
+```
+
+Adds an Azure DevOps Pipeline for a SharePoint Framework project with `user` login method triggered on push to main
+
+```sh
+m365 spfx project azuredevops pipeline add --loginMethod "user"
+```
+
+Adds an Azure DevOps Pipeline for a SharePoint Framework project with deployment to a site collection app catalog
+
+```sh
+m365 spfx project azuredevops pipeline add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
+```
+
+## Response
+
+The command won't return a response on success.

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