Cmdlet

Add-OfficePowerPointSection

Aliases: PowerPointSection

Module: PSWriteOffice
Aliases: PowerPointSection
Inputs: OfficeIMO.PowerPoint.PowerPointDocument
Outputs: OfficeIMO.PowerPoint.PowerPointSectionInfo
Source: AddOfficePowerPointSectionCommand.cs:20 Edit on GitHub

Starts a named section at an existing, current or next appended slide.

Syntax

Add-OfficePowerPointSection
[-Document <PowerPointDocument>]
[-Name] <String>
[-PassThru]
[-Slide <PowerPointSlideSelector>]
[<CommonParameters>]

Parameter set: Name

Examples

Group the following slides into a section.

New-OfficePowerPoint -Path ./Results.pptx {
    PowerPointSection 'Results'
    PowerPointSlide -Title 'Revenue' { PowerPointParagraph 'Revenue increased.' }
    PowerPointSlide -Title 'Margin' { PowerPointParagraph 'Margin improved.' }
}

Start an appendix at an existing slide.

Add-OfficePowerPointSection -Document $deck -Name Appendix -Slide 9

Parameters

-Document PowerPointDocument optionalpipeline: True (ByValue): Gets or sets the document; omission uses the enclosing scope or selected native slide's owner.
-Name String requiredposition: 0: Gets or sets the section name.
-PassThru SwitchParameter optional: Gets or sets whether to return section metadata, including its stable native identifier.
-Slide PowerPointSlideSelector optional: Gets or sets a native slide or one-based slide position; omission uses the current or next slide.

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.