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

Export-OfficeExcelRangeImage

Module
PSWriteOffice
Inputs
OfficeIMO.Excel.ExcelDocument
Outputs
OfficeIMO.Drawing.OfficeImageExportResult
Source
ExportOfficeExcelRangeImageCommand.cs:16 Edit on GitHub

Exports one worksheet range as an image file.

Syntax

Export-OfficeExcelRangeImage
[-Force]
[-Format <OfficeImageExportFormat>]
[-Options <ExcelImageExportOptions>]
[[-OutputPath] <String>]
[-PassThru]
[-Path] <String>
-Range <String>
-WorksheetName <String>
[<CommonParameters>]
#
Parameter set: Path
Export-OfficeExcelRangeImage
-Document <ExcelDocument>
[-Force]
[-Format <OfficeImageExportFormat>]
[-Options <ExcelImageExportOptions>]
[[-OutputPath] <String>]
[-PassThru]
-Range <String>
-WorksheetName <String>
[<CommonParameters>]
#
Parameter set: Document

Examples

Export a report range for use in an email.

Export-OfficeExcelRangeImage -Path .\Report.xlsx -WorksheetName Summary -Range A1:H20 -OutputPath .\summary.png

Parameters

-Force SwitchParameter optional
Replace an existing destination file.
-Format OfficeImageExportFormat optional
Output image format.
Possible values: Png, Svg, Jpeg, Tiff, Webp, Bmp, Pbm, Tga, Icon
-Options ExcelImageExportOptions optional
Optional rendering, size, font, and diagnostic policy settings.
-OutputPath String optionalposition: 1
Optional destination image file. When omitted, returns the in-memory image result only.
-PassThru SwitchParameter optional
Emit the structured image export result when a destination path is used.
-Path String requiredposition: 0sets: Path
Path to the workbook.
-Range String required
A1 range address to export.
-WorksheetName String required
Name of the worksheet containing the range.
-Document ExcelDocument requiredpipeline: True (ByValue)sets: Document
Open workbook instance.

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.