Cmdlet
Add-OfficePowerPointSlide
Adds a designed slide, choosing its layout from typed content unless Layout is supplied.
Syntax
Add-OfficePowerPointSlide
[-Background <OfficeColor>]
[-BackgroundImage <String>]
[[-Content] <ScriptBlock>]
[-Document <PowerPointDocument>]
[-Eyebrow <String>]
[-Layout <PowerPointLayout>]
[-MapLabel <String>]
[-Master <Int32>]
[-NoFooter]
[-NoSlideNumber]
[-PassThru]
[-Seed <String>]
[-Subtitle <String>]
[-TemplateLayout <PowerPointLayoutSelector>]
[-Title <String>]
[-Transition <PowerPointSlideTransition>]
[<CommonParameters>]#Parameter set:
ContentExamples
Create a service review.
New-OfficePowerPoint -Path .\Review.pptx {
PowerPointSlide -Title 'Service review' -Subtitle 'October 2026'
PowerPointSlide -Title 'Signals' { PowerPointCard 'Availability' -Text 'All regions healthy' }
}Parameters
- -Background OfficeColor
- Gets or sets the background color for this slide and its continuations, including theme roles.
- -BackgroundImage String
- Gets or sets a literal local background image path for this slide and its continuations.
- -Content ScriptBlock
- Gets or sets the slide's typed content block.
- -Document PowerPointDocument
- Gets or sets an explicit live document; omission uses the enclosing content block.
- -Eyebrow String
- Gets or sets the small label above the title.
- -Layout PowerPointLayout
- Gets or sets a designed layout; omission selects it from content.
- Possible values:
Auto,Title,Section,TitleAndContent,TwoContent,Comparison,Kpi,Cards,Process,Quote,ImageFull,Closing,CaseStudy,Logos,Coverage - -MapLabel String
- Gets or sets the caption of the coverage panel.
- -Master Int32
- Gets or sets a one-based master position for a template layout; defaults to the first.
- Gets or sets whether this slide omits its footer.
- -NoSlideNumber SwitchParameter
- Gets or sets whether this slide omits its slide number.
- -PassThru SwitchParameter
- Gets or sets whether the created physical slides are returned.
- -Seed String
- Gets or sets a deterministic design seed for this slide.
- -Subtitle String
- Gets or sets the subtitle.
- -TemplateLayout PowerPointLayoutSelector
- Gets or sets a specific template layout by name, one-based position, native type or returned metadata.
- -Title String
- Gets or sets the slide title.
- -Transition PowerPointSlideTransition
- Gets or sets the transition for this slide and its continuations.
- Possible values:
Fade,Wipe,BlindsVertical,BlindsHorizontal,CombHorizontal,CombVertical,PushUp,PushDown,PushLeft,PushRight,Cut,Flash,WarpIn,WarpOut,Prism,FerrisLeft,FerrisRight,Morph,Random,CheckerHorizontal,CheckerVertical,CoverLeft,CoverUp,CoverRight,CoverDown,CoverLeftUp,CoverRightUp,CoverLeftDown,CoverRightDown,Dissolve,FadeThroughBlack,UncoverLeft,UncoverUp,UncoverRight,UncoverDown,UncoverLeftUp,UncoverRightUp,UncoverLeftDown,UncoverRightDown,RandomBarsHorizontal,RandomBarsVertical,StripsLeftUp,StripsRightUp,StripsLeftDown,StripsRightDown,WipeUp,WipeRight,WipeDown,BoxOut,BoxIn,SplitHorizontalOut,SplitHorizontalIn,SplitVerticalOut,SplitVerticalIn,Diamond,Plus,Wedge,Newsflash,WheelOneSpoke,WheelTwoSpokes,WheelThreeSpokes,WheelFourSpokes,WheelEightSpokes,Circle,CutThroughBlack
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.