Project

PSWriteOffice

PowerShell document automation across Word, Excel, PowerPoint, PDF, Reader, Confluence, Visio, and open text formats.

View on GitHub Releases Get package
Stars 159
Forks 14
PowerShell Gallery downloads 158,661
Release v3.0.5
Language: C# Updated: 2026-09-03

API Reference

Cmdlet

Set-OfficePowerPointShapeLayout

Aliases: PptArrange, PptShapeLayout
Namespace PSWriteOffice
Aliases
PptArrange PptShapeLayout
Inputs
System.Object
Outputs
OfficeIMO.PowerPoint.PowerPointShape
Source
Sources/PSWriteOffice/Cmdlets/PowerPoint/SetOfficePowerPointShapeLayoutCommand.cs:22 Edit on GitHub

Aligns, distributes, or arranges PowerPoint shapes using OfficeIMO layout helpers.

Remarks

Aligns, distributes, or arranges PowerPoint shapes using OfficeIMO layout helpers.

Examples

Authored help example

Align found shapes.

PS>


Find-OfficePowerPointShape -Slide $slide -Name 'Kpi.*' |
                Set-OfficePowerPointShapeLayout -Align Top

Uses OfficeIMO.PowerPoint to align all matching shapes to the top edge of their selection bounds.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Set-OfficePowerPointShapeLayout -Align <Left> -InputObject <Object> [-MarginPoints <Double>] [-PassThru] [-Slide <PowerPointSlide>] [-ToSlide] [<CommonParameters>]
#
Parameter set: Align

Parameters

Align PowerPointShapeAlignment requiredposition: namedpipeline: Falsevalues: 6
Alignment operation.
Possible values: Left, Center, Right, Top, Middle, Bottom
InputObject Object requiredposition: 0pipeline: True (ByValue)
PowerPoint shapes or shape info records from Get-OfficePowerPointShape or Find-OfficePowerPointShape.
MarginPoints Double optionalposition: namedpipeline: False
Use slide content bounds with the supplied margin in points.
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the arranged shapes.
Slide PowerPointSlide optionalposition: namedpipeline: False
Slide that owns raw PowerPointShape inputs. Shape info records carry their own slide.
ToSlide SwitchParameter optionalposition: namedpipeline: False
Use the full slide bounds instead of the current selection bounds.

Outputs

OfficeIMO.PowerPoint.PowerPointShape

Set-OfficePowerPointShapeLayout [-Center] [-CrossAxisAlign <Left>] -Distribute <Horizontal|Vertical> -InputObject <Object> [-MarginPoints <Double>] [-PassThru] [-Slide <PowerPointSlide>] [-SpacingPoints <Double>] [-ToSlide] [<CommonParameters>]
#
Parameter set: Distribute

Parameters

Center SwitchParameter optionalposition: namedpipeline: False
Center a fixed-spacing distribution within its bounds.
CrossAxisAlign PowerPointShapeAlignment optionalposition: namedpipeline: Falsevalues: 6
Optional cross-axis alignment for even distribution.
Possible values: Left, Center, Right, Top, Middle, Bottom
Distribute PowerPointShapeDistribution requiredposition: namedpipeline: Falsevalues: 2
Distribution operation.
Possible values: Horizontal, Vertical
InputObject Object requiredposition: 0pipeline: True (ByValue)
PowerPoint shapes or shape info records from Get-OfficePowerPointShape or Find-OfficePowerPointShape.
MarginPoints Double optionalposition: namedpipeline: False
Use slide content bounds with the supplied margin in points.
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the arranged shapes.
Slide PowerPointSlide optionalposition: namedpipeline: False
Slide that owns raw PowerPointShape inputs. Shape info records carry their own slide.
SpacingPoints Double optionalposition: namedpipeline: False
Fixed spacing between distributed shapes in points.
ToSlide SwitchParameter optionalposition: namedpipeline: False
Use the full slide bounds instead of the current selection bounds.

Outputs

OfficeIMO.PowerPoint.PowerPointShape

Set-OfficePowerPointShapeLayout [-AutoGrid] [-Columns <Int32>] [-Flow <RowMajor|ColumnMajor>] -Grid [-GutterXPoints <Double>] [-GutterYPoints <Double>] -InputObject <Object> [-MarginPoints <Double>] [-NoResize] [-PassThru] [-Rows <Int32>] [-Slide <PowerPointSlide>] [-ToSlide] [<CommonParameters>]
#
Parameter set: Grid

Parameters

AutoGrid SwitchParameter optionalposition: namedpipeline: False
Let OfficeIMO choose the grid dimensions.
Columns Int32 optionalposition: namedpipeline: False
Grid column count. Omit with AutoGrid.
Flow PowerPointShapeGridFlow optionalposition: namedpipeline: Falsevalues: 2
Fill the grid column-by-column instead of row-by-row.
Possible values: RowMajor, ColumnMajor
Grid SwitchParameter requiredposition: namedpipeline: False
Arrange shapes in a grid.
GutterXPoints Double optionalposition: namedpipeline: False
Horizontal grid gutter in points.
GutterYPoints Double optionalposition: namedpipeline: False
Vertical grid gutter in points.
InputObject Object requiredposition: 0pipeline: True (ByValue)
PowerPoint shapes or shape info records from Get-OfficePowerPointShape or Find-OfficePowerPointShape.
MarginPoints Double optionalposition: namedpipeline: False
Use slide content bounds with the supplied margin in points.
NoResize SwitchParameter optionalposition: namedpipeline: False
Keep each shape's current size when arranging in a grid.
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the arranged shapes.
Rows Int32 optionalposition: namedpipeline: False
Grid row count. Omit with AutoGrid.
Slide PowerPointSlide optionalposition: namedpipeline: False
Slide that owns raw PowerPointShape inputs. Shape info records carry their own slide.
ToSlide SwitchParameter optionalposition: namedpipeline: False
Use the full slide bounds instead of the current selection bounds.

Outputs

OfficeIMO.PowerPoint.PowerPointShape