Project

PSWriteOffice

PowerShell document automation across Word, Excel, PowerPoint, PDF, Reader, Confluence, Visio, and open text formats.

View on GitHub Releases Get package
Stars 165
Forks 15
PowerShell Gallery downloads 158,661
Release v3.0.8
Language: C# Updated: 2026-10-12

API Reference

Cmdlet

New-OfficePowerPointImageOptions

Namespace PSWriteOffice
Inputs
None
Outputs
OfficeIMO.PowerPoint.PowerPointPresentationImageExportOptions
Source
NewOfficePowerPointImageOptionsCommand.cs:16 Edit on GitHub

Creates discoverable slide selection and rendering settings for Export-OfficePowerPointImage.

Remarks

Creates discoverable slide selection and rendering settings for Export-OfficePowerPointImage.

Examples

Authored help example

Render selected slides with their backgrounds and content.

PS>


$options = New-OfficePowerPointImageOptions -SlideNumber 1,3 -IncludeSlideBackground -IncludeSlideContent
            Export-OfficePowerPointImage -Path .\Deck.pptx -OutputPath .\Slides -Options $options

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

New-OfficePowerPointImageOptions [-BackgroundColor <String>] [-IncludeAutoShapes] [-IncludeCharts] [-IncludeHiddenShapes] [-IncludeHiddenSlides] [-IncludePictures] [-IncludeSlideBackground] [-IncludeSlideContent] [-IncludeTables] [-IncludeTextBoxes] [-MaximumDegreeOfParallelism <Int32>] [-MaximumOutputCount <Int32>] [-MaximumOutputHeight <Int32>] [-MaximumOutputWidth <Int32>] [-MaximumRasterPixels <Int64>] [-MaximumTotalEncodedBytes <Int64>] [-MaximumTotalRasterPixels <Int64>] [-RasterOverflowBehavior <ReduceScale|Throw>] [-RenderTimeoutSeconds <Double>] [-Scale <Double>] [-SlideNumber <Int32[]>] [-TargetDpi <Double>] [-TextShapingLanguage <String>] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Parameters

BackgroundColor String optionalposition: namedpipeline: False
Background color name or hex value.
IncludeAutoShapes SwitchParameter optionalposition: namedpipeline: False
Render auto shapes.
IncludeCharts SwitchParameter optionalposition: namedpipeline: False
Render charts.
IncludeHiddenShapes SwitchParameter optionalposition: namedpipeline: False
Render hidden shapes.
IncludeHiddenSlides SwitchParameter optionalposition: namedpipeline: False
Include hidden slides.
IncludePictures SwitchParameter optionalposition: namedpipeline: False
Render pictures.
IncludeSlideBackground SwitchParameter optionalposition: namedpipeline: False
Render slide backgrounds.
IncludeSlideContent SwitchParameter optionalposition: namedpipeline: False
Render slide content.
IncludeTables SwitchParameter optionalposition: namedpipeline: False
Render tables.
IncludeTextBoxes SwitchParameter optionalposition: namedpipeline: False
Render text boxes.
MaximumDegreeOfParallelism Int32 optionalposition: namedpipeline: False
Maximum independent renders processed concurrently.
MaximumOutputCount Int32 optionalposition: namedpipeline: False
Maximum images accepted from one batch export.
MaximumOutputHeight Int32 optionalposition: namedpipeline: False
Maximum output height in pixels.
MaximumOutputWidth Int32 optionalposition: namedpipeline: False
Maximum output width in pixels.
MaximumRasterPixels Int64 optionalposition: namedpipeline: False
Maximum pixels allocated for one raster image.
MaximumTotalEncodedBytes Int64 optionalposition: namedpipeline: False
Maximum aggregate encoded bytes accepted from one batch.
MaximumTotalRasterPixels Int64 optionalposition: namedpipeline: False
Maximum aggregate raster pixels accepted from one batch.
RasterOverflowBehavior OfficeRasterOverflowBehavior optionalposition: namedpipeline: Falsevalues: 2
Reduce or reject oversized raster output.
Possible values: ReduceScale, Throw
RenderTimeoutSeconds Double optionalposition: namedpipeline: False
Maximum seconds allowed for one render.
Scale Double optionalposition: namedpipeline: False
Output scale multiplier.
SlideNumber Int32[] optionalposition: namedpipeline: False
One-based slide numbers to export.
TargetDpi Double optionalposition: namedpipeline: False
Target output density in dots per inch.
TextShapingLanguage String optionalposition: namedpipeline: False
BCP 47 language hint for text shaping.

Outputs

OfficeIMO.PowerPoint.PowerPointPresentationImageExportOptions