Cmdlet

Add-OfficeWordWatermark

Aliases: WordWatermark

Module: PSWriteOffice
Aliases: WordWatermark
Inputs: None
Source: AddOfficeWordWatermarkCommand.cs:31 Edit on GitHub

Adds a watermark to the current section or header.

Syntax

Add-OfficeWordWatermark
[-HorizontalOffset <Double>]
[-PassThru]
[-Scale <Double>]
[-Text] <String>
[-VerticalOffset <Double>]
[<CommonParameters>]

Parameter set: Text

Add-OfficeWordWatermark
[-HorizontalOffset <Double>]
[-ImagePath] <String>
[-PassThru]
[-Scale <Double>]
[-VerticalOffset <Double>]
[<CommonParameters>]

Parameter set: Image

Description

Supports text or image watermarks using OfficeIMO.Word.

Examples

Add a confidentiality watermark while composing a document.

New-OfficeWord -Path .\ProtectedReport.docx {
    Add-OfficeWordParagraph -Text 'Confidential report'
    Add-OfficeWordWatermark -Text 'CONFIDENTIAL' -Scale 1.2
    Protect-OfficeWordDocument -Password 'secret'
}

Applies a text watermark to the current section and then protects the document through OfficeIMO settings.

Add an image watermark.

New-OfficeWord -Path .\DraftReport.docx {
    Add-OfficeWordParagraph -Text 'Draft report'
    Add-OfficeWordWatermark -ImagePath .\Assets\Draft.png -Scale 0.6 -HorizontalOffset 20 -VerticalOffset 40
}

Uses the image watermark path and placement parameters exposed by OfficeIMO.Word.

Parameters

-HorizontalOffset Double optional: Horizontal offset for the watermark.
-PassThru SwitchParameter optional: Emit the created watermark.
-Scale Double optional: Scale factor for the watermark.
-Text String requiredposition: 0sets: Text: Watermark text.
-VerticalOffset Double optional: Vertical offset for the watermark.
-ImagePath String requiredposition: 0sets: Image: Path to an image watermark.

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.