Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

Rename-OfficePowerPointSection

Module
PSWriteOffice
Inputs
OfficeIMO.PowerPoint.PowerPointDocument
Outputs
OfficeIMO.PowerPoint.PowerPointSectionInfo

Renames the first section matching the supplied name.

Syntax

Rename-OfficePowerPointSection
[-CaseSensitive]
[-Document <PowerPointDocument>]
[-Name] <String>
[-NewName] <String>
[-PassThru]
[<CommonParameters>]
#
Parameter set: Document

Examples

Rename a section in a live deck.

Rename-OfficePowerPointSection -Document $deck -Name Results -NewName 'Deep dive'

Return the renamed section.

$section = Rename-OfficePowerPointSection -Document $deck -Name Appendix -NewName Reference -PassThru

Parameters

-CaseSensitive SwitchParameter optional
Gets or sets whether name matching is case-sensitive.
-Document PowerPointDocument optionalpipeline: True (ByValue)
Gets or sets the live document; omission uses its enclosing content block.
-Name String requiredposition: 0
Gets or sets the existing section name.
-NewName String requiredposition: 1
Gets or sets the new section name.
-PassThru SwitchParameter optional
Gets or sets whether the changed section is returned.

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.