Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

Add-OfficePowerPointShape

Aliases: PowerPointShape
Module
PSWriteOffice
Aliases
PowerPointShape
Inputs
PSWriteOffice.Foundation.PowerPointSlideSelector
Outputs
OfficeIMO.PowerPoint.PowerPointAutoShape

Adds a native preset shape at physical coordinates or on the theme grid.

Syntax

Add-OfficePowerPointShape
[-Column <Int32>]
[-FillColor <OfficeColor>]
[-Height <OfficeLength>]
[-Name <String>]
[-OutlineColor <OfficeColor>]
[-OutlineWidth <OfficeLength>]
[-PassThru]
[-Slide <PowerPointSlideSelector>]
[-Span <Int32>]
[-Type <OfficePresetShapeType>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]
#
Parameter set: Shape

Examples

Draw a named status light.

PowerPointSlide -Title 'Service health' {
    PowerPointShape -Type Ellipse -Name 'Healthy' -FillColor Success -X 2cm -Y 4cm -Width 2cm -Height 2cm
}

Parameters

-Column Int32 optional
Gets or sets the one-based theme grid column; explicit X overrides its position.
-FillColor OfficeColor optional
Gets or sets the fill color or theme role; explicit null clears the local override.
-Height OfficeLength optional
Gets or sets the height; omission uses the native default.
-Name String optional
Gets or sets the native shape name.
-OutlineColor OfficeColor optional
Gets or sets the outline color or theme role; explicit null clears the local override.
-OutlineWidth OfficeLength optional
Gets or sets the outline thickness; numbers mean points.
-PassThru SwitchParameter optional
Gets or sets whether the live native shape is returned.
-Slide PowerPointSlideSelector optionalpipeline: True (ByValue)
Gets or sets a native slide or one-based position; omission uses the current slide block.
-Span Int32 optional
Gets or sets the number of grid columns; the default is twelve, and explicit Width overrides it.
-Type OfficePresetShapeType optional
Gets or sets the native preset geometry.
Possible values: Line, LineInverse, Triangle, RightTriangle, Rectangle, Diamond, Parallelogram, Trapezoid, NonIsoscelesTrapezoid, Pentagon, Hexagon, Heptagon, Octagon, Decagon, Dodecagon, Star4, Star5, Star6, Star7, Star8, Star10, Star12, Star16, Star24, Star32, RoundRectangle, Round1Rectangle, Round2SameRectangle, Round2DiagonalRectangle, SnipRoundRectangle, Snip1Rectangle, Snip2SameRectangle, Snip2DiagonalRectangle, Plaque, Ellipse, Teardrop, HomePlate, Chevron, PieWedge, Pie, BlockArc, Donut, NoSmoking, RightArrow, LeftArrow, UpArrow, DownArrow, StripedRightArrow, NotchedRightArrow, BentUpArrow, LeftRightArrow, UpDownArrow, LeftUpArrow, LeftRightUpArrow, QuadArrow, LeftArrowCallout, RightArrowCallout, UpArrowCallout, DownArrowCallout, LeftRightArrowCallout, UpDownArrowCallout, QuadArrowCallout, BentArrow, UTurnArrow, CircularArrow, LeftCircularArrow, LeftRightCircularArrow, CurvedRightArrow, CurvedLeftArrow, CurvedUpArrow, CurvedDownArrow, SwooshArrow, Cube, Can, LightningBolt, Heart, Sun, Moon, SmileyFace, IrregularSeal1, IrregularSeal2, FoldedCorner, Bevel, Frame, HalfFrame, Corner, DiagonalStripe, Chord, Arc, LeftBracket, RightBracket, LeftBrace, RightBrace, BracketPair, BracePair, StraightConnector1, BentConnector2, BentConnector3, BentConnector4, BentConnector5, CurvedConnector2, CurvedConnector3, CurvedConnector4, CurvedConnector5, Callout1, Callout2, Callout3, AccentCallout1, AccentCallout2, AccentCallout3, BorderCallout1, BorderCallout2, BorderCallout3, AccentBorderCallout1, AccentBorderCallout2, AccentBorderCallout3, WedgeRectangleCallout, WedgeRoundRectangleCallout, WedgeEllipseCallout, CloudCallout, Cloud, Ribbon, Ribbon2, EllipseRibbon, EllipseRibbon2, LeftRightRibbon, VerticalScroll, HorizontalScroll, Wave, DoubleWave, Plus, FlowChartProcess, FlowChartDecision, FlowChartInputOutput, FlowChartPredefinedProcess, FlowChartInternalStorage, FlowChartDocument, FlowChartMultidocument, FlowChartTerminator, FlowChartPreparation, FlowChartManualInput, FlowChartManualOperation, FlowChartConnector, FlowChartPunchedCard, FlowChartPunchedTape, FlowChartSummingJunction, FlowChartOr, FlowChartCollate, FlowChartSort, FlowChartExtract, FlowChartMerge, FlowChartOfflineStorage, FlowChartOnlineStorage, FlowChartMagneticTape, FlowChartMagneticDisk, FlowChartMagneticDrum, FlowChartDisplay, FlowChartDelay, FlowChartAlternateProcess, FlowChartOffpageConnector, ActionButtonBlank, ActionButtonHome, ActionButtonHelp, ActionButtonInformation, ActionButtonForwardNext, ActionButtonBackPrevious, ActionButtonEnd, ActionButtonBeginning, ActionButtonReturn, ActionButtonDocument, ActionButtonSound, ActionButtonMovie, Gear6, Gear9, Funnel, MathPlus, MathMinus, MathMultiply, MathDivide, MathEqual, MathNotEqual, CornerTabs, SquareTabs, PlaqueTabs, ChartX, ChartStar, ChartPlus
-Width OfficeLength optional
Gets or sets the width; omission uses the native default.
-X OfficeLength optional
Gets or sets the left coordinate; numbers mean points.
-Y OfficeLength optional
Gets or sets the top coordinate; numbers mean points.

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.