Move-PnPPageComponent
SYNOPSIS
Moves a page component to a different section/column
SYNTAX
Move to other section
Move-PnPPageComponent [-Page] <PagePipeBind> -InstanceId <Guid> -Section <Int32>
[-Position <Int32>] [-Connection <PnPConnection>]
Move to other section and column
Move-PnPPageComponent [-Page] <PagePipeBind> -InstanceId <Guid> -Section <Int32>
-Column <Int32> [-Position <Int32>] [-Connection <PnPConnection>]
Move to other column
Move-PnPPageComponent [-Page] <PagePipeBind> -InstanceId <Guid> -Column <Int32>
[-Position <Int32>] [-Connection <PnPConnection>]
Move within a column
Move-PnPPageComponent [-Page] <PagePipeBind> -InstanceId <Guid> -Position <Int32>
[-Connection <PnPConnection>]
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
Parameter Sets: Move to other section and column, Move to other column
Required: True
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
Parameter Sets: (All)
Required: False
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
Parameter Sets: (All)
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Page
The name of the page
Type: PagePipeBind
Parameter Sets: (All)
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Position
Change to order of the web part in the column
Type: Int32
Parameter Sets: Move to other section, Move to other section and column, Move to other column
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Int32
Parameter Sets: Move within a column
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Section
The section to move the web part to
Type: Int32
Parameter Sets: Move to other section, Move to other section and column
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False