Revoke-PnPSiteDesignRights.md

Module Name	title	schema	applicable	external help file	online version
PnP.PowerShell	Revoke-PnPSiteDesignRights	2.0.0	SharePoint Online	PnP.PowerShell.dll-Help.xml	https://pnp.github.io/powershell/cmdlets/Revoke-PnPSiteDesignRights.html

Revoke-PnPSiteDesignRights

SYNOPSIS

Required Permissions

• SharePoint: Access to the SharePoint Tenant Administration site

Revokes the specified principals rights to use the site design.

SYNTAX

Revoke-PnPSiteDesignRights [-Identity] <TenantSiteDesignPipeBind> -Principals <String[]> [-Connection <PnPConnection>] 

DESCRIPTION

Revokes the rights to use the site design for the specified users.

EXAMPLES

EXAMPLE 1

Revoke-PnPSiteDesignRights -Identity 5c73382d-9643-4aa0-9160-d0cba35e40fd -Principals "myuser@mydomain.com","myotheruser@mydomain.com"

Revokes rights of the specified principals on the specified site design.

EXAMPLE 2

Get-PnPSiteDesign -Identity 5c73382d-9643-4aa0-9160-d0cba35e40fd | Revoke-PnPSiteDesignRights -Principals "myuser@mydomain.com","myotheruser@mydomain.com"

Revokes rights of the specified principals on the specified site design.

PARAMETERS

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: PnPConnection
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

The site design to use.

Type: TenantSiteDesignPipeBind
Parameter Sets: (All)

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Principals

One or more principals to revoke.

Type: String[]
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

RELATED LINKS

Microsoft 365 Patterns and Practices