spo sitedesign rights revoke¶
Revokes access from a site design for one or more principals
spo sitedesign rights revoke [options]
||output usage information|
||The ID of the site design to revoke rights from|
||Comma-separated list of principals to revoke view rights from. Principals can be users or mail-enabled security groups in the form of
||Don't prompt for confirming removing the site design|
||Runs command with verbose logging|
||Runs command with debug logging|
Before using this command, log in to a SharePoint Online site, using the spo login command.
To revoke access to a site design, you have to first log in to a SharePoint site using the spo login command, eg.
spo login https://contoso.sharepoint.com.
If the specified id doesn't refer to an existing site design, you will get a
File not found error.
If all principals have rights revoked on the site design, the site design becomes viewable to everyone.
If you try to revoke access for a user that doesn't have access granted to the specified site design you will get a
The specified user or domain group was not found error.
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
spo sitedesign rights revoke --id 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
spo sitedesign rights revoke --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --principals PattiF,AdeleV --confirm
- SharePoint site design and site script overview: https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview