Cmdlet
Add-OfficePowerPointShape
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:
ShapeExamples
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
- Gets or sets the one-based theme grid column; explicit X overrides its position.
- -FillColor OfficeColor
- Gets or sets the fill color or theme role; explicit null clears the local override.
- -Height OfficeLength
- Gets or sets the height; omission uses the native default.
- -Name String
- Gets or sets the native shape name.
- -OutlineColor OfficeColor
- Gets or sets the outline color or theme role; explicit null clears the local override.
- -OutlineWidth OfficeLength
- Gets or sets the outline thickness; numbers mean points.
- -PassThru SwitchParameter
- Gets or sets whether the live native shape is returned.
- -Slide PowerPointSlideSelector
- Gets or sets a native slide or one-based position; omission uses the current slide block.
- -Span Int32
- Gets or sets the number of grid columns; the default is twelve, and explicit Width overrides it.
- -Type OfficePresetShapeType
- 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
- Gets or sets the width; omission uses the native default.
- -X OfficeLength
- Gets or sets the left coordinate; numbers mean points.
- -Y OfficeLength
- 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.