Project

PSWriteOffice

PowerShell document automation across OfficeIMO's document, spreadsheet, presentation, PDF, Project, Access, EPUB, invoicing, and conversion engines.

Stars 654

Forks 82

Open issues 1

Total downloads 4,320,051

Release OfficeIMO-v3.5.3

Language: C# Updated: 2026-11-03

Cmdlet

New-OfficeEmailWriterOptions

Module: PSWriteOffice
Inputs: None
Outputs: OfficeIMO.Email.EmailWriterOptions
Source: NewOfficeEmailWriterOptionsCommand.cs:15 Edit on GitHub

Creates deterministic email writer settings through ordinary PowerShell parameters.

Syntax

New-OfficeEmailWriterOptions
[-Base64LineLength <Int32>]
[-ConversionLossPolicy <Block|Warn|Allow>]
[-IncludeBccHeader]
[-MaxNestedMessageDepth <Int32>]
[-MaxOutputBytes <Int64>]
[-UsePreservedRawSource]
[<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Preserve the original source when possible and block semantic loss.

$options = New-OfficeEmailWriterOptions -UsePreservedRawSource -ConversionLossPolicy Block
$message | Save-OfficeEmail -Path .\Message.eml -Options $options -PassThru

Parameters

-Base64LineLength Int32 optional: Maximum encoded characters on one Base64 body line.
-ConversionLossPolicy EmailConversionLossPolicy optional: Policy applied when the requested format cannot preserve known message semantics.; Possible values: Block, Warn, Allow
-IncludeBccHeader SwitchParameter optional: Write Bcc recipients into the message header.
-MaxNestedMessageDepth Int32 optional: Maximum embedded-message write depth.
-MaxOutputBytes Int64 optional: Maximum serialized artifact size.
-UsePreservedRawSource SwitchParameter optional: Emit an unchanged preserved source instead of regenerating the artifact when possible.

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.