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

New-OfficeWordTableCell

Aliases: WordTableCellSpec
Module
PSWriteOffice
Aliases
WordTableCellSpec
Inputs
None
Outputs
PSWriteOffice.Services.Table.OfficeTableCellSpec

Creates a reusable Word table cell definition for explicit table rows.

Syntax

New-OfficeWordTableCell
[-Align <WordParagraphAlignment>]
[-Bold]
[-ColumnSpan <Int32>]
[-FillColor <String>]
[-FontSize <Double>]
[-Italic]
[-RowSpan <Int32>]
[-Run <Object[]>]
[-Strike]
[[-Text] <String>]
[-TextColor <String>]
[-Underline]
[-UnderlineStyle <WordUnderlineStyle>]
[-VerticalAlign <Top|Center|Bottom>]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Examples

Create a full-width Word table section row.

$row = @(New-OfficeWordTableCell -Text 'Identity systems' -ColumnSpan 3)

The returned cell can be passed to WordTable inside explicit row arrays.

Parameters

-Align WordParagraphAlignment optional
Horizontal cell alignment.
Possible values: Left, Start, Center, Right, End, Both, MediumKashida, Distribute, NumTab, HighKashida, LowKashida, ThaiDistribute
-Bold SwitchParameter optional
Render the cell text in bold.
-ColumnSpan Int32 optional
Number of logical columns covered by the cell.
-FillColor String optionalaliases: BackgroundColor, CellFill
Cell fill color. Named colors and hexadecimal colors are accepted.
-FontSize Double optional
Cell font size in points.
-Italic SwitchParameter optional
Render the cell text in italics.
-RowSpan Int32 optional
Number of logical rows covered by the cell.
-Run Object[] optionalaliases: Runs
Rich text runs for the cell. Each run can be created with TextRun/WordTextRun or provided as a hashtable/object.
-Strike SwitchParameter optional
Render the cell text with strikethrough.
-Text String optionalposition: 0
Cell text.
-TextColor String optionalaliases: Color, FontColor
Cell text color. Named colors and hexadecimal colors are accepted.
-Underline SwitchParameter optional
Render the cell text with underline.
-UnderlineStyle WordUnderlineStyle optional
Optional Word underline style.
Possible values: Single, Words, Double, Thick, Dotted, DottedHeavy, Dash, DashedHeavy, DashLong, DashLongHeavy, DotDash, DashDotHeavy, DotDotDash, DashDotDotHeavy, Wave, WavyHeavy, WavyDouble
-VerticalAlign WordTableVerticalAlignment optional
Vertical cell alignment.
Possible values: Top, Center, Bottom

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.

Outputs

PSWriteOffice.Services.Table.OfficeTableCellSpec: Describes a logical table cell that can be rendered by multiple Office table surfaces.