@pnp/cli-microsoft365 11.10.0 → 11.11.0-beta.6c90138

package/docs/docs/cmd/spo/file/file-version-restore.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file version restore
 
@@ -31,6 +33,25 @@ m365 spo file version restore [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Restores a file version in a specific site based on fileId and prompts for confirmation.

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

@@ -27,7 +27,7 @@ m365 spo folder add [options]
 `--color [color]`
 : Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
 
-`--ensureParentFolders [ensureParentFolders]`
+`--ensureParentFolders`
 : Ensure that the parent folder path is available. Any missing folders will be created recursively.
 ```
 
@@ -56,6 +56,25 @@ When you specify a value for `color`, consider the following:
 | Light purple | 14           | lightPurple  |
 | Light pink   | 15           | lightPink    |
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Creates folder in a specific library within the site.

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

@@ -34,7 +34,6 @@ m365 spo folder archive [options]
 
 Folder archival can take some time to complete, as the status might not be reflected immediately.
 
-
 ## Permissions
 
 <Tabs>
@@ -56,13 +55,13 @@ Folder archival can take some time to complete, as the status might not be refle
 
 ## Examples
 
-Archive a folder by id without prompting for confirmation
+Archive a folder by id without prompting for confirmation.
 
 ```sh
 m365 spo folder archive --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7a8c9207-7745-4cda-b0e2-be2618ee3030 --force
 ```
 
-Archive a folder by URL with prompting for confirmation
+Archive a folder by URL with prompting for confirmation.
 
 ```sh
 m365 spo folder archive --webUrl https://contoso.sharepoint.com/sites/Marketing --url '/sites/Marketing/shared documents/folder'

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

@@ -46,6 +46,25 @@ When you specify a value for `nameConflictBehavior`, consider the following:
 - `fail` will throw an error when the destination folder already exists.
 - `rename` will add a suffix (e.g. Folder1) when the destination folder already exists.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Copy a folder a folder to another location using server-relative URLs

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

@@ -36,6 +36,25 @@ If no folder exists at the specified URL, you will get a `Please check the folde
 
 If root level folder is passed, you will get a `Please ensure the specified folder URL or folder Id does not refer to a root folder. Use \'spo list get\' with withPermissions instead' error.` Please use the command 'spo list get'.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get folder properties for a folder with a specific site-relative URL.

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

@@ -33,6 +33,25 @@ m365 spo folder list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets list of folders under a parent folder with site-relative URL.

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

@@ -46,6 +46,25 @@ When you specify a value for `nameConflictBehavior`, consider the following:
 - `fail` will throw an error when the destination folder already exists.
 - `rename` will add a suffix (e.g. folder1) when the destination folder already exists.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Move a folder to a document library in another site collection by server-relative URL.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder remove
 
@@ -32,6 +34,25 @@ m365 spo folder remove [options]
 
 The `spo folder remove` command will remove folder only if it is empty. If the folder contains any files, deleting the folder will fail.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a folder with a specific site-relative URL.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder set
 
@@ -51,6 +53,25 @@ When you specify a value for `color`, consider the following:
 | Light purple | 14           | lightPurple  |
 | Light pink   | 15           | lightPink    |
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Set the folder name to 'My Folder 2'

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

@@ -42,15 +42,34 @@ m365 spo group add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
-Create group with title and description
+Create group with title and description.
 
 ```sh
 m365 spo group add --webUrl https://contoso.sharepoint.com/sites/project-x --name "Project leaders" --description "This group contains all project leaders"
 ```
 
-Create group with membership requests
+Create group with membership requests.
 
 ```sh
 m365 spo group add --webUrl https://contoso.sharepoint.com/sites/project-x --name "Project leaders" --allowRequestToJoinLeave true --requestToJoinLeaveEmailSetting john.doe@contoso.com

package/docs/docs/cmd/spo/group/group-get.mdx

@@ -30,6 +30,25 @@ m365 spo group get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get group with ID for the specified web.

package/docs/docs/cmd/spo/group/group-list.mdx

@@ -24,6 +24,25 @@ m365 spo group list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists all the groups within a specific web.

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

@@ -46,6 +46,27 @@ m365 spo group member add [options]
 
 For the `userIds`, `userNames`, `emails`, `entraGroupIds`, or `entraGroupNames` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | User.Read.All        |
+  | SharePoint      | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | Microsoft Graph | User.Read.All         |
+  | SharePoint      | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a user with the userNames parameter to a SharePoint group with the groupId parameter.

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

@@ -27,6 +27,25 @@ m365 spo group member list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List the members of the group with ID for the specified web.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo group member remove
 
@@ -40,6 +42,27 @@ m365 spo group member remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | User.Read.All        |
+  | SharePoint      | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | Microsoft Graph | User.Read.All         |
+  | SharePoint      | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a user from a SharePoint group based on the id on a given web.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo group remove
 
@@ -28,6 +30,25 @@ m365 spo group remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes group with id from the specified web.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo group set
 
@@ -52,6 +54,27 @@ m365 spo group set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | User.Read.All        |
+  | SharePoint      | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | Microsoft Graph | User.Read.All         |
+  | SharePoint      | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update group title and description.

package/docs/docs/cmd/todo/list/list-add.mdx

@@ -21,6 +21,25 @@ m365 todo list add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a task list with the name _My task list_

package/docs/docs/cmd/todo/list/list-get.mdx

@@ -24,6 +24,25 @@ m365 todo list get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | Tasks.Read  |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Tasks.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a specific Microsoft To Do task list based on id.

package/docs/docs/cmd/todo/list/list-list.mdx

@@ -16,6 +16,25 @@ m365 todo list list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | Tasks.Read  |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Tasks.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get the list of Microsoft To Do task lists

package/docs/docs/cmd/todo/list/list-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # todo list remove
 
@@ -25,6 +27,25 @@ m365 todo list remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a task list with specific name

package/docs/docs/cmd/todo/list/list-set.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # todo list set
 
@@ -25,6 +27,25 @@ m365 todo list set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Rename the list with a specific ID

package/docs/docs/cmd/todo/task/task-add.mdx

@@ -58,6 +58,25 @@ m365 todo task add [options]
 
 When you specify the values for `categories`, each category can correspond to the displayName property of an [outlookCategory](https://learn.microsoft.com/graph/api/resources/outlookcategory?view=graph-rest-1.0). It is permissible to use distinct names.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a task to Microsoft To Do tasks list with with a specific name.