Set-PnPClientSideWebPart

Set Client-Side Web Part properties

Syntax

Set-PnPClientSideWebPart
   -Page <ClientSidePagePipeBind>
                           -Identity <ClientSideWebPartPipeBind>
                           [-Title <String>]
                           [-PropertiesJson <String>]
                           [-Web <WebPipeBind>]
                           [-Connection <SPOnlineConnection>]

Description

Sets specific client side webpart properties. Notice that the title parameter will only set the -internal- title of webpart. The title which is shown in the UI will, if possible, have to be set using the PropertiesJson parameter. Use Get-PnPClientSideComponent to retrieve the instance id and properties of a webpart.

Examples

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

Set-PnPClientSideWebPart -Page Home -Identity a2875399-d6ff-43a0-96da-be6ae5875f82 -PropertiesJson $myproperties

Sets the properties of the client side webpart given in the $myproperties variable.

Required Parameters

-Identity

The identity of the webpart. This can be the webpart instance id or the title of a webpart

Type:ClientSideWebPartPipeBind
Position:Named
Accept pipeline input:True
Accept wildcard characters:False
-Page

The name of the page

Type:ClientSidePagePipeBind
Position:0
Accept pipeline input:True
Accept wildcard characters:False

Optional 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
-PropertiesJson

Sets the properties as a JSON string.

Type:String
Position:Named
Accept pipeline input:True
Accept wildcard characters:False
-Title

Sets the internal title of the webpart. Notice that this will NOT set a visible title.

Type:String
Position:Named
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