Move-PnPPageComponent

Tip

We encourage you to make improvements to this documentation. Please navigate to https://github.com/pnp/powershell/blob/dev/documentation/Move-PnPPageComponent.md to change this file.

Moves a page component to a different section/column

Syntax

Move-PnPPageComponent
    [-Page] <PagePipeBind>
    -InstanceId <Guid>
    -Section <Int32>
    [-Position <Int32>]
    [-Connection <PnPConnection>]
    [<CommonParameters>]
Move-PnPPageComponent
    [-Page] <PagePipeBind>
    -InstanceId <Guid>
    -Section <Int32>
    -Column <Int32>
    [-Position <Int32>]
    [-Connection <PnPConnection>]
    [<CommonParameters>]
Move-PnPPageComponent
    [-Page] <PagePipeBind>
    -InstanceId <Guid>
    -Column <Int32>
    [-Position <Int32>]
    [-Connection <PnPConnection>]
    [<CommonParameters>]
Move-PnPPageComponent
    [-Page] <PagePipeBind>
    -InstanceId <Guid>
    -Position <Int32>
    [-Connection <PnPConnection>]
    [<CommonParameters>]

Description

Moves a 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-PnPPageComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82 -Section 1

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

EXAMPLE 2

Move-PnPPageComponent -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-PnPPageComponent -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-PnPPageComponent -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

Type:Int32
Position:Named
Default value:None
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.

Type:PnPConnection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InstanceId

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

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Page

The name of the page

Type:PagePipeBind
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Position

Change to order of the web part in the column

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Section

The section to move the web part to

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