@pnp/cli-microsoft365 6.0.0-beta.4d2402f → 6.0.0-beta.4e32416

package/docs/docs/cmd/spo/site/site-groupify.md

@@ -11,15 +11,9 @@ Connects site collection to an Microsoft 365 Group
 m365 spo site groupify [options]
 ```
 
-## Alias
-
-```sh
-m365 spo site groupify
-```
-
 ## Options
 
-`-u, --siteUrl <siteUrl>`
+`-u, --url <url>`
 : URL of the site collection being connected to new Microsoft 365 Group
 
 `-a, --alias <alias>`
@@ -51,25 +45,25 @@ When connecting site collection to an Microsoft 365 Group, SharePoint will creat
 Connect site collection to an Microsoft 365 Group
 
 ```sh
-m365 spo site groupify --siteUrl https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A'
+m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A'
 ```
 
 Connect site collection to an Microsoft 365 Group and make the group public
 
 ```sh
-m365 spo site groupify --siteUrl https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --isPublic
+m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --isPublic
 ```
 
 Connect site collection to an Microsoft 365 Group and set the group classification
 
 ```sh
-m365 spo site groupify --siteUrl https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --classification HBI
+m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --classification HBI
 ```
 
 Connect site collection to an Microsoft 365 Group and keep the old home page
 
 ```sh
-m365 spo site groupify --siteUrl https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --keepOldHomepage
+m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --keepOldHomepage
 ```
 
 ## More information

package/docs/docs/cmd/spo/site/site-list.md

@@ -10,12 +10,18 @@ m365 spo site list [options]
 
 ## Options
 
-`--type [type]`
-: type of modern sites to list. Allowed values `TeamSite,CommunicationSite`, default `TeamSite`
+`-t, --type [type]`
+: convenience option for type of sites to list. Allowed values are `TeamSite,CommunicationSite`.
+
+`--webTemplate [webTemplate]`
+: type of sites to list. To be used with values like `GROUP#0` and `SITEPAGEPUBLISHING#0`. Specify either `type` or `webTemplate`, but not both.  
 
 `-f, --filter [filter]`
 : filter to apply when retrieving sites
 
+`--includeOneDriveSites`
+: use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
+
 `--deleted`
 : use this switch to only return deleted sites
 
@@ -28,34 +34,40 @@ m365 spo site list [options]
 
 Using the `-f, --filter` option you can specify which sites you want to retrieve. For example, to get sites with _project_ in their URL, use `Url -like 'project'` as the filter.
 
-When using the text output type (default), the command lists only the values of the `Title`, and `Url` properties of the site. When setting the output type to JSON, all available properties are included in the command output.
+When using the text output type, the command lists only the values of the `Title`, and `Url` properties of the site. When setting the output type to JSON, all available properties are included in the command output.
 
 ## Examples
 
-List all modern team sites in the currently connected tenant
+List all sites in the currently connected tenant
 
 ```sh
 m365 spo site list
 ```
 
-List all modern team sites in the currently connected tenant
+List all group connected team sites in the currently connected tenant
 
 ```sh
 m365 spo site list --type TeamSite
 ```
 
-List all modern communication sites in the currently connected tenant
+List all communication sites in the currently connected tenant
 
 ```sh
 m365 spo site list --type CommunicationSite
 ```
 
-List all modern team sites that contain _project_ in the URL
+List all group connected team sites that contain _project_ in the URL
 
 ```sh
 m365 spo site list --type TeamSite --filter "Url -like 'project'"
 ```
 
+List all sites in the currently connected tenant including OneDrive sites
+
+```sh
+m365 spo site list --includeOneDriveSites
+```
+
 List all deleted sites in the tenant you're logged in to
 
 ```sh

package/docs/docs/cmd/spo/site/site-rename.md

@@ -10,13 +10,13 @@ m365 spo site rename [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
+`-u, --url <url>`
 : The URL of the site to rename
 
-`--newSiteUrl <newSiteUrl>`
+`--newUrl <newUrl>`
 : New URL for the site collection
 
-`--newSiteTitle [newSiteTitle]`
+`--newTitle [newTitle]`
 : New title for the site
 
 `--suppressMarketplaceAppCheck`
@@ -42,17 +42,17 @@ Renaming site collections is by default asynchronous and depending on the curren
 Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title
 
 ```sh
-m365 spo site rename --siteUrl http://contoso.sharepoint.com/samplesite --newSiteUrl http://contoso.sharepoint.com/renamed
+m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed
 ```
 
 Starts the rename of the site collection with name "samplesite" to "renamed" modifying the title of the site to "New Title"
 
 ```sh
-m365 spo site rename --siteUrl http://contoso.sharepoint.com/samplesite --newSiteUrl http://contoso.sharepoint.com/renamed --newSiteTitle "New Title"
+m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title"
 ```
 
 Renames the specified site collection and waits for the operation to complete
 
 ```sh
-m365 spo site rename --siteUrl http://contoso.sharepoint.com/samplesite --newSiteUrl http://contoso.sharepoint.com/renamed --newSiteTitle "New Title" --wait
+m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title" --wait
 ```

package/docs/docs/cmd/spo/site/site-set.md

@@ -13,6 +13,12 @@ m365 spo site set [options]
 `-u, --url <url>`
 : The URL of the site collection to update
 
+`-t, --title [title]`
+: The new title for the site collection
+
+`-d, --description [description]`
+: The site description
+
 `--classification [classification]`
 : The new classification for the site collection
 
@@ -31,18 +37,36 @@ m365 spo site set [options]
 `--siteDesignId [siteDesignId]`
 : Id of the custom site design to apply to the site
 
-`--title [title]`
-: The new title for the site collection
-
-`--description [description]`
-: The site description
-
 `--sharingCapability [sharingCapability]`
 : The sharing capability for the site. Allowed values:  `Disabled`, `ExternalUserSharingOnly`, `ExternalUserAndGuestSharing`, `ExistingExternalUserSharingOnly`.
 
 `--siteLogoUrl [siteLogoUrl]`
 : Set the logo for the site collection. This can be an absolute or relative URL to a file on the current site collection.
 
+`--resourceQuota [resourceQuota]`
+: The quota for this site collection in Sandboxed Solutions units
+
+`--resourceQuotaWarningLevel [resourceQuotaWarningLevel]`
+: The warning level for the resource quota
+
+`--storageQuota [storageQuota]`
+: The storage quota for this site collection in megabytes
+
+`--storageQuotaWarningLevel [storageQuotaWarningLevel]`
+: The warning level for the storage quota in megabytes
+
+`--allowSelfServiceUpgrade [allowSelfServiceUpgrade]`
+: Set to allow tenant administrators to upgrade the site collection
+
+`--lockState [lockState]`
+: Sets site's lock state. Allowed values `Unlock,NoAdditions,ReadOnly,NoAccess`
+
+`--noScriptSite [noScriptSite]`
+: Specifies if the site allows custom script or not
+
+`--wait`
+: Wait for the settings to be applied before completing the command
+
 --8<-- "docs/cmd/_global.md"
 
 !!! important
@@ -56,6 +80,20 @@ The `isPublic` property can be set only on groupified site collections. If you t
 
 When setting owners, the specified owners will be added to the already configured owners. Existing owners will not be removed.
 
+The value of the `--resourceQuota` option must not exceed the company's aggregate available Sandboxed Solutions quota. For more information, see Resource Usage Limits on Sandboxed Solutions in SharePoint 2010: [http://msdn.microsoft.com/en-us/library/gg615462.aspx](http://msdn.microsoft.com/en-us/library/gg615462.aspx).
+
+The value of the `--resourceQuotaWarningLevel` option must not exceed the value of the `--resourceQuota` option or the current value of the _UserCodeMaximumLevel_ property.
+
+The value of the `--storageQuota` option must not exceed the company's available quota.
+
+The value of the `--storageQuotaWarningLevel` option must not exceed the the value of the `--storageQuota` option or the current value of the _StorageMaximumLevel_ property.
+
+For more information on locking sites see [https://technet.microsoft.com/en-us/library/cc263238.aspx](https://technet.microsoft.com/en-us/library/cc263238.aspx).
+
+For more information on configuring no script sites see [https://support.office.com/en-us/article/Turn-scripting-capabilities-on-or-off-1f2c515f-5d7e-448a-9fd7-835da935584f](https://support.office.com/en-us/article/Turn-scripting-capabilities-on-or-off-1f2c515f-5d7e-448a-9fd7-835da935584f).
+
+Setting site properties is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully configured, you should use the `--wait` flag. When using this flag, the `spo site set` command will keep running until it received confirmation from Microsoft 365 that the site has been fully configured.
+
 ## Examples
 
 Update site collection's classification
@@ -129,3 +167,9 @@ Unset the logo on the site
 ```sh
 m365 spo site set --url https://estruyfdev2.sharepoint.com/sites/sales --siteLogoUrl ""
 ```
+
+Lock the site preventing users from accessing it. Wait for the configuration to complete
+
+```sh
+m365 spo site set --url https://contoso.sharepoint.com/sites/team --LockState NoAccess --wait
+```

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-grant.md

@@ -10,7 +10,7 @@ m365 spo sitedesign rights grant [options]
 
 ## Options
 
-`-i, --id <id>`
+`-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to grant rights on
 
 `-p, --principals <principals>`
@@ -26,19 +26,19 @@ m365 spo sitedesign rights grant [options]
 Grant user with alias _PattiF_ view permission to the specified site design
 
 ```sh
-m365 spo sitedesign rights grant --id 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals PattiF --rights View
+m365 spo sitedesign rights grant --siteDesignId 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals PattiF --rights View
 ```
 
 Grant users with aliases _PattiF_ and _AdeleV_ view permission to the specified site design
 
 ```sh
-m365 spo sitedesign rights grant --id 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals "PattiF,AdeleV" --rights View
+m365 spo sitedesign rights grant --siteDesignId 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals "PattiF,AdeleV" --rights View
 ```
 
 Grant user with email _PattiF@contoso.com_ view permission to the specified site design
 
 ```sh
-m365 spo sitedesign rights grant --id 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals PattiF@contoso.com --rights View
+m365 spo sitedesign rights grant --siteDesignId 9b142c22-037f-4a7f-9017-e9d8c0e34b98 --principals PattiF@contoso.com --rights View
 ```
 
 ## More information

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-list.md

@@ -10,14 +10,14 @@ m365 spo sitedesign rights list [options]
 
 ## Options
 
-`-i, --id <id>`
+`-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to get rights information from
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-If the specified `id` doesn't refer to an existing site script, you will get a `File not found` error.
+If the specified `siteDesignId` doesn't refer to an existing site script, you will get a `File not found` error.
 
 If no permissions are listed, it means that the particular site design is visible to everyone.
 
@@ -26,7 +26,7 @@ If no permissions are listed, it means that the particular site design is visibl
 Get information about rights granted for the site design with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_
 
 ```sh
-m365 spo sitedesign rights list --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
+m365 spo sitedesign rights list --siteDesignId 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
 ```
 
 ## More information

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-revoke.md

@@ -10,7 +10,7 @@ m365 spo sitedesign rights revoke [options]
 
 ## Options
 
-`-i, --id <id>`
+`-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to revoke rights from
 
 `-p, --principals <principals>`
@@ -34,13 +34,13 @@ If you try to revoke access for a user that doesn't have access granted to the s
 Revoke access to the site design with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ from user with alias _PattiF_. Will prompt for confirmation before revoking the access
 
 ```sh
-m365 spo sitedesign rights revoke --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --principals PattiF
+m365 spo sitedesign rights revoke --siteDesignId 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --principals PattiF
 ```
 
 Revoke access to the site design with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ from users with aliases _PattiF_ and _AdeleV_ without prompting for confirmation
 
 ```sh
-m365 spo sitedesign rights revoke --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --principals "PattiF,AdeleV" --confirm
+m365 spo sitedesign rights revoke --siteDesignId 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --principals "PattiF,AdeleV" --confirm
 ```
 
 ## More information

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-get.md

@@ -10,7 +10,7 @@ m365 spo sitedesign task get [options]
 
 ## Options
 
-`-i, --taskId <taskId>`
+`-i, --id <id>`
 : The ID of the site design task to get information for
 
 --8<-- "docs/cmd/_global.md"
@@ -20,7 +20,7 @@ m365 spo sitedesign task get [options]
 Get information about the specified site design scheduled for execution
 
 ```sh
-m365 spo sitedesign task get --taskId 6ec3ca5b-d04b-4381-b169-61378556d76e
+m365 spo sitedesign task get --id 6ec3ca5b-d04b-4381-b169-61378556d76e
 ```
 
 ## More information

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-remove.md

@@ -10,7 +10,7 @@ m365 spo sitedesign task remove [options]
 
 ## Options
 
-`-i, --taskId <taskId>`
+`-i, --id <id>`
 : The ID of the site design task to remove
 
 `--confirm`
@@ -20,16 +20,16 @@ m365 spo sitedesign task remove [options]
 
 ## Examples
 
-Removes the specified site design task with taskId _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution without prompting confirmation
+Removes the specified site design task with id _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution without prompting confirmation
 
 ```sh
-m365 spo sitedesign task remove --taskId 6ec3ca5b-d04b-4381-b169-61378556d76e --confirm
+m365 spo sitedesign task remove --id 6ec3ca5b-d04b-4381-b169-61378556d76e --confirm
 ```
 
-Removes the specified site design task with taskId _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution with prompt for confirmation before removing
+Removes the specified site design task with id _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution with prompt for confirmation before removing
 
 ```sh
-m365 spo sitedesign task remove --taskId 6ec3ca5b-d04b-4381-b169-61378556d76e
+m365 spo sitedesign task remove --id 6ec3ca5b-d04b-4381-b169-61378556d76e
 ```
 
 ## More information

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.md

@@ -10,7 +10,7 @@ m365 spo tenant recyclebinitem remove [options]
 
 ## Options
 
-`-u, --url`
+`-u, --siteUrl <siteUrl>`
 : URL of the site to remove
 
 `--wait`
@@ -33,11 +33,11 @@ Removing a site collection is by default asynchronous and depending on the curre
 Removes the specified deleted site collection from tenant recycle bin
 
 ```sh
-m365 spo tenant recyclebinitem remove --url https://contoso.sharepoint.com/sites/team
+m365 spo tenant recyclebinitem remove --siteUrl https://contoso.sharepoint.com/sites/team
 ```
 
 Removes the specified deleted site collection from tenant recycle bin and wait for the removing process to complete
 
 ```sh
-m365 spo tenant recyclebinitem remove --url https://contoso.sharepoint.com/sites/team --wait
+m365 spo tenant recyclebinitem remove --siteUrl https://contoso.sharepoint.com/sites/team --wait
 ```

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.md

@@ -10,9 +10,12 @@ m365 spo tenant recyclebinitem restore [options]
 
 ## Options
 
-`-u, --url`
+`-u, --siteUrl <siteUrl>`
 : URL of the site to restore
 
+`--wait`
+: Wait for the site collection to be restored before completing the command
+
 --8<-- "docs/cmd/_global.md"
 
 !!! important
@@ -27,11 +30,11 @@ Restoring deleted site collections is by default asynchronous and depending on t
 Restore a deleted site collection from tenant recycle bin
 
 ```sh
-m365 spo tenant recyclebinitem restore --url https://contoso.sharepoint.com/sites/team
+m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team
 ```
 
 Restore a deleted site collection from tenant recycle bin and wait for completion
 
 ```sh
-m365 spo tenant recyclebinitem restore --url https://contoso.sharepoint.com/sites/team --wait
+m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team --wait
 ```

package/docs/docs/cmd/spo/web/web-add.md

@@ -16,7 +16,7 @@ m365 spo web add [options]
 `-d, --description [description]`
 : Subsite description
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : Subsite relative url
 
 `-w, --webTemplate <webTemplate>`
@@ -41,17 +41,17 @@ m365 spo web add [options]
 Create subsite using the _Team site_ template in the _en-US_ locale
 
 ```sh
-m365 spo web add --title Subsite --description Subsite --webUrl subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --locale 1033
+m365 spo web add --title Subsite --description Subsite --url subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --locale 1033
 ```
 
 Create subsite with unique permissions using the default _en-US_ locale
 
 ```sh
-m365 spo web add --title Subsite --webUrl subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --breakInheritance
+m365 spo web add --title Subsite --url subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --breakInheritance
 ```
 
 Create subsite with the same navigation as the parent site
 
 ```sh
-m365 spo web add --title Subsite --webUrl subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --inheritNavigation
+m365 spo web add --title Subsite --url subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --inheritNavigation
 ```

package/docs/docs/cmd/spo/web/web-get.md

@@ -10,7 +10,7 @@ m365 spo web get [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : URL of the site for which to retrieve the information
 
 `--withGroups`
@@ -23,11 +23,11 @@ m365 spo web get [options]
 Retrieve information about the site _https://contoso.sharepoint.com/subsite_
 
 ```sh
-m365 spo web get --webUrl https://contoso.sharepoint.com/subsite
+m365 spo web get --url https://contoso.sharepoint.com/subsite
 ```
 
 Retrieve information about the site _https://contoso.sharepoint.com/subsite_ along with associated groups for the web
 
 ```sh
-m365 spo web get --webUrl https://contoso.sharepoint.com/subsite --withGroups
+m365 spo web get --url https://contoso.sharepoint.com/subsite --withGroups
 ```

package/docs/docs/cmd/spo/web/web-list.md

@@ -10,7 +10,7 @@ m365 spo web list [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : URL of the parent site for which to retrieve the list of subsites
 
 --8<-- "docs/cmd/_global.md"
@@ -20,5 +20,5 @@ m365 spo web list [options]
 Return all subsites from site _https://contoso.sharepoint.com/_
 
 ```sh
-m365 spo web list -u https://contoso.sharepoint.com
+m365 spo web list --url https://contoso.sharepoint.com
 ```

package/docs/docs/cmd/spo/web/web-reindex.md

@@ -10,7 +10,7 @@ m365 spo web reindex [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : URL of the subsite to reindex
 
 --8<-- "docs/cmd/_global.md"
@@ -24,5 +24,5 @@ If the subsite to be reindexed is a no-script site, the command will request rei
 Request reindexing the subsite _https://contoso.sharepoint.com/subsite_
 
 ```sh
-m365 spo web reindex --webUrl https://contoso.sharepoint.com/subsite
+m365 spo web reindex --url https://contoso.sharepoint.com/subsite
 ```

package/docs/docs/cmd/spo/web/web-remove.md

@@ -10,7 +10,7 @@ m365 spo web remove [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : URL of the subsite to remove
 
 `--confirm`
@@ -23,5 +23,5 @@ m365 spo web remove [options]
 Delete subsite without prompting for confirmation
 
 ```sh
-m365 spo web remove --webUrl https://contoso.sharepoint.com/subsite --confirm
+m365 spo web remove --url https://contoso.sharepoint.com/subsite --confirm
 ```

package/docs/docs/cmd/spo/web/web-roleassignment-add.md

@@ -0,0 +1,57 @@
+# spo web roleassignment add
+
+Adds a role assignment to web permissions.
+
+## Usage
+
+```sh
+m365 spo web roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: upn/email of user to assign role to. Specify either upn or principalId
+
+`--groupName [groupName]`
+: enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
+
+`--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
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for upn _someaccount@tenant.onmicrosoft.com_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for group _someGroup_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+add role assignment to site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition name _Full Control_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --principalId 11 --roleDefinitionName "Full Control"
+```

package/docs/docs/cmd/spo/web/web-roleassignment-remove.md

@@ -0,0 +1,54 @@
+# spo web roleassignment remove
+
+Removes a role assignment from web permissions.
+
+## Usage
+
+```sh
+m365 spo web roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: Upn/email of user to assign role to. Specify upn only when principalId or groupName are not used.
+
+`--groupName [groupName]`
+: Enter group name of Azure AD or SharePoint group. Specify groupName only when principalId or upn are not used.
+
+`--confirm [confirm]`
+: Don't prompt for confirming removing the roleassignment.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from web based on group name
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --groupName "saleGroup"
+```
+
+Remove roleassignment from web based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2
+```
+
+Remove roleassignment from web based on upn
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --upn "someaccount@tenant.onmicrosoft.com"
+```
+
+Remove roleassignment from web based on principal Id without prompting for confirmation
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2 --confirm
+```

package/docs/docs/cmd/spo/web/web-roleinheritance-reset.md

@@ -0,0 +1,24 @@
+# spo web roleinheritance reset
+
+Restores role inheritance of subsite.
+
+## Usage
+
+```sh
+m365 spo web roleinheritance reset [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Restore role inheritance of subsite _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo web roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x
+```