Rename-OfficePowerPointSection

Namespace PSWriteOffice

Inputs

OfficeIMO.PowerPoint.PowerPointPresentation

Outputs

OfficeIMO.PowerPoint.PowerPointSectionInfo System.Boolean

Source

Sources/PSWriteOffice/Cmdlets/PowerPoint/RenameOfficePowerPointSectionCommand.cs:21 Edit on GitHub

Renames a PowerPoint section.

Remarks

Renames a PowerPoint section.

Examples

Authored help example

Example 1: Rename a section in a presentation.

PS>


$ppt = New-OfficePowerPoint -FilePath .\Examples\Documents\PowerPointRenameSection.pptx
            Add-OfficePowerPointSlide -Presentation $ppt -Layout 1 | Out-Null
            Add-OfficePowerPointSection -Presentation $ppt -Name 'Results' -StartSlideIndex 0 | Out-Null
            Rename-OfficePowerPointSection -Presentation $ppt -Name 'Results' -NewName 'Deep Dive' -PassThru

Renames the first matching section and returns the updated section metadata.

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.

Syntax

Rename-OfficePowerPointSection [-CaseSensitive] -Name <String> -NewName <String> [-PassThru] [-Presentation <PowerPointPresentation>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

CaseSensitive SwitchParameter optionalposition: namedpipeline: False: Use case-sensitive matching for the existing section name.
Name String requiredposition: namedpipeline: False: Existing section name.
NewName String requiredposition: namedpipeline: False: New section name.
PassThru SwitchParameter optionalposition: namedpipeline: False: Emit the renamed section instead of no output.
Presentation PowerPointPresentation optionalposition: namedpipeline: True (ByValue): Presentation to update (optional inside DSL).

Outputs

OfficeIMO.PowerPoint.PowerPointSectionInfo, System.Boolean