Skip to main content
SearchCtrl K
Community

Source code

OfficeIMO.NET libraries, PowerShell module, CLI, Studio and browser tools 700 stars

Talk and help

DiscordQuestions, ideas and show and tell Report an issueBugs and feature requests SponsorFund ongoing development

Mode

Background

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Search the whole siteOpen search page →
Documentation Search all OfficeIMO/
Cmdlet

Add-OfficeWordParagraph

Aliases: WordParagraph
Module
PSWriteOffice
Aliases
WordParagraph
Inputs
OfficeIMO.Word.WordDocument OfficeIMO.Word.WordSection
Outputs
OfficeIMO.Word.WordParagraph
Source
AddOfficeWordParagraphCommand.cs:33 Edit on GitHub

Adds a paragraph to the current section/header/footer context.

Syntax

Add-OfficeWordParagraph
[-Alignment <OfficeAlignment>]
[-Document <WordDocument>]
[-PassThru]
[-Style <WordParagraphStyles>]
[-StyleId <String>]
[[-Text] <String>]
[<CommonParameters>]
#
Parameter set: Text
Add-OfficeWordParagraph
[-Alignment <OfficeAlignment>]
[-Content] <ScriptBlock>
[-Document <WordDocument>]
[-PassThru]
[-Style <WordParagraphStyles>]
[-StyleId <String>]
[<CommonParameters>]
#
Parameter set: Content
Add-OfficeWordParagraph
[-Alignment <OfficeAlignment>]
[-PassThru]
-Section <WordSection>
[-Style <WordParagraphStyles>]
[-StyleId <String>]
[[-Text] <String>]
[<CommonParameters>]
#
Parameter set: SectionText
Add-OfficeWordParagraph
[-Alignment <OfficeAlignment>]
[-Content] <ScriptBlock>
[-PassThru]
-Section <WordSection>
[-Style <WordParagraphStyles>]
[-StyleId <String>]
[<CommonParameters>]
#
Parameter set: SectionContent

Description

Acts as the primary DSL container for inline content such as text runs, bold segments, and images.

Guides & Samples

Authored walkthroughs and practical samples linked to this command.

  • Migrate from PSWriteWord to PSWriteOffice Guide

    Replace archived PSWriteWord scripts with maintained PSWriteOffice Word commands for DOCX creation, editing, review, merge, and conversion.

  • Turn Windows event logs into an investigation handoff Guide

    Collect Windows errors with PSEventViewer, explain the snapshot in a Word and PDF brief, and keep the full messages in an editable Excel register.

  • Compare supplier quotes without retyping an HTML table Guide

    Read supplier offers with PSParseHTML, compare price and delivery, and create an editable Word review, PDF and numeric Excel workbook with PSWriteOffice.

  • Readable document layouts Guide

    Build readable PSWriteOffice reports with paragraph spacing, table-cell padding, consistent colours, clear chart units, and page-aware layouts.

  • Automate Word Documents Guide

    Create, inspect, update, review, merge, protect, and convert DOCX workflows from PowerShell. Includes examples and cmdlet links.

  • Quick Start Guide

    Create your first Word document, Excel workbook, and PowerPoint presentation with OfficeIMO in minutes. Includes examples and API links.

  • Project delivery and milestones Sample

    Turn dated milestones into an editable register and a Word/PDF review with completed counts, overdue work and named recovery actions.

  • Budget and forecast review Sample

    Reconcile annual budget, actual spending and forecast in an editable workbook, then produce a Word/PDF review with owner decisions for overspend exceptions.

  • Patch compliance report from PowerShell Sample

    Review patch compliance and site exceptions with a PowerShell report, including a summary chart, an editable Word document and a PDF.

Examples

Write a formatted sentence.

Add-OfficeWordParagraph { Add-OfficeWordText -Text 'Hello '; Add-OfficeWordText -Text 'World' -Bold }

Outputs “Hello World” with the second word bolded.

Apply a paragraph style by id.

WordParagraph -Text 'Executive summary' -StyleId 'ReportHeading'

Applies a paragraph style id, including custom styles already present in a template document.

Add mixed-format text through explicit objects.

$paragraph = $document | Add-OfficeWordParagraph -PassThru
$paragraph | Add-OfficeWordText 'Owner: ' -Bold
$paragraph | Add-OfficeWordText 'Platform'

Creates a paragraph on a live document and appends two differently formatted runs.

Parameters

-Alignment OfficeAlignment optional
Paragraph justification.
Possible values: Left, Center, Right, Justify, Start, End
-Document WordDocument optionalpipeline: True (ByValue)sets: Text, Content
Live document to receive the paragraph; omitted in a content block.
-PassThru SwitchParameter optional
Emit the WordParagraph for further use.
-Style WordParagraphStyles optional
Paragraph style.
Possible values: Normal, Heading1, Heading2, Heading3, Heading4, Heading5, Heading6, Heading7, Heading8, Heading9, ListParagraph, Custom, Title, Subtitle
-StyleId String optional
Paragraph style id, including custom style ids from a template document.
-Text String optionalposition: 0sets: Text, SectionText
Initial paragraph text; omission creates an empty paragraph.
-Content ScriptBlock requiredposition: 0sets: Content, SectionContent
Nested WordText and inline content.
-Section WordSection requiredpipeline: True (ByValue)sets: SectionText, SectionContent
Section to receive the paragraph.

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.