Evotec

Project

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

Invoke-OfficeWordMailMerge

Namespace PSWriteOffice
Inputs
OfficeIMO.Word.WordDocument
Outputs
OfficeIMO.Word.WordDocument

Executes a simple mail merge against MERGEFIELD values in a Word document.

Remarks

Executes a simple mail merge against MERGEFIELD values in a Word document.

Examples

Authored help example

Replace merge fields from a hashtable.

PS>


Invoke-OfficeWordMailMerge -Data @{ FirstName = 'John'; OrderId = 12345 }
        

Updates MERGEFIELD values in the active Word 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

Invoke-OfficeWordMailMerge -Data <Object> [-Document <WordDocument>] [-PassThru] [-PreserveFields] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Parameters

Data Object requiredposition: 0pipeline: Falsealiases: Values
Hashtable or object whose properties map to MERGEFIELD names.
Document WordDocument optionalposition: namedpipeline: True (ByValue)
Document to update when provided explicitly.
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the updated document.
PreserveFields SwitchParameter optionalposition: namedpipeline: False
Preserve field codes and only update displayed field text.

Outputs

OfficeIMO.Word.WordDocument