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

Add-OfficePowerPointImage

Aliases: PptImage
Module
PSWriteOffice
Aliases
PptImage
Inputs
OfficeIMO.PowerPoint.PowerPointSlide
Outputs
OfficeIMO.PowerPoint.PowerPointPicture
Source
AddOfficePowerPointImageCommand.cs:24 Edit on GitHub

Adds an image to a PowerPoint slide.

Syntax

Add-OfficePowerPointImage
[-Height <Double>]
[-PassThru]
[-Path] <String>
[-Slide <PowerPointSlide>]
[-Width <Double>]
[-X <Double>]
[-Y <Double>]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Description

Places the picture at the requested coordinates using point measurements.

Examples

Insert an image.

$image = '.\Tests\Assets\CellImage.png'
New-OfficePowerPoint -Path .\Examples\Documents\PowerPointImage.pptx {
    $slide = Add-OfficePowerPointSlide -Layout 1 -PassThru
    Set-OfficePowerPointSlideTitle -Slide $slide -Title 'Evidence'
    Add-OfficePowerPointImage -Slide $slide -Path $image -X 60 -Y 130 -Width 180 -Height 120
}

Adds a picture to a generated slide.

Parameters

-Height Double optional
Image height in points.
-PassThru SwitchParameter optional
Emit the object created or changed by the command.
-Path String requiredposition: 0
Path to the image file.
-Slide PowerPointSlide optionalpipeline: True (ByValue)
Target slide that will receive the picture (optional inside DSL).
-Width Double optional
Image width in points.
-X Double optional
Left offset (in points) from the slide origin.
-Y Double optional
Top offset (in points) from the slide origin.

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.