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

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.