Project

PSWriteOffice

PowerShell document automation across OfficeIMO's document, spreadsheet, presentation, PDF, Project, Access, EPUB, invoicing, and conversion engines.

Stars 654
Forks 82
Open issues 1
Total downloads 4,320,051
Release OfficeIMO-v3.5.3
Language: C# Updated: 2026-11-03
Cmdlet

ConvertFrom-OfficeIWork

Module
PSWriteOffice
Inputs
System.String
Outputs
System.IO.FileInfo OfficeIMO.IWork.IWorkConversionReport

Converts Pages, Numbers, or Keynote into the matching editable Microsoft Office format.

Syntax

ConvertFrom-OfficeIWork
[-ConversionOptions <IWorkConversionOptions>]
[-FailOnLoss]
[-Force]
[-OutputPath] <String>
[-PassThruReport]
[-Path] <String>
[-ReadOptions <IWorkReadOptions>]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Description

The conversion reports what was reconstructed and what remains iWork-specific instead of implying lossless parity.

Examples

Convert Numbers to Excel and retain fidelity evidence.

$report = ConvertFrom-OfficeIWork -Path .\Quarterly.numbers -OutputPath .\Quarterly.xlsx -PassThruReport
$report | Select-Object SourceKind, ProjectionKind, ReconstructedItemCount, HasLoss

Parameters

-ConversionOptions IWorkConversionOptions optional
Editable-reconstruction or visual-fallback policy.
-FailOnLoss SwitchParameter optional
Fail when source structures are flattened, omitted, or retained only as preserved records.
-Force SwitchParameter optional
Overwrite an existing destination.
-OutputPath String requiredposition: 1aliases: OutPath
Destination DOCX, XLSX, or PPTX path matching the detected iWork application.
-PassThruReport SwitchParameter optional
Return the loss-aware conversion report instead of file information.
-Path String requiredposition: 0pipeline: True (ByValue)aliases: FilePath
Path to a modern Pages, Numbers, or Keynote package or directory bundle.
-ReadOptions IWorkReadOptions optional
Bounded OfficeIMO iWork read options.

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.