Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

Add-OfficePowerPointSlide

Aliases: PowerPointSlide
Module
PSWriteOffice
Aliases
PowerPointSlide
Inputs
OfficeIMO.PowerPoint.PowerPointDocument
Outputs
OfficeIMO.PowerPoint.PowerPointSlide

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: Content

Examples

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 optional
Gets or sets the background color for this slide and its continuations, including theme roles.
-BackgroundImage String optional
Gets or sets a literal local background image path for this slide and its continuations.
-Content ScriptBlock optionalposition: 0
Gets or sets the slide's typed content block.
-Document PowerPointDocument optionalpipeline: True (ByValue)
Gets or sets an explicit live document; omission uses the enclosing content block.
-Eyebrow String optional
Gets or sets the small label above the title.
-Layout PowerPointLayout optional
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 optional
Gets or sets the caption of the coverage panel.
-Master Int32 optional
Gets or sets a one-based master position for a template layout; defaults to the first.
-NoFooter SwitchParameter optional
Gets or sets whether this slide omits its footer.
-NoSlideNumber SwitchParameter optional
Gets or sets whether this slide omits its slide number.
-PassThru SwitchParameter optional
Gets or sets whether the created physical slides are returned.
-Seed String optional
Gets or sets a deterministic design seed for this slide.
-Subtitle String optional
Gets or sets the subtitle.
-TemplateLayout PowerPointLayoutSelector optional
Gets or sets a specific template layout by name, one-based position, native type or returned metadata.
-Title String optional
Gets or sets the slide title.
-Transition PowerPointSlideTransition optional
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.