# New-OfficePowerPointPdfOptions

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

Cmdlet 

**Module**

`PSWriteOffice`

**Inputs**

`None`

**Outputs**

`OfficeIMO.PowerPoint.Pdf.PowerPointPdfExportOptions`

**Source**

[NewOfficePowerPointPdfOptionsCommand.cs:18](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Sources/PSWriteOffice/Cmdlets/PowerPoint/NewOfficePowerPointPdfOptionsCommand.cs#L18) 

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>]
```

[#](#member-45354d6c2de704de8424a2a0)

Parameter set: `Default`

## Guides & Samples

Authored walkthroughs and practical samples linked to this command.

- [Convert PowerPoint to PDF, HTML, and ODP](/docs/powerpoint/convert/) Guide
  
  Convert PPTX presentations to PDF slides, notes pages or handouts, to HTML, and to ODP with OfficeIMO.PowerPoint.Pdf, PSWriteOffice and the CLI.

## Examples

### Create a three-slide handout.

```powershell
$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.

```powershell
$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](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

<!-- PowerForge markdown artifact sha256:E79BEDD70B2FC740A0C0B19AD86E59183C0083FEE292B0AC027F70ED690B00AD -->
