Cmdlet

Export-OfficePowerPoint

Module: PSWriteOffice
Inputs: System.Object[]
Outputs: System.IO.FileInfo
Source: ExportOfficePowerPointCommand.cs:23 Edit on GitHub

Exports objects as a designed presentation with editable tables and optional charts.

Syntax

Export-OfficePowerPoint
[-Accent <OfficeColor>]
[-Category <String>]
[-ChartTitle <String>]
[-ChartType <OfficeChartType>]
[-Culture <CultureInfo>]
[-GroupBy <String>]
-InputObject <Object[]>
[-MaxRows <Int32>]
[-NoClobber]
[-NoSummary]
[-NoTable]
[-PassThru]
[-Path] <String>
[-Property <String[]>]
[-Show]
[-Subtitle <String>]
[-Theme <OfficeThemeInput>]
[-Title <String>]
[-Value <String[]>]
[<CommonParameters>]

Parameter set: Path

Description

Creates a title slide, an optional grouped summary, repeating table headers and native continuation slides. Replaces an existing file unless NoClobber is supplied. Output is quiet unless PassThru is supplied; publication is atomic.

Examples

Present regional revenue with a chart.

$sales | Export-OfficePowerPoint -Path ./Sales.pptx -Title 'Regional sales' -Property Region,Revenue -Category Region -Value Revenue -Theme Boardroom -PassThru

Parameters

-Accent OfficeColor optional: Brand accent, resolved against the selected theme.
-Category String optional: Property containing chart categories.
-ChartTitle String optional: Chart slide title; omission uses the category property name.
-ChartType OfficeChartType optional: Shared native chart kind; defaults to clustered columns.; Possible values: ColumnClustered, Column, ColumnStacked, ColumnStacked100, BarClustered, Bar, BarStacked, BarStacked100, Line, LineStacked, LineStacked100, Area, AreaStacked, AreaStacked100, Scatter, Radar, Pie, Doughnut, Bubble, Column3DClustered, Column3DStacked, Column3DStacked100, Bar3DClustered, Bar3DStacked, Bar3DStacked100, Line3D, Area3D, Area3DStacked, Area3DStacked100, Pie3D, PieOfPie, BarOfPie, Stock, Surface, SurfaceWireframe, SurfaceContour, Funnel, Waterfall, BoxWhisker, Treemap, SurfaceContourWireframe, Sunburst
-Culture CultureInfo optional: Culture for displayed cell values, group counts and numeric chart input; defaults to invariant.
-GroupBy String optional: Property counted on the summary; omission tries Category, then a text property with two to six groups.
-InputObject Object[] requiredpipeline: True (ByValue): Objects supplied as an array or through the pipeline.
-MaxRows Int32 optional: Maximum data rows per physical table slide; omission uses native readable capacity.
-NoClobber SwitchParameter optional: Refuse to replace an existing destination.
-NoSummary SwitchParameter optional: Omit the At a glance summary.
-NoTable SwitchParameter optional: Export only title and chart slides; requires Category and Value.
-PassThru SwitchParameter optional: Return the saved FileInfo.
-Path String requiredposition: 0: Destination PPTX file; its parent folder is created only when publishing.
-Property String[] optional: Table properties in display order; omission includes all properties.
-Show SwitchParameter optional: Open the saved presentation using the system's default application.
-Subtitle String optional: Subtitle on the opening slide.
-Theme OfficeThemeInput optional: Built-in theme, OfficeTheme model or PowerPoint template path; defaults to Modern.
-Title String optional: Title slide text; omission uses the destination file name without its extension.
-Value String[] optional: Numeric properties plotted as chart series in the supplied order.

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.