Cmdlet

Add-OfficePowerPointTableRow

Module PSWriteOffice

Inputs

System.Object

Outputs

OfficeIMO.PowerPoint.PowerPointTableRow

Source

AddOfficePowerPointTableRowCommand.cs:38 Edit on GitHub

Appends or inserts a row in an existing PowerPoint table.

Syntax

Add-OfficePowerPointTableRow [-Index <Int32>] [-InputObject] <Object> [-PassThru] [-TemplateRowIndex <Int32>] [[-Value] <Object>] [<CommonParameters>]

Parameter set: All Parameter Sets

Description

Accepts a PowerPointTable or a PowerPointShapeInfo record whose shape is a table. Values can be scalars, arrays, dictionaries, or PowerShell objects; arrays and object properties are expanded across table cells. The new row is cloned from an existing template row so table formatting, borders, and style choices are preserved.

Examples

Authored help example

Find a table and append a row.

Find-OfficePowerPointShape -Presentation $ppt -Text 'Metric' -Kind Table |
                Add-OfficePowerPointTableRow -Values 'Latency', 'Ready'

Accepts a PowerPoint table or table shape metadata and writes the supplied values into the new row.

Insert a row above the first data row using a template row.

$shape = Find-OfficePowerPointShape -Presentation $ppt -Text 'Metric' -Kind Table | Select-Object -First 1
$shape | Add-OfficePowerPointTableRow -Index 1 -TemplateRowIndex 1 -Values ([ordered]@{
    Metric = 'Documentation'
    State  = 'Ready'
})

Resolves the table from shape metadata, inserts a formatted row at index 1, and maps values across cells.

Parameters

-Index Int32 optional: Optional zero-based index where the row should be inserted. Defaults to appending at the end.
-InputObject Object requiredposition: 0pipeline: True (ByValue): PowerPoint table or table shape info returned by Find-OfficePowerPointShape or Get-OfficePowerPointShape.
-PassThru SwitchParameter optional: Emit the created row for additional OfficeIMO-level edits.
-TemplateRowIndex Int32 optional: Optional zero-based template row index to clone. Defaults to the last existing row.
-Value Object optionalposition: 1aliases: Data, Values: Values to write into the new row. Arrays, dictionaries, and objects are expanded across cells.

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.