Project

PSWriteOffice

PowerShell document automation across OfficeIMO's document, spreadsheet, presentation, PDF, Project, Access, EPUB, invoicing, and conversion engines.

Stars 654
Forks 82
Open issues 1
Total downloads 4,320,051
Release OfficeIMO-v3.5.3
Language: C# Updated: 2026-11-03
Cmdlet

Update-OfficePowerPointText

Aliases: Replace-OfficePowerPointText
Module
PSWriteOffice
Aliases
Replace-OfficePowerPointText
Inputs
OfficeIMO.PowerPoint.PowerPointPresentation OfficeIMO.PowerPoint.PowerPointSlide
Outputs
System.Int32

Replaces text in a PowerPoint slide or presentation.

Syntax

Update-OfficePowerPointText
[-IncludeNotes]
[-IncludeTables <Boolean>]
-NewValue <String>
-OldValue <String>
[-PassThru]
[<CommonParameters>]
#
Parameter set: Auto
Update-OfficePowerPointText
[-IncludeNotes]
[-IncludeTables <Boolean>]
-NewValue <String>
-OldValue <String>
[-PassThru]
[-Presentation <PowerPointPresentation>]
[<CommonParameters>]
#
Parameter set: Presentation
Update-OfficePowerPointText
[-IncludeNotes]
[-IncludeTables <Boolean>]
-NewValue <String>
-OldValue <String>
[-PassThru]
[-Slide <PowerPointSlide>]
[<CommonParameters>]
#
Parameter set: Slide

Description

Can replace text in text boxes, tables, and optionally notes using the OfficeIMO text replacement helpers.

Examples

Replace fiscal year text across the whole deck.

$ppt = New-OfficePowerPoint -Path .\Examples\Documents\PowerPointUpdateText.pptx -NoSave
$slide = Add-OfficePowerPointSlide -Presentation $ppt -Layout 1 -PassThru
Add-OfficePowerPointTextBox -Slide $slide -Text 'FY24 summary'
Set-OfficePowerPointNotes -Slide $slide -Text 'Mention FY24 assumptions.'
$count = Update-OfficePowerPointText -Presentation $ppt -OldValue 'FY24' -NewValue 'FY25' -IncludeNotes -PassThru
$ppt | Close-OfficePowerPoint -Save

Replaces matching text throughout the presentation and notes, returning the replacement count.

Parameters

-IncludeNotes SwitchParameter optional
Include notes text in the replacement operation.
-IncludeTables Boolean optional
Include table cells in the replacement operation.
-NewValue String required
Replacement text.
-OldValue String required
Text to find.
-PassThru SwitchParameter optional
Emit the object created or changed by the command.
-Presentation PowerPointPresentation optionalpipeline: True (ByValue)sets: Presentation
Presentation to update.
-Slide PowerPointSlide optionalpipeline: True (ByValue)sets: Slide
Slide to update.

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.