OfficeIMO

API Reference

Command

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

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