ImportExcel/FAQ/How to Write to an Existing Excel File.md

Write to an Existing Excel File

Enumerate the Excel File

The cmdlets Open-ExcelPackage and Close-ExcelPackage allow for direct modification to Excel file contents.

$ExcelPkg = Open-ExcelPackage -Path  "C:\Test\file.xlsx"

Contents of file.xlsx:

Enumerate the Worksheet to View or Modify the Data

$WorkSheet = $ExcelPkg.Workbook.Worksheets["sheet1"].Cells #open excel worksheet cells from worksheet "sheet1"

Visual of data structure:

A1 contains "someHeader", A2 contains "data1" etc.

Modify a Specific Value in a File

Values can be accessed by row, column. Similar to a 2D array.

$WorkSheet[1,4].Value = "New Column Header" #Starts at index 1 not 0

Contents of file.xlsx after modifying:

Load Value at Specific Index

$ValueAtIndex = $WorkSheet[2,1].Value #Loads the value at row 2, column A

$ValueAtIndex now contains:

Save File After Modifying

The changes will not display in the Excel file until Close-ExcelPackage is called.

Close-ExcelPackage $ExcelPkg #close and save changes made to the Excel file.

Note: If the file is currently in use, Close-ExcelPackage will return an error and will not save the information.