OfficeIMO

API Reference

Command

Set-OfficePowerPointBackground

Namespace PSWriteOffice
Inputs
OfficeIMO.PowerPoint.PowerPointSlide
Outputs
OfficeIMO.PowerPoint.PowerPointSlide

Sets the slide background color or image.

Remarks

Sets the slide background color or image.

Examples

Apply a solid background color.


PS>Get-OfficePowerPointSlide -Presentation $ppt -Index 0 | Set-OfficePowerPointBackground -Color '#F4F7FB'

Applies a solid color fill to the slide background.

Apply a background image.


PS>Set-OfficePowerPointBackground -Slide $slide -ImagePath '.\hero.png'

Uses the provided image as the slide background.

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

Set-OfficePowerPointBackground -Color <String> [-Slide <PowerPointSlide>] [<CommonParameters>]
#
Parameter set: Color

Parameters

Color String requiredposition: 0pipeline: False
Background color (hex or named color).
Slide PowerPointSlide optionalposition: namedpipeline: True (ByValue)
Slide to update (optional inside a slide DSL scope).

Outputs

OfficeIMO.PowerPoint.PowerPointSlide

Set-OfficePowerPointBackground -ImagePath <String> [-Slide <PowerPointSlide>] [<CommonParameters>]
#
Parameter set: Image

Parameters

ImagePath String requiredposition: 0pipeline: False
Path to a background image file.
Slide PowerPointSlide optionalposition: namedpipeline: True (ByValue)
Slide to update (optional inside a slide DSL scope).

Outputs

OfficeIMO.PowerPoint.PowerPointSlide

Set-OfficePowerPointBackground -Clear [-Slide <PowerPointSlide>] [<CommonParameters>]
#
Parameter set: Clear

Parameters

Clear SwitchParameter requiredposition: namedpipeline: False
Clears any explicit background color or image.
Slide PowerPointSlide optionalposition: namedpipeline: True (ByValue)
Slide to update (optional inside a slide DSL scope).

Outputs

OfficeIMO.PowerPoint.PowerPointSlide