Add-OfficePowerPointTableRow

Namespace PSWriteOffice

Inputs

System.Object

Outputs

OfficeIMO.PowerPoint.PowerPointTableRow

Source

Sources/PSWriteOffice/Cmdlets/PowerPoint/AddOfficePowerPointTableRowCommand.cs:36 Edit on GitHub

Appends or inserts a row in an existing PowerPoint table.

Remarks

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.

PS>


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.

PS>


$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.

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.

Syntax

Add-OfficePowerPointTableRow [-Index <Nullable`1>] -InputObject <Object> [-PassThru] [-TemplateRowIndex <Nullable`1>] [-Value <Object>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Index Nullable`1 optionalposition: namedpipeline: False: 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 optionalposition: namedpipeline: False: Emit the created row for additional OfficeIMO-level edits.
TemplateRowIndex Nullable`1 optionalposition: namedpipeline: False: Optional zero-based template row index to clone. Defaults to the last existing row.
Value Object optionalposition: 1pipeline: Falsealiases: Data, Values: Values to write into the new row. Arrays, dictionaries, and objects are expanded across cells.

Outputs

OfficeIMO.PowerPoint.PowerPointTableRow