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

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file roleassignment remove
 
@@ -43,6 +45,25 @@ m365 spo file roleassignment 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
 
 Remove a role assignment by principal id from a file by id.

package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file roleinheritance break
 
@@ -31,6 +33,25 @@ m365 spo file roleinheritance break [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
 
 Break the inheritance of a file with a specific id (UniqueId).

package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file roleinheritance reset
 
@@ -28,6 +30,25 @@ m365 spo file roleinheritance reset [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
 
 Reset inheritance of file with the specified id (UniqueId) located in the specified site.

package/docs/docs/cmd/spo/file/file-sharinginfo-get.mdx

@@ -27,6 +27,25 @@ m365 spo file sharinginfo 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 file sharing information report for the file with the specified server-relative url located in the specified site.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file version clear
 
@@ -28,6 +30,25 @@ m365 spo file version clear [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
 
 Removes all file version history in a specific site based on fileId and prompts for confirmation.

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

@@ -30,6 +30,25 @@ m365 spo file version 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 file version in a specific site based on fileId.

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

@@ -27,6 +27,25 @@ m365 spo file version 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 file versions of a specific file based on the ID of the file.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file version remove
 
@@ -31,6 +33,25 @@ m365 spo file version remove [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
 
 Removes a file version in a specific site based on fileId and prompts for confirmation.

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/homesite/homesite-add.mdx

@@ -36,6 +36,25 @@ m365 spo homesite 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
 
 Add a home site
@@ -44,13 +63,13 @@ Add a home site
 m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms"
 ```
 
-Add a home site with audiences specified by their groups ids and with additional options
+Add a home site with audiences specified by their group ids and with additional options
 
 ```sh
 m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audienceIds "af8c0bc8-7b1b-44b4-b087-ffcc8df70d16,754ff15c-76b1-44cb-88c7-0065a4d3cfb7" --order 2 
 ```
 
-Add a home site with audiences specified by their groups names and with additional options
+Add a home site with audiences specified by their group names and with additional options
 
 ```sh
 m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audienceNames "Marketing, IT department" --order 2 

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

@@ -21,6 +21,25 @@ m365 spo homesite get [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
 
 Get information about a home site.

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

@@ -16,6 +16,25 @@ m365 spo homesite list [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
 
 List all home sites

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

@@ -1,8 +1,10 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo homesite remove
 
-Removes a Home Site
+Removes a home site
 
 ## Usage
 
@@ -30,15 +32,34 @@ To use this command you must be either **SharePoint Administrator** or **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 a Home site specified by URL.
+Removes a home site specified by URL.
 
 ```sh
 m365 spo homesite remove --url "https://contoso.sharepoint.com/sites/Europe"
 ```
 
-Removes a Home site specified by URL without prompting for confirmation.
+Removes a home site specified by URL without prompting for confirmation.
 
 ```sh
 m365 spo homesite remove --url "https://contoso.sharepoint.com/sites/Europe" --force