Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

API Reference

Cmdlet

Add-OfficeWordParagraph

Aliases: WordParagraph
Namespace PSWriteOffice
Aliases
WordParagraph
Inputs
None

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

Remarks

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

Examples

Authored help example

Write a formatted sentence.

PS>


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.

PS>


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

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

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-OfficeWordParagraph [-Alignment <Left>] [-PassThru] [-Run <Object[]>] [-Style <Normal>] [-StyleId <String>] [-Text <String>] [<CommonParameters>]
#
Parameter set: Text

Parameters

Alignment WordParagraphAlignment optionalposition: namedpipeline: Falsevalues: 12
Paragraph justification.
Possible values: Left, Start, Center, Right, End, Both, MediumKashida, Distribute, NumTab, HighKashida, LowKashida, ThaiDistribute
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the WordParagraph for further use.
Run Object[] optionalposition: namedpipeline: Falsealiases: Runs
Rich text runs. Each run can be created with TextRun/WordTextRun or provided as a hashtable/object.
Style WordParagraphStyles optionalposition: namedpipeline: Falsevalues: 12
Paragraph style.
Possible values: Normal, Heading1, Heading2, Heading3, Heading4, Heading5, Heading6, Heading7, Heading8, Heading9, ListParagraph, Custom
StyleId String optionalposition: namedpipeline: False
Paragraph style id, including custom style ids from a template document.
Text String optionalposition: 0pipeline: False
Optional initial paragraph text.
Add-OfficeWordParagraph [-Alignment <Left>] [-Content <ScriptBlock>] [-PassThru] [-Style <Normal>] [-StyleId <String>] [-Text <String>] [<CommonParameters>]
#
Parameter set: Content

Parameters

Alignment WordParagraphAlignment optionalposition: namedpipeline: Falsevalues: 12
Paragraph justification.
Possible values: Left, Start, Center, Right, End, Both, MediumKashida, Distribute, NumTab, HighKashida, LowKashida, ThaiDistribute
Content ScriptBlock optionalposition: 0pipeline: False
Nested DSL content (runs, lists, images).
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the WordParagraph for further use.
Style WordParagraphStyles optionalposition: namedpipeline: Falsevalues: 12
Paragraph style.
Possible values: Normal, Heading1, Heading2, Heading3, Heading4, Heading5, Heading6, Heading7, Heading8, Heading9, ListParagraph, Custom
StyleId String optionalposition: namedpipeline: False
Paragraph style id, including custom style ids from a template document.
Text String optionalposition: 0pipeline: False
Optional initial paragraph text.