Skip to main content
SearchCtrl K
Community

Source code

OfficeIMO.NET libraries, PowerShell module, CLI, Studio and browser tools 700 stars

Talk and help

DiscordQuestions, ideas and show and tell Report an issueBugs and feature requests SponsorFund ongoing development

Mode

Background

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Search the whole siteOpen search page →
Documentation Search all OfficeIMO/
Cmdlet

Save-OfficeWord

Module
PSWriteOffice
Inputs
OfficeIMO.Word.WordDocument
Outputs
System.IO.FileInfo
Source
SaveOfficeWordCommand.cs:20 Edit on GitHub

Saves a live Word document without closing it.

Syntax

Save-OfficeWord
[-AllowLoss]
[-Document] <WordDocument>
[-PassThru]
[-Password <SecureString>]
[[-Path] <String>]
[-Show]
[<CommonParameters>]
#
Parameter set: Document

Description

Uses the supplied path or associated destination. Omitted Password preserves loaded encryption. PassThru returns the saved FileInfo. The document must use explicit persistence.

Guides & Samples

Authored walkthroughs and practical samples linked to this command.

  • Migrate from PSWriteWord to PSWriteOffice Guide

    Replace archived PSWriteWord scripts with maintained PSWriteOffice Word commands for DOCX creation, editing, review, merge, and conversion.

  • Pipeline, Object, and DSL Workflows Guide

    Choose the shortest PSWriteOffice surface for quick exports, incremental composition, complete document authoring, or existing-file updates.

  • Quick Start Guide

    Create your first Word document, Excel workbook, and PowerPoint presentation with OfficeIMO in minutes. Includes examples and API links.

Examples

Save and retain the live document for further editing.

Save-OfficeWord -Document $document -Path ./Report.docx -PassThru
Close-OfficeWord -Document $document

Save a loaded document with its existing encryption.

$document = Open-OfficeWord -Path ./Protected.docx -Password (Read-Host -AsSecureString)
$document | Save-OfficeWord
$document | Close-OfficeWord

Parameters

-AllowLoss SwitchParameter optional
Explicitly accept reported native-save reductions.
-Document WordDocument requiredposition: 0pipeline: True (ByValue)
Live Word document to save.
-PassThru SwitchParameter optional
Return the saved FileInfo.
-Password SecureString optional
Override the output password; omission preserves the document's loaded encryption.
-Path String optionalposition: 1
Optional new destination; omission uses the associated path.
-Show SwitchParameter optional
Open the saved file in its registered default application.

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.