Cmdlet

Set-OfficePowerPointTableCell

Module PSWriteOffice

Inputs

System.Object

Outputs

OfficeIMO.PowerPoint.PowerPointTableCell

Source

SetOfficePowerPointTableCellCommand.cs:31 Edit on GitHub

Sets text in an existing PowerPoint table cell.

Syntax

Set-OfficePowerPointTableCell -Column <Int32> [-InputObject] <Object> [-PassThru] -Row <Int32> -Text <String> [<CommonParameters>]

Parameter set: Text

Set-OfficePowerPointTableCell -Column <Int32> [-InputObject] <Object> [-PassThru] -Row <Int32> -Run <Object[]> [<CommonParameters>]

Parameter set: Run

Description

Accepts a PowerPointTable or a PowerPointShapeInfo record whose shape is a table. Row and column coordinates are zero-based, matching the OfficeIMO PowerPoint table API. Use this after Find-OfficePowerPointShape -Kind Table when a script needs to update a specific cell inside a deck that already exists.

Examples

Authored help example

Update a cell in a found table.

Find-OfficePowerPointShape -Presentation $ppt -Text 'Metric' -Kind Table |
                Set-OfficePowerPointTableCell -Row 1 -Column 1 -Text 'Ready'

Accepts a PowerPoint table or table shape metadata and updates a zero-based table cell.

Update a state cell after locating a readiness table.

$table = Find-OfficePowerPointShape -Presentation $ppt -Text 'Risk' -Kind Table | Select-Object -First 1
$table | Set-OfficePowerPointTableCell -Row 1 -Column 1 -Text 'Mitigating'

Uses the table found by text content and updates the second row, second column.

Parameters

-Column Int32 required: Zero-based column index.
-InputObject Object requiredposition: 0pipeline: True (ByValue): PowerPoint table or table shape info returned by Find-OfficePowerPointShape or Get-OfficePowerPointShape.
-PassThru SwitchParameter optional: Emit the updated table cell for additional OfficeIMO-level edits.
-Row Int32 required: Zero-based row index.
-Text String requiredsets: Text: Replacement cell text. A null value clears the cell.
-Run Object[] requiredaliases: Runssets: Run: Replacement rich text runs. Each run can be created with TextRun/PowerPointTextRun or provided as a hashtable/object.

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.