Invoke-PnPSiteDesign

Apply a Site Design to an existing site. Requires Tenant Administration Rights

Syntax

Invoke-PnPSiteDesign
      -Identity <TenantSiteDesignPipeBind>
                          [-WebUrl <String>]
                          [-Web <WebPipeBind>]
                          [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Invoke-PnPSiteDesign -Identity 5c73382d-9643-4aa0-9160-d0cba35e40fd

Applies the specified site design to the current site.

------------------EXAMPLE 2------------------

Invoke-PnPSiteDesign -Identity 5c73382d-9643-4aa0-9160-d0cba35e40fd -WebUrl https://contoso.sharepoint.com/sites/mydemosite

Applies the specified site design to the specified site.

------------------EXAMPLE 3------------------

Get-PnPSiteDesign | ?{$_.Title -eq "Demo"} | Invoke-PnPSiteDesign

Applies the specified site design to the specified site.

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:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Identity

The Site Design Id or an actual Site Design object to apply

Type:TenantSiteDesignPipeBind
Position:0
Accept pipeline input:True
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-WebUrl

The URL of the web to apply the site design to. If not specified it will default to the current web based upon the URL specified with Connect-PnPOnline.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False