@pnp/cli-microsoft365 11.10.0 → 11.11.0-beta.1cb40cb

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/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.

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

@@ -27,6 +27,25 @@ m365 todo task 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
 
 Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id.

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

@@ -24,6 +24,25 @@ m365 todo task 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
 
 List tasks from Microsoft To Do tasks list with the name _My task list_

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # todo task remove
 
@@ -28,6 +30,25 @@ m365 todo task 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
 
 Removes Microsoft To Do task with the specified id in a list with the specified name

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

@@ -61,6 +61,25 @@ m365 todo task set [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
 
 Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with a specific name.