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

Get-OfficeWordTable

Module
PSWriteOffice
Inputs
OfficeIMO.Word.WordDocument OfficeIMO.Word.WordSection
Outputs
OfficeIMO.Word.WordTable

Gets tables from a Word document or section.

Syntax

Get-OfficeWordTable
[-IncludeNested]
[-Path] <String>
[<CommonParameters>]
#
Parameter set: Path
Get-OfficeWordTable
-Document <WordDocument>
[-IncludeNested]
[<CommonParameters>]
#
Parameter set: Document
Get-OfficeWordTable
[-IncludeNested]
-Section <WordSection>
[<CommonParameters>]
#
Parameter set: Section

Examples

Count top-level and nested tables.

$tables = Get-OfficeWordTable -Path .\Report.docx -IncludeNested
[pscustomobject]@{
    Path = '.\Report.docx'
    TableCount = @($tables).Count
}

Reads tables from the document and includes nested tables when validating a composed report.

Parameters

-IncludeNested SwitchParameter optional
Include nested tables.
-Path String requiredposition: 0aliases: FilePath, InputPathsets: Path
Path to the document.
-Document WordDocument requiredpipeline: True (ByValue)sets: Document
Document to inspect.
-Section WordSection requiredpipeline: True (ByValue)sets: Section
Section to enumerate.

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.