Move-PnPClientSideComponent

Moves a Client-Side Component to a different section/column

Syntax

Move-PnPClientSideComponent
    -Section <Int>
                               -Page <ClientSidePagePipeBind>
                               -InstanceId <GuidPipeBind>
                               [-Position <Int>]
                               [-Web <WebPipeBind>]
                               [-Connection <SPOnlineConnection>]
Move-PnPClientSideComponent
    -Column <Int>
                               -Page <ClientSidePagePipeBind>
                               -InstanceId <GuidPipeBind>
                               [-Position <Int>]
                               [-Web <WebPipeBind>]
                               [-Connection <SPOnlineConnection>]
Move-PnPClientSideComponent
    -Position <Int>
                               -Page <ClientSidePagePipeBind>
                               -InstanceId <GuidPipeBind>
                               [-Web <WebPipeBind>]
                               [-Connection <SPOnlineConnection>]
Move-PnPClientSideComponent
    -Section <Int>
                               -Column <Int>
                               -Page <ClientSidePagePipeBind>
                               -InstanceId <GuidPipeBind>
                               [-Position <Int>]
                               [-Web <WebPipeBind>]
                               [-Connection <SPOnlineConnection>]

Description

Moves a Client-Side Component to a different location on the page. Notice that the sections and or columns need to be present before moving the component.

Examples

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

Move-PnPClientSideComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82 -Section 1

Moves the specified component to the first section of the page.

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

Move-PnPClientSideComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82 -Column 2

Moves the specified component to the second column of the current section.

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

Move-PnPClientSideComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82 -Section 1 -Column 2

Moves the specified component to the first section of the page into the second column.

------------------EXAMPLE 4------------------

Move-PnPClientSideComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82 -Section 1 -Column 2 -Position 2

Moves the specified component to the first section of the page into the second column and sets the column to position 2 in the list of webparts.

Parameters

-Column

The column to move the web part to

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:Int
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-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.

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-InstanceId

The instance id of the control. Use Get-PnPClientSideControl retrieve the instance ids.

Only applicable to: SharePoint Online, SharePoint Server 2019

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

The name of the page

Only applicable to: SharePoint Online, SharePoint Server 2019

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

Change to order of the web part in the column

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:Int
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Section

The section to move the web part to

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:Int
Position:Named
Accept pipeline input:False
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.

Only applicable to: SharePoint Online, SharePoint Server 2019

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