Project

PSWriteOffice

PowerShell document automation across Word, Excel, PowerPoint, PDF, Reader, Confluence, Visio, and open text formats.

View on GitHub Releases Get package
Stars 161
Forks 15
PowerShell Gallery downloads 158,661
Release v3.0.7
Language: C# Updated: 2026-09-19

API Reference

Cmdlet

ConvertFrom-OfficeIWork

Namespace PSWriteOffice
Inputs
System.String
Outputs
System.IO.FileInfo OfficeIMO.IWork.IWorkConversionReport
Source
Sources/PSWriteOffice/Cmdlets/IWork/ConvertFromOfficeIWorkCommand.cs:22 Edit on GitHub

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

Remarks

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

Examples

Authored help example

Convert Numbers to Excel and retain fidelity evidence.

PS>


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

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

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

Parameters

ConversionOptions IWorkConversionOptions optionalposition: namedpipeline: False
Editable-reconstruction or visual-fallback policy.
FailOnLoss SwitchParameter optionalposition: namedpipeline: False
Fail when source structures are flattened, omitted, or retained only as preserved records.
Force SwitchParameter optionalposition: namedpipeline: False
Overwrite an existing destination.
OutputPath String requiredposition: 1pipeline: Falsealiases: OutPath
Destination DOCX, XLSX, or PPTX path matching the detected iWork application.
PassThruReport SwitchParameter optionalposition: namedpipeline: False
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 optionalposition: namedpipeline: False
Bounded OfficeIMO iWork read options.

Outputs

System.IO.FileInfo, OfficeIMO.IWork.IWorkConversionReport