New-OfficePowerPoint

Aliases: PowerPointNew, PptNew

Namespace PSWriteOffice

Aliases

PowerPointNew PptNew

Source

Sources/PSWriteOffice/Cmdlets/PowerPoint/NewOfficePowerPointCommand.cs:28 Edit on GitHub

Creates a PowerPoint presentation using the DSL.

Remarks

Initializes a presentation, runs the DSL script block, and optionally saves the deck.

Examples

Authored help example

Example 1: Create and capture the presentation object.

PS>


$ppt = New-OfficePowerPoint -FilePath .\deck.pptx

Creates deck.pptx and returns the live presentation object for further editing.

Example 2: Create a deck with a title slide.

PS>


New-OfficePowerPoint -Path .\deck.pptx { PptSlide { PptTitle -Title 'Status Update' } } -Open

Creates, saves, and opens a deck with one titled slide.

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

New-OfficePowerPoint [-Content <ScriptBlock>] -FilePath <String> [-NoSave] [-Open] [-PassThru] [-Password <String>] [-PdfPath <String>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Content ScriptBlock optionalposition: 1pipeline: False: DSL scriptblock describing presentation content.
FilePath String requiredposition: 0pipeline: Falsealiases: Path: Destination path for the new .pptx.
NoSave SwitchParameter optionalposition: namedpipeline: False: Skip saving after executing the DSL.
Open SwitchParameter optionalposition: namedpipeline: False: Open the presentation after saving.
PassThru SwitchParameter optionalposition: namedpipeline: False: Emit a FileInfo for chaining.
Password String optionalposition: namedpipeline: False: Password used to save the presentation as an encrypted package.
PdfPath String optionalposition: namedpipeline: False: Optional PDF path to create from the same presentation before closing it.