PSWriteOffice

PSWriteOffice is an open-source PowerShell and .NET project with packages, release history, and technical documentation.

Stars 144

Forks 12

Open issues 16

PowerShell Gallery downloads 150,904

Release v0.2.0

Language: C# Updated: 2026-04-06

API Reference

Cmdlet

Find-OfficeWord

Namespace PSWriteOffice

Inputs

OfficeIMO.Word.WordDocument

Outputs

OfficeIMO.Word.WordParagraph
OfficeIMO.Word.WordFind

Source

Sources/PSWriteOffice/Cmdlets/Word/FindOfficeWordCommand.cs:21 Edit on GitHub

Finds text matches inside a Word document.

Remarks

Returns matching paragraphs or a WordFind result when using regex with -AsResult.

Examples

Authored help example

Find text in a document.

PS>


Find-OfficeWord -Path .\Report.docx -Text 'Quarter'

Returns paragraphs that contain the search text.

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

Find-OfficeWord [-CaseSensitive] -InputPath <String> -Text <String> [<CommonParameters>]

Parameter set: PathText

Parameters

CaseSensitive SwitchParameter optionalposition: namedpipeline: False: Use case-sensitive matching.
InputPath String requiredposition: 0pipeline: Falsealiases: FilePath, Path: Path to the .docx file.
Text String requiredposition: 1pipeline: False: Text to find.

Outputs

OfficeIMO.Word.WordParagraph OfficeIMO.Word.WordFind

Find-OfficeWord [-AsResult] [-CaseSensitive] -InputPath <String> -Pattern <String> [<CommonParameters>]

Parameter set: PathRegex

Parameters

AsResult SwitchParameter optionalposition: namedpipeline: False: Emit the full WordFind result for regex searches.
CaseSensitive SwitchParameter optionalposition: namedpipeline: False: Use case-sensitive matching.
InputPath String requiredposition: 0pipeline: Falsealiases: FilePath, Path: Path to the .docx file.
Pattern String requiredposition: 1pipeline: False: Regular expression pattern to find.

Outputs

OfficeIMO.Word.WordParagraph OfficeIMO.Word.WordFind

Find-OfficeWord [-CaseSensitive] -Document <WordDocument> -Text <String> [<CommonParameters>]

Parameter set: DocumentText

Parameters

CaseSensitive SwitchParameter optionalposition: namedpipeline: False: Use case-sensitive matching.
Document WordDocument requiredposition: namedpipeline: True (ByValue): Word document to search.
Text String requiredposition: 1pipeline: False: Text to find.

Outputs

OfficeIMO.Word.WordParagraph OfficeIMO.Word.WordFind

Find-OfficeWord [-AsResult] [-CaseSensitive] -Document <WordDocument> -Pattern <String> [<CommonParameters>]

Parameter set: DocumentRegex

Parameters

AsResult SwitchParameter optionalposition: namedpipeline: False: Emit the full WordFind result for regex searches.
CaseSensitive SwitchParameter optionalposition: namedpipeline: False: Use case-sensitive matching.
Document WordDocument requiredposition: namedpipeline: True (ByValue): Word document to search.
Pattern String requiredposition: 1pipeline: False: Regular expression pattern to find.

Outputs

OfficeIMO.Word.WordParagraph OfficeIMO.Word.WordFind