# New-OfficePdfImageOptions

Creates discoverable thumbnail and rendering settings for Export-OfficeDocumentImage.

Cmdlet 

**Module**

`PSWriteOffice`

**Inputs**

`None`

**Outputs**

`OfficeIMO.Pdf.PdfImageExportOptions`

**Source**

[NewOfficePdfImageOptionsCommand.cs:17](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Sources/PSWriteOffice/Cmdlets/Pdf/NewOfficePdfImageOptionsCommand.cs#L17) 

Creates discoverable thumbnail and rendering settings for Export-OfficeDocumentImage.

## Syntax

```
New-OfficePdfImageOptions
[-MaximumDegreeOfParallelism <Int32>]
[-MaximumOutputCount <Int32>]
[-MaximumOutputHeight <Int32>]
[-MaximumOutputWidth <Int32>]
[-MaximumRasterPixelCount <Int64>]
[-MaximumTotalEncodedBytes <Int64>]
[-MaximumTotalRasterPixelCount <Int64>]
[-RasterOverflowBehavior <ReduceScale|Throw>]
[-RenderTimeoutSeconds <Double>]
[-TextShapingLanguage <String>]
[-ThumbnailMaxDimension <Int32>]
[<CommonParameters>]
```

[#](#method-new-officepdfimageoptions-int32-int32-int32-int32-int64-int64-int64-officerasteroverflowbehavior-double-string-int32)

Parameter set: `Default`

## Description

Pass the result to Export-OfficeDocumentImage or ConvertTo-OfficeDocumentImage -Options when rendering PDF pages.

## Examples

### Create compact PDF thumbnails with bounded output dimensions.

```powershell
$options = New-OfficePdfImageOptions -ThumbnailMaxDimension 320 -MaximumOutputWidth 640
Export-OfficeDocumentImage -Path .\Report.pdf -OutputDirectory .\Thumbnails -Options $options
```

## Parameters

**-MaximumDegreeOfParallelism Int32 optional**

Maximum independent renders processed concurrently.

**-MaximumOutputCount Int32 optional**

Maximum images accepted from one batch export.

**-MaximumOutputHeight Int32 optional**

Maximum output height in pixels.

**-MaximumOutputWidth Int32 optional**

Maximum output width in pixels.

**-MaximumRasterPixelCount Int64 optional**

Maximum pixels allocated for one raster image.

**-MaximumTotalEncodedBytes Int64 optional**

Maximum aggregate encoded bytes accepted from one batch.

**-MaximumTotalRasterPixelCount Int64 optional**

Maximum aggregate raster pixels accepted from one batch.

**-RasterOverflowBehavior OfficeRasterOverflowBehavior optional**

Reduce or reject oversized raster output.

Possible values: `ReduceScale`, `Throw`

**-RenderTimeoutSeconds Double optional**

Maximum seconds allowed for one render.

**-TextShapingLanguage String optional**

BCP 47 language hint for text shaping.

**-ThumbnailMaxDimension Int32 optional**

Maximum thumbnail width or height.

## 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:2033E751393CE8781FAAC3F7D8449E0C63852756A4B8E389F7A3CF39096AA4F7 -->
