Evotec

Project

PSWriteOffice

PSWriteOffice is an open-source PowerShell and .NET project with packages, release history, and technical documentation.

View on GitHub Releases Get package
Stars 144
Forks 12
Open issues 16
PowerShell Gallery downloads 150,904
Release v0.2.0
Language: C# Updated: 2026-04-06

API Reference

Cmdlet

Get-OfficePowerPointShape

Namespace PSWriteOffice
Inputs
OfficeIMO.PowerPoint.PowerPointSlide OfficeIMO.PowerPoint.PowerPointPresentation
Outputs
PSWriteOffice.Services.PowerPoint.PowerPointShapeInfo
Source
Sources/PSWriteOffice/Cmdlets/PowerPoint/GetOfficePowerPointShapeCommand.cs:26 Edit on GitHub

Reads shape summaries from a slide or presentation.

Remarks

Returns PowerShell-friendly metadata for text boxes, pictures, tables, charts, and auto shapes.

Examples

Authored help example

Inspect one slide.

PS>


Get-OfficePowerPointSlide -Presentation $ppt -Index 0 | Get-OfficePowerPointShape

Returns shape summaries for the selected slide.

Find pictures on a slide.

PS>


Get-OfficePowerPointShape -Presentation $ppt -Index 0 -Kind Picture

Filters the slide output to picture shapes only.

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.

Syntax

Get-OfficePowerPointShape [-Kind <TextBox>] [-Name <String[]>] [-ShapeIndex <Int32[]>] [-Slide <PowerPointSlide>] [<CommonParameters>]
#
Parameter set: Slide

Parameters

Kind String[] optionalposition: namedpipeline: Falsevalues: 6
Optional shape kind filter.
Possible values: TextBox, Picture, Table, Chart, AutoShape, GroupShape
Name String[] optionalposition: namedpipeline: False
Optional wildcard filter for shape names.
ShapeIndex Int32[] optionalposition: namedpipeline: False
Optional zero-based shape index filter.
Slide PowerPointSlide optionalposition: namedpipeline: True (ByValue)
Slide to inspect (optional inside the DSL).

Outputs

PSWriteOffice.Services.PowerPoint.PowerPointShapeInfo: PowerShell-friendly description of a PowerPoint shape.

Get-OfficePowerPointShape [-Index <Nullable`1>] [-Kind <TextBox>] [-Name <String[]>] [-Presentation <PowerPointPresentation>] [-ShapeIndex <Int32[]>] [<CommonParameters>]
#
Parameter set: Presentation

Parameters

Index Nullable`1 optionalposition: namedpipeline: False
Optional zero-based slide index when reading from a presentation.
Kind String[] optionalposition: namedpipeline: Falsevalues: 6
Optional shape kind filter.
Possible values: TextBox, Picture, Table, Chart, AutoShape, GroupShape
Name String[] optionalposition: namedpipeline: False
Optional wildcard filter for shape names.
Presentation PowerPointPresentation optionalposition: namedpipeline: True (ByValue)
Presentation whose slides should be inspected.
ShapeIndex Int32[] optionalposition: namedpipeline: False
Optional zero-based shape index filter.

Outputs

PSWriteOffice.Services.PowerPoint.PowerPointShapeInfo: PowerShell-friendly description of a PowerPoint shape.