Cmdlet
New-OfficePowerPointPdfOptions
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:
DefaultExamples
Create a three-slide handout.
$options = New-OfficePowerPointPdfOptions -PageLayout Handouts -HandoutSlidesPerPage 3 -IncludeHiddenSlides
Convert-OfficeDocument -Path ./Briefing.pptx -To Pdf -OutputPath ./Briefing.pdf -Options $optionsOmit 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 $optionsParameters
- -AllowDocumentFontEmbedding SwitchParameter
- Allow embedding installed fonts selected by a trusted presentation. System-font embedding must also be enabled.
- -AllowSystemFontEmbedding SwitchParameter
- Allow embedding fonts discovered on the current system.
- -ChartFidelity OfficeChartFidelity
- 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
- Chart layout override.
- -ChartStyle OfficeChartStyle
- Chart visual style override.
- -Font String
- Default font family used when the presentation does not specify one.
- -HandoutSlidesPerPage Int32
- Number of slides on each handout page.
- Include slides marked hidden.
- -MaxGroupShapeDepth Int32
- Maximum nested group-shape depth to render.
- -NoAutoShapes SwitchParameter
- Omit automatic shapes.
- -NoCharts SwitchParameter
- Omit charts.
- -NoPictures SwitchParameter
- Omit pictures.
- -NoSlideBackgrounds SwitchParameter
- Omit slide backgrounds.
- -NoSmartArt SwitchParameter
- Omit SmartArt.
- -NoSpeakerNotes SwitchParameter
- Omit speaker notes.
- -NoTables SwitchParameter
- Omit tables.
- -NoTextBoxes SwitchParameter
- Omit text boxes.
- -PageLayout PowerPointPdfPageLayout
- PDF page layout, such as slides, notes, or handouts.
- Possible values:
Slides,NotesPages,Handouts - -PdfOptions PdfCreateOptions
- Underlying low-level OfficeIMO PDF options.
- -PictureFit OfficeImageFit
- How pictures fit their shape bounds.
- Possible values:
Stretch,Contain,Cover - -WarnOnPictureAspectRatioDistortion SwitchParameter
- 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.