Protect-OfficeWordDocument

Namespace PSWriteOffice

Inputs

OfficeIMO.Word.WordDocument

Source

Sources/PSWriteOffice/Cmdlets/Word/ProtectOfficeWordDocumentCommand.cs:21 Edit on GitHub

Protects a Word document with a password.

Remarks

Sets the protection password and the protection type (default: ReadOnly).

Examples

Authored help example

Example 1: Protect a generated document as read-only.

PS>


New-OfficeWord -Path .\ProtectedReport.docx {
                Add-OfficeWordParagraph -Text 'Confidential report'
                Protect-OfficeWordDocument -Password 'secret' -ProtectionType ReadOnly
            }

Sets OfficeIMO.Word document protection while the document is being composed.

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

Protect-OfficeWordDocument [-Document <WordDocument>] [-PassThru] -Password <String> [-ProtectionType <DocumentProtectionValues>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Document WordDocument optionalposition: namedpipeline: True (ByValue): Document to protect when provided explicitly.
PassThru SwitchParameter optionalposition: namedpipeline: False: Emit the protected document.
Password String requiredposition: 0pipeline: False: Password to apply.
ProtectionType DocumentProtectionValues optionalposition: namedpipeline: False: Protection type (defaults to ReadOnly).