Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

New-OfficePowerPointPdfOptions

Module
PSWriteOffice
Inputs
None
Outputs
OfficeIMO.PowerPoint.Pdf.PowerPointPdfExportOptions

Creates native PowerPoint-to-PDF options for Convert-OfficeDocument.

Syntax

New-OfficePowerPointPdfOptions
[-AllowDocumentFontEmbedding]
[-AllowSystemFontEmbedding]
[-ChartFidelity <Strict|BestEffort>]
[-ChartLayout <OfficeChartLayout>]
[-ChartStyle <OfficeChartStyle>]
[-Font <String>]
[-HandoutSlidesPerPage <Int32>]
[-IncludeHiddenSlides]
[-MaxGroupShapeDepth <Int32>]
[-NoAutoShapes]
[-NoCharts]
[-NoPictures]
[-NoSlideBackgrounds]
[-NoSmartArt]
[-NoSpeakerNotes]
[-NoTables]
[-NoTextBoxes]
[-PageLayout <Slides|NotesPages|Handouts>]
[-PdfOptions <PdfCreateOptions>]
[-PictureFit <Stretch|Contain|Cover>]
[-WarnOnPictureAspectRatioDistortion]
[<CommonParameters>]
#
Parameter set: Default

Examples

Create a three-slide handout.

$options = New-OfficePowerPointPdfOptions -PageLayout Handouts -HandoutSlidesPerPage 3 -IncludeHiddenSlides
Convert-OfficeDocument -Path ./Briefing.pptx -To Pdf -OutputPath ./Briefing.pdf -Options $options

Omit charts and SmartArt from a review copy.

$options = New-OfficePowerPointPdfOptions -NoCharts -NoSmartArt -Font Aptos
Convert-OfficeDocument -Path ./Briefing.pptx -To Pdf -OutputPath ./Review.pdf -Options $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.
-ChartFidelity OfficeChartFidelity optional
Chart handling: Strict (default) skips charts with formatting that cannot be drawn exactly; BestEffort draws the closest approximation and reports chart-approximation warnings.
Possible values: Strict, BestEffort
-ChartLayout OfficeChartLayout optional
Chart layout override.
-ChartStyle OfficeChartStyle optional
Chart visual style override.
-Font String optional
Default font family used when the presentation does not specify one.
-HandoutSlidesPerPage Int32 optional
Number of slides on each handout page.
-IncludeHiddenSlides SwitchParameter optional
Include slides marked hidden.
-MaxGroupShapeDepth Int32 optional
Maximum nested group-shape depth to render.
-NoAutoShapes SwitchParameter optional
Omit automatic shapes.
-NoCharts SwitchParameter optional
Omit charts.
-NoPictures SwitchParameter optional
Omit pictures.
-NoSlideBackgrounds SwitchParameter optional
Omit slide backgrounds.
-NoSmartArt SwitchParameter optional
Omit SmartArt.
-NoSpeakerNotes SwitchParameter optional
Omit speaker notes.
-NoTables SwitchParameter optional
Omit tables.
-NoTextBoxes SwitchParameter optional
Omit text boxes.
-PageLayout PowerPointPdfPageLayout optional
PDF page layout, such as slides, notes, or handouts.
Possible values: Slides, NotesPages, Handouts
-PdfOptions PdfCreateOptions 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.