Project

PSWriteOffice

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

View on GitHub Releases Get package
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-OfficePowerPointPdfOptions

Module
PSWriteOffice
Inputs
None
Outputs
OfficeIMO.PowerPoint.Pdf.PowerPointToPdfOptions
Source
NewOfficePowerPointPdfOptionsCommand.cs:16 Edit on GitHub

Creates discoverable PowerPoint-to-PDF conversion options for Export-OfficeDocumentPdf.

Syntax

New-OfficePowerPointPdfOptions
[-AllowDocumentFontEmbedding]
[-AllowSystemFontEmbedding]
[-ChartLayout <OfficeChartLayout>]
[-ChartStyle <OfficeChartStyle>]
[-FontFamily <String>]
[-HandoutSlidesPerPage <Int32>]
[-IncludeAutoShapes]
[-IncludeCharts]
[-IncludeHiddenSlides]
[-IncludePictures]
[-IncludeSlideBackgrounds]
[-IncludeSmartArt]
[-IncludeSpeakerNotes]
[-IncludeTables]
[-IncludeTextBoxes]
[-MaxGroupShapeDepth <Int32>]
[-PageLayout <Slides|NotesPages|Handouts>]
[-PdfOptions <PdfOptions>]
[-PictureFit <Stretch|Contain|Cover>]
[-WarnOnPictureAspectRatioDistortion]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Examples

Create a handout PDF with notes and hidden slides.

$options = New-OfficePowerPointPdfOptions -PageLayout Handouts -HandoutSlidesPerPage 3 -IncludeSpeakerNotes -IncludeHiddenSlides
Export-OfficeDocumentPdf -InputPath .\Briefing.pptx -Path .\Briefing.pdf -PowerPointOptions $options

Parameters

-AllowDocumentFontEmbedding SwitchParameter optional
Allow embedding installed fonts selected by a trusted presentation. System-font embedding must also be enabled.
-AllowSystemFontEmbedding SwitchParameter optional
Allow embedding fonts discovered on the current system.
-ChartLayout OfficeChartLayout optional
Chart layout override.
-ChartStyle OfficeChartStyle optional
Chart visual style override.
-FontFamily String optional
Default font family used when the presentation does not specify one.
-HandoutSlidesPerPage Int32 optional
Number of slides on each handout page.
-IncludeAutoShapes SwitchParameter optional
Render automatic shapes.
-IncludeCharts SwitchParameter optional
Render charts.
-IncludeHiddenSlides SwitchParameter optional
Include slides marked hidden.
-IncludePictures SwitchParameter optional
Render pictures.
-IncludeSlideBackgrounds SwitchParameter optional
Render slide backgrounds.
-IncludeSmartArt SwitchParameter optional
Render SmartArt.
-IncludeSpeakerNotes SwitchParameter optional
Include speaker notes.
-IncludeTables SwitchParameter optional
Render tables.
-IncludeTextBoxes SwitchParameter optional
Render text boxes.
-MaxGroupShapeDepth Int32 optional
Maximum nested group-shape depth to render.
-PageLayout PowerPointPdfPageLayout optional
PDF page layout, such as slides, notes, or handouts.
Possible values: Slides, NotesPages, Handouts
-PdfOptions PdfOptions optional
Underlying low-level OfficeIMO PDF options.
-PictureFit OfficeImageFit optional
How pictures fit their shape bounds.
Possible values: Stretch, Contain, Cover
-WarnOnPictureAspectRatioDistortion SwitchParameter optional
Report pictures whose requested fit distorts their aspect ratio.

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.