Use Copy method to copy ranges from one sheet to another

.github/workflows/ci.yml

@@ -3,11 +3,8 @@ on:
     branches:
       - master
       - Set-up-GHA-CI/CD
-    paths-ignore:
-      - 'Examples/**'
       
   pull_request:
-  
 
 jobs:
   validate:

Examples/Charts/ChartDataSeparatePage.ps1

@@ -1,35 +0,0 @@
-$data = ConvertFrom-Csv @"
-Region,State,Units,Price
-West,Texas,927,923.71
-North,Tennessee,466,770.67
-East,Florida,520,458.68
-East,Maine,828,661.24
-West,Virginia,465,053.58
-North,Missouri,436,235.67
-South,Kansas,214,992.47
-North,North Dakota,789,640.72
-South,Delaware,712,508.55
-"@
-
-$xlfile = "$PSScriptRoot\spike.xlsx"
-Remove-Item $xlfile -ErrorAction SilentlyContinue
-
-$xlpkg = $data | Export-Excel $xlfile -WorksheetName Data -AutoNameRange -PassThru
-
-$null = Add-Worksheet -ExcelPackage $xlpkg -WorksheetName Summary -Activate
-
-$params = @{
-    Worksheet = $xlpkg.Summary
-    Title     = "Sales by Region"
-    ChartType = 'ColumnClustered'
-    
-    # XRange    = "Data!A2:A10"
-    # YRange    = "Data!C2:C10"
-
-    XRange    = 'Data!Region'
-    YRange    = 'Data!Units'
-}
-
-Add-ExcelChart  @params
-
-Close-ExcelPackage $xlpkg -Show

Examples/ConditionalFormatting/ConditionalFormattingIcontSetOnlyIcon.ps1

@@ -1,22 +0,0 @@
-try { Import-Module $PSScriptRoot\..\..\ImportExcel.psd1 } catch { throw ; return }
-
-$data = ConvertFrom-Csv @"
-Region,State,Other,Units,Price,InStock
-West,Texas,1,927,923.71,1
-North,Tennessee,3,466,770.67,0
-East,Florida,0,1520,458.68,1
-East,Maine,1,1828,661.24,0
-West,Virginia,1,465,053.58,1
-North,Missouri,1,436,235.67,1
-South,Kansas,0,214,992.47,1
-North,North Dakota,1,789,640.72,0 
-South,Delaware,-1,712,508.55,1
-"@
-
-$xlfile = "$PSScriptRoot\test.xlsx"
-Remove-Item $xlfile -ErrorAction SilentlyContinue
-
-$cfi1 = New-ConditionalFormattingIconSet -Range C:C -ConditionalFormat ThreeIconSet -IconType Symbols -ShowIconOnly
-$cfi2 = New-ConditionalFormattingIconSet -Range F:F -ConditionalFormat ThreeIconSet -IconType Symbols2 -ShowIconOnly
-
-$data | Export-Excel $xlfile -AutoSize -ConditionalFormat $cfi1, $cfi2 -Show

Examples/CopyRange/CopyFromOneSheetInSameWorkbook.ps1

@@ -0,0 +1,29 @@
+<#
+    Copy a range from WorksheetA to WorksheetB
+#>
+
+$data = ConvertFrom-Csv @"
+Region,State,Units,Price
+West,Texas,927,923.71
+North,Tennessee,466,770.67
+East,Florida,520,458.68
+East,Maine,828,661.24
+West,Virginia,465,053.58
+North,Missouri,436,235.67
+South,Kansas,214,992.47
+North,North Dakota,789,640.72
+South,Delaware,712,508.55
+"@
+
+$xlfile = "./test.xlsx"
+Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+$data | Export-Excel $xlfile -WorksheetName WorksheetA
+$data | Export-Excel $xlfile -WorksheetName WorksheetB 
+
+$excel = Open-ExcelPackage $xlfile
+
+# Copy a range from WorksheetA to WorksheetB 
+$excel.WorksheetA.Cells["A3:B5"].Copy($excel.WorksheetB.Cells["G3"])
+
+Close-ExcelPackage $excel -Show

Examples/HeaderName/ConvertDictionaryOfArraysToExcel.ps1

@@ -0,0 +1,24 @@
+function ConvertTo-Excel {
+    param(
+        $Path,
+        [System.Collections.IDictionary]$targetData
+    )
+
+    $column = 1
+    foreach ($key in $targetData.Keys) {
+        $cityData[$key] | Export-Excel $xlfile -StartColumn ($column++) -HeaderName $key -AutoSize
+    }
+}
+
+$cityData = [Ordered]@{}
+
+$cityData.City = "New York City", "Paris", "Barcelona", "Rome"
+$cityData.Country = "United States", "France", "Spain", "Italy"
+$cityData.Population = 8600000, 2141000, 5515000, 2873000
+
+$xlfile = "$PSScriptRoot/test.xlsx"
+Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+ConvertTo-Excel $xlfile $cityData
+
+. $xlfile

Examples/HeaderName/HeaderName.ps1

@@ -0,0 +1,24 @@
+try { Import-Module $PSScriptRoot\..\..\ImportExcel.psd1 } catch { throw ; return }
+
+## This exports only the numbers
+# 1..10 | Export-excel $PSScriptRoot\test.xlsx -Show
+
+## This exports the numbers and in A1 the text "MyNum"
+# 1..10 | Export-excel $PSScriptRoot\test.xlsx -HeaderName MyNum -Show
+
+$xlfile = "$PSScriptRoot/testMultipleColumns.xlsx"
+Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+$Regions = 'West', 'North', 'East ', 'East ', 'West ', 'North', 'South', 'North', 'South'
+$States = 'Texas', 'Tennessee', 'Florida', 'Maine', 'Virginia', 'Missouri', 'Kansas', 'North Dakota', 'Delaware'
+$Units = 927, 466, 520, 828, 465, 436, 214, 789, 712
+$Prices = 923.71, 770.67, 458.68, 661.24, 53.58, 235.67, 992.47, 640.72, 508.55
+
+# Export each list (array) as a separate column to the same worksheet and workbook
+$Regions | Export-Excel -Path $xlfile -HeaderName Region -StartColumn 1 -AutoSize
+$States  | Export-Excel -Path $xlfile -HeaderName State  -StartColumn 2 -AutoSize
+$Units   | Export-Excel -Path $xlfile -HeaderName Units  -StartColumn 3 -AutoSize
+$Prices  | Export-Excel -Path $xlfile -HeaderName Prices -StartColumn 4 -AutoSize
+
+# Show the results in Excel
+. $xlfile

Examples/Tables/SalesData-WithTotalRow.ps1

@@ -1,29 +0,0 @@
-try { Import-Module $PSScriptRoot\..\..\ImportExcel.psd1 } catch { throw ; return }
-
-$data = ConvertFrom-Csv @"
-OrderId,Category,Sales,Quantity,Discount
-1,Cosmetics,744.01,07,0.7
-2,Grocery,349.13,25,0.3
-3,Apparels,535.11,88,0.2
-4,Electronics,524.69,60,0.1
-5,Electronics,439.10,41,0.0
-6,Apparels,56.84,54,0.8
-7,Electronics,326.66,97,0.7
-8,Cosmetics,17.25,74,0.6
-9,Grocery,199.96,39,0.4
-10,Grocery,731.77,20,0.3
-"@
-
-$xlfile = "$PSScriptRoot\TotalsRow.xlsx"
-Remove-Item $xlfile -ErrorAction SilentlyContinue
-
-$TableTotalSettings = @{     
-    Quantity = 'Sum'
-    Category = '=COUNTIF([Category],"<>Electronics")' # Count the number of categories not equal to Electronics
-    Sales    = @{
-        Function = '=SUMIF([Category],"<>Electronics",[Sales])'
-        Comment  = "Sum of sales for everything that is NOT Electronics"
-    }
-}
-
-$data | Export-Excel -Path $xlfile -TableName Sales -TableStyle Medium10 -TableTotalSettings $TableTotalSettings -AutoSize -Show

Examples/Tables/TotalsRow.ps1

@@ -1,16 +0,0 @@
-try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
-
-$r = Get-ChildItem C:\WINDOWS\system32 -File
-
-$TotalSettings = @{ 
-    Name = "Count"
-    # You can create the formula in an Excel workbook first and copy-paste it here
-    # This syntax can only be used for the Custom type
-    Extension = "=COUNTIF([Extension];`".exe`")"
-    Length = @{
-        Function = "=SUMIF([Extension];`".exe`";[Length])"
-        Comment = "Sum of all exe sizes"
-    }
-}
-
-$r | Export-Excel -TableName system32files -TableStyle Medium10 -TableTotalSettings $TotalSettings -Show

INDEX.md

@@ -1,86 +0,0 @@
-# Overview of Module Functions
-
-When available, Help page for function is linked.
-
-
-| Function                          | Synopsis           | Description |
-|-----------------------------------|-----------------------|-----------------------|
-|[Add-ConditionalFormatting](mdHelp/en/add-conditionalformatting.md) |Adds conditional formatting to all or part of a worksheet.| Mark cells with icons, show a databar, change the color, font or format of cells with conditional formatting.|
-|[Add-ExcelChart](mdHelp/en/add-excelchart.md)|Creates a chart in an existing Excel worksheet.|Create chart and optionally configure the type of chart, the range of X and Y value labels, the title, the legend, the ranges for both axes, the format and position of the axes.|
-|[Add-ExcelDataValidationRule](mdHelp/en/add-exceldatavalidationrule.md)|Adds data validation to a range of cells|Excel supports the validation of user input. Ranges of cells can be marked to only contain numbers, dates, text up to a particular length, or selections from a list.|
-|[Add-ExcelName](mdHelp/en/add-excelname.md)|Adds a named-range to an existing Excel worksheet.|It is often helpful to be able to refer to sets of cells with a name rather than using their co-ordinates; Add-ExcelName sets up these names.|
-|[Add-ExcelTable](/mdHelp/en/add-exceltable.md)|Adds Tables to Excel workbooks.|Add table with unique name to workbook. Configure filter, header, totals, first and last column highlights.|
-|[Add-PivotTable](mdHelp/en/add-pivottable.md)|Adds a PivotTable (and optional PivotChart) to a workbook.|If the PivotTable already exists, the source data will be updated.|
-|[Add-Worksheet](mdHelp/en/add-worksheet.md)|Adds a worksheet to an existing workbook.|Worksheet added. Placement optionally configured.|
-|BarChart|Creates bar chart in Excel worksheet.| Represents data with horizontal rectangular bars proportional to values represented. Can specify data range, axis labels, titles, colors, etc. |
-|[Close-ExcelPackage](mdHelp/en/close-excelpackage.md)|Closes an Excel Package, saving, saving under a new name or abandoning changes and opening the file in Excel as required.|When working with an ExcelPackage object, the Workbook is held in memory and not saved until the .Save() method of the package is called. Close-ExcelPackage saves and disposes of the Package object.|
-|ColumnChart|Creates column chart in Excel worksheet.| Represents data with vertical rectangular bars proportional to values represented. Can specify data range, axis labels, titles, colors, etc. |
-|[Compare-Worksheet](mdHelp/en/compare-worksheet.md)|Compares two worksheets and shows the differences.|Reads the worksheet from each file and decides the column names and builds a hashtable of the key-column values and the rows in which they appear. It then uses PowerShell's Compare-Object command to compare the sheets (explicitly checking all the column names which have not been excluded).|
-|[Convert-ExcelRangeToImage](mdHelp/en/convert-excelrangetoimage.md)|Gets the specified part of an Excel file and exports it as an image|Exports file range as image. Unlike most functions in the module it needs a local copy of Excel to be installed.|
-|ConvertFrom-ExcelData|Converts data from Excel file into PowerShell objects.|Reads contents of Excel file and converts them into a collection of PowerShell objects.|
-|[ConvertFrom-ExcelSheet](mdHelp/en/convertfrom-excelsheet.md)|Exports Sheets from Excel Workbooks to CSV files.|This command provides a convenient way to run Import-Excel @ImportParameters | Select-Object @selectParameters | export-Csv @ ExportParameters|
-|[ConvertFrom-ExcelToSQLInsert](mdHelp/en/convertfrom-exceltosqlinsert.md)|Generate SQL insert statements from Excel spreadsheet.|Generate SQL insert statements from Excel spreadsheet.|
-|ConvertTo-ExcelXlsx|Converts PowerShell objects or data tables into Excel file in xlsx format.| Allows export of data from PowerShell to an Excel file.|
-|[Copy-ExcelWorksheet](mdHelp/en/copy-excelworksheet.md)|Copies a worksheet between workbooks or within the same workbook.|Copy-ExcelWorkSheet takes a Source object. The Destination workbook can be given as the path to an XLSx file, an ExcelPackage object or an ExcelWorkbook object.|
-|DoChart| Creates chart of specified type in workbook.|Creates chart of specified type in workbook.|
-|Enable-ExcelAutoFilter| Enables auto-filter feature for columns in Excel worksheet.| Allows user(s) to filter data based on specific criteria.|
-|Enable-ExcelAutofit|Automatically adjusts width of columns in Excel worksheet to fit contents.|Ensures all data in columns is visible without truncation by dynamically adjusting column based on content.|
-|[Expand-NumberFormat](mdHelp/en/expand-numberformat.md)|Converts short names for number formats, for example, 'Short-Date', to the formatting strings used in Excel|Converts short names for number formats to the formatting strings used in Excel|
-|[Export-Excel](mdHelp/en/export-excel.md)|Exports data to an Excel worksheet.|Exports data to an Excel file and where possible tries to convert numbers in text fields so Excel recognizes them as numbers instead of text.|
-|Get-ExcelColumnName|Returns column name(s) corresponding to specific column index or indices.|Returns column name(s) corresponding to specific column index or indices.|
-|Get-ExcelFileSchema|Retrieves schema of Excel file.| Provides insight into Excel file structure.|
-|Get-ExcelFileSummary| Retrieves summary of content and properties of Excel file.| Retrieves information such as number of worksheets, total rows, total columns, file size, and other metadata.|
-|Get-ExcelSheetDimensionAddress| Retrieves address of the used range of worksheet in Excel file.| This identifies the range of cells within a worksheet that contain data or formatting. |
-|[Get-ExcelSheetInfo](mdHelp/en/get-excelsheetinfo.md)|Get worksheet names and their indices of an Excel workbook.|The Get-ExcelSheetInfo cmdlet gets worksheet names and their indices of an Excel workbook.|
-|[Get-ExcelWorkbookInfo](mdHelp/en/get-excelworkbookinfo.md)|Retrieve information of an Excel workbook.|The Get-ExcelWorkbookInfo cmdlet retrieves information (LastModifiedBy, LastPrinted, Created, Modified, ...) fron an Excel workbook. These are the same details that are visible in Windows Explorer when right clicking the Excel file, selecting Properties and check the Details tabpage.|
-|Get-HtmlTable| Retrieves data from HTML table and converts it to PowerShell objects.|Retrieves data from HTML table and converts it to PowerShell objects.|
-|Get-Range| Retrieves data within a specified range of cells in Excel worksheet.|Allows extraction of subset of data from worksheet using a range.|
-|Get-XYRange| Retrieves data within a specified range of cells in an X-Y range.| Allows extraction of data from subset of rows and columns from worksheet using X/Y range.|
-|[Import-Excel](mdHelp/en/import-excel.md)|Create custom objects from the rows in an Excel worksheet.|The Import-Excel cmdlet creates custom objects from the rows in an Excel worksheet. Each row is represented as one object.|
-|Import-Html| Imports data from HTML file or URL into PowerShell.| Imports data from HTML file or URL into PowerShell.|
-|Import-UPS| Imports UPS data into PowerShell.|Imports UPS data into PowerShell.|
-|Import-USPS|Imports USPS data into PowerShell.|Imports USPS data into PowerShell.|
-|Invoke-ExcelQuery| Executes query against Excel file and returns result as PowerShell objects.| Perform SQL-like queries on Excel data.|
-|Invoke-Sum|Calculates sum of values in specified range of cells in an Excel worksheet.| Facilitates summation operations on data within Excel.|
-|[Join-Worksheet](mdHelp/en/join-worksheet.md)|Combines data on all the sheets in an Excel worksheet onto a single sheet.|Join-Worksheet can work in two main ways, either Combining data which has the same layout from many pages into one, or Combining pages which have nothing in common.|
-|LineChart|Creates line chart in Excel worksheet.| Represents data with series of data points connected by straight lines. |
-|[Merge-MultipleSheets](mdHelp/en/merge-multiplesheets.md)|Merges Worksheets into a single Worksheet with differences marked up.|The Merge Worksheet command combines two sheets. Merge-MultipleSheets is designed to merge more than two.|
-|[Merge-Worksheet](mdHelp/en/merge-worksheet.md)|Merges two Worksheets (or other objects) into a single Worksheet with differences marked up.|The Compare-Worksheet command takes two Worksheets and marks differences in the source document, and optionally outputs a grid showing the changes.|
-|[New-ConditionalFormattingIconSet](mdHelp/en/new-conditionalformattingiconset.md)|Creates an object which describes a conditional formatting rule a for 3,4 or 5 icon set.|This command builds the defintion of a Conditional formatting rule for an icon set.|
-|[New-ConditionalText](mdHelp/en/new-conditionaltext.md)|Creates an object which describes a conditional formatting rule for single valued rules.|Some Conditional formatting rules don't apply styles to a cell (IconSets and Databars); some take two parameters (Between); some take none (ThisWeek, ContainsErrors, AboveAverage etc).The others take a single parameter (Top, BottomPercent, GreaterThan, Contains etc).This command creates an object to describe the last two categories, which can then be passed to Export-Excel.|
-|[New-ExcelChartDefinition](mdHelp/en/new-excelchartdefinition.md)|Creates a Definition of a chart which can be added using Export-Excel, or Add-PivotTable.|All the parameters which are passed to Add-ExcelChart can be added to a chart-definition object and passed to Export-Excel with the -ExcelChartDefinition parameter, or to Add-PivotTable with the -PivotChartDefinition parameter. This command sets up those definition objects.|
-|New-ExcelStyle| Creates a new style object that defines various formatting properties, such as font size, font color, background color, borders, and alignment.| After being created, style object can be applied to specific cells or ranges.|
-|[New-PivotTableDefinition](mdHelp/en/new-pivottabledefinition.md)|Creates PivotTable definitons for Export-Excel|Export-Excel allows a single PivotTable to be defined using the parameters -IncludePivotTable, -PivotColumns, -PivotRows, -PivotData, -PivotFilter, -PivotTotals, -PivotDataToColumn, -IncludePivotChart and -ChartType. Its -PivotTableDefintion paramater allows multiple PivotTables to be defined, with additional parameters. New-PivotTableDefinition is a convenient way to build these definitions.|
-|New-Plot| Creates new plot in Excel worksheet. |Creates new plot in Excel worksheet. |
-|New-PSItem| Creates a new PSItem.|Creates a new PSItem.|
-|[Open-ExcelPackage](mdHelp/en/open-excelpackage.md)|Returns an ExcelPackage object for the specified XLSX file.|Import-Excel and Export-Excel open an Excel file, carry out their tasks and close it again. Sometimes it is necessary to open a file and do other work on it. Open-ExcelPackage allows the file to be opened for these tasks.|
-|PieChart| Creates pie chart in Excel worksheet.| Represents data as circular graph divided into slices. |
-|Pivot|Creates pivot table in Excel worksheet.| Pivot tables unlock powerful data analysis, especially on large data sets. Can group and aggregate data, apply filters and generate summary stats. |
-|Read-Clipboard|Reads data from clipboard and imports it into PowerShell.|Leverage data copied to the clipboard from an external source in PowerShell script.|
-|Read-OleDbData|Reads data from a data source using OleDb (Object Linking and Embedding Database) connectivity.|Allows query of data from various data sources such as Excel files, Access databases, or other databases that support OleDb connections.|
-|ReadClipboardImpl|Internal implementation detail for Read-Clipboard.|Internal implementation detail for Read-Clipboard.|
-|[Remove-Worksheet](mdHelp/en/remove-worksheet.md)|Removes one or more worksheets from one or more workbooks|Removes one or more worksheets from one or more workbooks.|
-|[Select-Worksheet](mdHelp/en/select-worksheet.md)|Sets the selected tab in an Excel workbook to be the chosen sheet and unselects all the others.|Sometimes when a sheet is added we want it to be the active sheet, sometimes we want the active sheet to be left as it was. Select-Worksheet exists to change which sheet is the selected tab when Excel opens the file.|
-|[Send-SQLDataToExcel](mdHelp/en/send-sqldatatoexcel.md)|Inserts a DataTable - returned by a SQL query - into an ExcelSheet| This command takes a SQL statement and run it against a database connection. After fetching the data it calls Export-Excel with the data as the value of InputParameter and whichever of Export-Excel's parameters it was passed|
-|Set-CellComment|Adds or modifies comments in specific cells.| Used to add additional context or explanations for data in workbook.|
-|Set-CellStyle|Sets style of one or multiple cells in a worksheet.| Customize font, font size, font color, fill color, border and alignment of cells.|
-|[Set-ExcelColumn](mdHelp/en/set-excelcolumn.md)|Adds or modifies a column in an Excel worksheet, filling values, setting formatting and/or creating named ranges.|Set-ExcelColumn can take a value which is either a string containing a value or formula or a scriptblock which evaluates to a string, and optionally a column number and fills that value down the column. A column heading can be specified, and the column can be made a named range. The column can be formatted in the same operation.|
-|[Set-ExcelRange](mdHelp/en/set-excelrange.md)|Applies number, font, alignment and/or color formatting, values or formulas to a range of Excel cells.| Style elements for a range of cells, this includes auto-sizing and hiding, setting font elements (Name, Size, Bold, Italic, Underline & UnderlineStyle and Subscript & SuperScript), font and background colors, borders, text wrapping, rotation, alignment within cells, and number format.|
-|[Set-ExcelRow](mdHelp/en/set-excelrow.md)|Fills values into a new row in an Excel spreadsheet, and sets row formats.|Fills values into a [new] row in an Excel spreadsheet, and sets row formats.|
-|Set-WorksheetProtection| Protects a worksheet within an Excel workbook by applying various protection settings.| Can include password protection, locking cells, hiding formulas, restricting formatting, and disallowing certain row/column operations.|
-|Test-Boolean| Test whether a given value is a boolean (true/false) or not.| Return true if it is and false otherwise.
-|Test-Date| Test whether a given value is a valid date or not.| Return true if it is and false otherwise.
-|Test-Integer| Test whether a given value is an integer or not.| Return true if it is and false otherwise.
-|Test-Number| Test whether a given value is a numeric type or not. | Return true if it is and false otherwise.
-|Test-String| Test whether a given value is a string or not.| Return true if it is and false otherwise.
-|[Update-FirstObjectProperties](mdHelp/en/update-firstobjectproperties.md)|Updates the first object to contain all the properties of the object with the most properties in the array.| This is usefull when not all objects have the same quantity of properties and CmdLets like Out-GridView or Export-Excel are not able to show all the properties because the first object doesn't have them all.|
-|Convert-XlRangeToImage| Function converts a range of cells in an Excel worksheet to an image file.|Takes a specified range of cells as input and generates an image file (such as PNG or JPEG) containing the visual representation of the cells.This allows the export a portion of an Excel worksheet as an image, for example, to embed it in a document or share it in a presentation.|
-|Export-ExcelSheet| Exports the content of an Excel worksheet to a new Excel workbook or to another format, such as CSV or HTML.|Allows specification of the output path and format for the exported data. Can export the entire worksheet or specify a range of cells to export.
-|New-ExcelChart| Creates a new chart of specified type in an Excel worksheet based on the specified data range.|It allows specification the type of chart (e.g., bar chart, line chart, pie chart) and customize various aspects of the chart's appearance, such as title, axis labels, and data series. Once created, the chart can be inserted into the worksheet at a specified location.|
-|Set-Column|Same as Set-ExcelColumn|Same as Set-ExcelColumn|
-|Set-Format|Apply formatting to cells within a specified range.| Define various formatting options such as font size, font color, and cell background color.
-|Set-Row|Same as Set-ExcelRow|Same as Set-ExcelRow|
-|Use-ExcelData|Allows utilization of Excel data directly within PowerShell script.|Simplifies the process of working with Excel data in PowerShell scripts, providing a convenient and efficient way to leverage Excel data for various tasks.
-
-
-

ImportExcel.psd1

@@ -6,7 +6,7 @@
     RootModule         = 'ImportExcel.psm1'
 
     # Version number of this module.
-    ModuleVersion      = '7.8.10'
+    ModuleVersion      = '7.8.2'
 
     # ID used to uniquely identify this module
     GUID               = '60dd4136-feff-401a-ba27-a84458c57ede'
@@ -54,7 +54,6 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
         'Export-Excel',
         'Export-ExcelSheet',        
         'Get-ExcelColumnName',
-        'Get-ExcelFileSchema',
         'Get-ExcelFileSummary', 
         'Get-ExcelSheetDimensionAddress',       
         'Get-ExcelSheetInfo',
@@ -89,7 +88,6 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
         'Remove-Worksheet',
         'Select-Worksheet',
         'Send-SQLDataToExcel',
-        'Set-CellComment',
         'Set-CellStyle',
         'Set-ExcelColumn',
         'Set-ExcelRange',
@@ -123,7 +121,8 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
         '.\GetExcelTable.ps1',
         '.\ImportExcel.psd1',
         '.\ImportExcel.psm1',
-        '.\LICENSE.txt',        
+        '.\LICENSE.txt',
+        '.\README.md',
         '.\Plot.ps1',
         '.\Private',
         '.\Public',
@@ -150,7 +149,7 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
             Tags         = @("Excel", "EPPlus", "Export", "Import")
 
             # The web address of an icon which can be used in galleries to represent this module
-            #IconUri = 
+            #IconUri = "http://pesterbdd.com/images/Pester.png"
 
             # The web address of this module's project or support homepage.
             ProjectUri   = "https://github.com/dfinke/ImportExcel"
@@ -215,4 +214,4 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
     # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
     # DefaultCommandPrefix = ''
 
-}
+}

Private/ArgumentCompletion.ps1

@@ -67,8 +67,9 @@ function WorksheetArgumentCompleter {
     param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter)
     $xlPath = $fakeBoundParameter['Path']
     if (Test-Path -Path $xlPath) {
-        $xlSheet = Get-ExcelSheetInfo -Path $xlPath
-        $WorksheetNames = $xlSheet.Name
+        $xlpkg = Open-ExcelPackage -ReadOnly -Path $xlPath
+        $WorksheetNames = $xlPkg.Workbook.Worksheets.Name
+        Close-ExcelPackage -nosave -ExcelPackage $xlpkg
         $WorksheetNames.where( { $_ -like "*$wordToComplete*" }) | foreach-object {
             New-Object -TypeName System.Management.Automation.CompletionResult -ArgumentList "'$_'",
             $_ , ([System.Management.Automation.CompletionResultType]::ParameterValue) , $_

Public/Add-ConditionalFormatting.ps1

@@ -23,7 +23,6 @@
         [Parameter(ParameterSetName = "FourIconSet")]
         [Parameter(ParameterSetName = "FiveIconSet")]
         [switch]$Reverse,
-        [switch]$ShowIconOnly,
         [Parameter(ParameterSetName = "NamedRule",Position = 2)]
         $ConditionValue,
         [Parameter(ParameterSetName = "NamedRule",Position = 3)]
@@ -85,9 +84,6 @@
     elseif ($PSBoundParameters.ContainsKey("FourIconsSet"  )      ) {$rule =  $Worksheet.ConditionalFormatting.AddFourIconSet( $Address , $FourIconsSet )}
     elseif ($PSBoundParameters.ContainsKey("FiveIconsSet"  )      ) {$rule =  $Worksheet.ConditionalFormatting.AddFiveIconSet( $Address , $FiveIconsSet )}
     else                                                            {$rule = ($Worksheet.ConditionalFormatting)."Add$RuleType"($Address )                }
-    If($ShowIconOnly) {
-        $rule.ShowValue = $false
-    }
     if     ($Reverse)  {
             if     ($rule.type -match 'IconSet$'   )                {$rule.reverse = $true}
             elseif ($rule.type -match 'ColorScale$')                {$temp =$rule.LowValue.Color ; $rule.LowValue.Color = $rule.HighValue.Color; $rule.HighValue.Color = $temp}

Public/Add-ExcelTable.ps1

@@ -9,7 +9,7 @@ function Add-ExcelTable {
         [Switch]$ShowHeader ,
         [Switch]$ShowFilter,
         [Switch]$ShowTotal,
-        [hashtable]$TableTotalSettings,
+        [hashtable]$TotalSettings,
         [Switch]$ShowFirstColumn,
         [Switch]$ShowLastColumn,
         [Switch]$ShowRowStripes,
@@ -51,65 +51,14 @@ function Add-ExcelTable {
         }
         #it seems that show total changes some of the others, so the sequence matters.
         if     ($PSBoundParameters.ContainsKey('ShowHeader'))        {$tbl.ShowHeader        = [bool]$ShowHeader}
-        if     ($PSBoundParameters.ContainsKey('TableTotalSettings') -And $Null -ne $TableTotalSettings)     {
+        if     ($PSBoundParameters.ContainsKey('TotalSettings'))     {
             $tbl.ShowTotal = $true
-            foreach ($k in $TableTotalSettings.keys) {
-                
-                # Get the Function to be added in the totals row
-                if ($TableTotalSettings[$k] -is [HashTable]) { 
-                    If ($TableTotalSettings[$k].Keys -contains "Function") {
-                        $TotalFunction = $TableTotalSettings[$k]["Function"]
-                    }
-                    Else { Write-Warning -Message "TableTotalSettings parameter for column '$k' needs a key 'Function'" }
-                }
-                else { 
-                    $TotalFunction = [String]($TableTotalSettings[$k]) 
-                }
-                
-                # Add the totals row
+            foreach ($k in $TotalSettings.keys) {
                 if (-not $tbl.Columns[$k]) {Write-Warning -Message "Table does not have a Column '$k'."}
-                elseif ($TotalFunction -match "^=") {
-                    ### A function in Excel uses ";" between parameters but the OpenXML parameter separator is ","
-                    ### Only replace semicolon when it's NOT somewhere between quotes quotes. 
-                    # Get all text between quotes
-                    $QuoteMatches = [Regex]::Matches($TotalFunction,"`"[^`"]*`"|'[^']*'") 
-                    # Create array with all indexes of characters between quotes (and the quotes themselves)
-                    $QuoteCharIndexes = $(
-                        Foreach ($QuoteMatch in $QuoteMatches) {
-                            (($QuoteMatch.Index)..($QuoteMatch.Index + $QuoteMatch.Length - 1))
-                        }
-                    )
-
-                    # Get all semicolons
-                    $SemiColonMatches = [Regex]::Matches($TotalFunction, ";")
-                    # Replace the semicolons of which the index is not in the list of quote-text indexes
-                    Foreach ($SemiColonMatch in $SemiColonMatches.Index) {
-                        If ($QuoteCharIndexes -notcontains $SemiColonMatch) {
-                            $TotalFunction = $TotalFunction.remove($SemiColonMatch,1).Insert($SemiColonMatch,",")
-                        }
-                    }
-
-                    # Configure the formula. The TotalsRowFunction is automatically set to "Custom" when the TotalsRowFormula is set.
-                    $tbl.Columns[$k].TotalsRowFormula = $TotalFunction
-                }
-                elseif ($TotalFunction -notin @("Average", "Count", "CountNums", "Max", "Min", "None", "StdDev", "Sum", "Var") ) {
-                    Write-Warning -Message "'$($TotalFunction)' is not a valid total function."
-                }
-                else {$tbl.Columns[$k].TotalsRowFunction = $TotalFunction}
-
-                # Set comment on totals row
-                If ($TableTotalSettings[$k] -is [HashTable] -and $TableTotalSettings[$k].Keys -contains "Comment" -and ![String]::IsNullOrEmpty($TableTotalSettings[$k]["Comment"])) {
-                    $ColumnLetter = [officeOpenXml.ExcelAddress]::GetAddressCol(($tbl.columns | ? { $_.name -eq $k }).Id, $False)
-                    $CommentRange = "{0}{1}" -f $ColumnLetter, $tbl.Address.End.Row
-
-                    $CellCommentParams = @{
-                        Worksheet    = $tbl.WorkSheet
-                        Range        = $CommentRange
-                        Text         = $TableTotalSettings[$k]["Comment"]
-                    }
-
-                    Set-CellComment  @CellCommentParams
+                elseif ($TotalSettings[$k] -notin @("Average", "Count", "CountNums", "Max", "Min", "None", "StdDev", "Sum", "Var") ) {
+                    Write-Warning -Message "'$($TotalSettings[$k])' is not a valid total function."
                 }
+                else {$tbl.Columns[$k].TotalsRowFunction = $TotalSettings[$k]}
             }
         }
         elseif ($PSBoundParameters.ContainsKey('ShowTotal'))         {$tbl.ShowTotal         = [bool]$ShowTotal}

Public/Add-Worksheet.ps1

@@ -49,7 +49,7 @@ function Add-Worksheet  {
             }
             else {$ExcelWorkbook.Worksheets.MoveBefore($WorksheetName, $MoveBefore)}
         }
-        else {Write-Warning "Can't find worksheet '$MoveBefore'; worksheet '$WorksheetName' will not be moved."}
+        else {Write-Warning "Can't find worksheet '$MoveBefore'; worsheet '$WorksheetName' will not be moved."}
     }
     elseif ($MoveAfter  ) {
         if ($MoveAfter -eq "*") {
@@ -68,7 +68,7 @@ function Add-Worksheet  {
                 $ExcelWorkbook.Worksheets.MoveAfter($WorksheetName, $MoveAfter)
             }
         }
-        else {Write-Warning "Can't find worksheet '$MoveAfter'; worksheet '$WorksheetName' will not be moved."}
+        else {Write-Warning "Can't find worksheet '$MoveAfter'; worsheet '$WorksheetName' will not be moved."}
     }
     #endregion
     if ($Activate) {Select-Worksheet -ExcelWorksheet $ws  }

Public/ConvertFrom-ExcelData.ps1

@@ -8,8 +8,7 @@ function ConvertFrom-ExcelData {
         [ScriptBlock]$ScriptBlock,
         [Alias("Sheet")]
         $WorksheetName = 1,
-		[Alias('HeaderRow', 'TopRow')]
-        [int]$StartRow = 1,
+        [int]$HeaderRow = 1,
         [string[]]$Header,
         [switch]$NoHeader,
         [switch]$DataOnly

Public/ConvertTo-ExcelXlsx.ps1

@@ -45,18 +45,11 @@ function ConvertTo-ExcelXlsx {
             throw "Could not create Excel.Application ComObject. Please verify that Excel is installed."
         }
 
-        try {  
-            $Excel.Visible = $false
-            $null = $Excel.Workbooks.Open($xlsFile.FullName, $null, $true)
-            $Excel.ActiveWorkbook.SaveAs($xlsxPath, $xlFixedFormat)
-        }
-        finally {
-            if ($null -ne $Excel.ActiveWorkbook) {
-                $Excel.ActiveWorkbook.Close()
-            }
-            
-            $Excel.Quit()
-        }
+        $Excel.Visible = $false
+        $null = $Excel.Workbooks.Open($xlsFile.FullName)
+        $Excel.ActiveWorkbook.SaveAs($xlsxPath, $xlFixedFormat)
+        $Excel.ActiveWorkbook.Close()
+        $Excel.Quit()
     }
 }
 

Public/Export-Excel.ps1

@@ -13,6 +13,7 @@
         [Switch]$Calculate,
         [Switch]$Show,
         [String]$WorksheetName = 'Sheet1',
+        [String]$HeaderName,
         [Alias("PW")]
         [String]$Password,
         [switch]$ClearSheet,
@@ -56,8 +57,7 @@
         [Alias('Table')]
         $TableName,
         [OfficeOpenXml.Table.TableStyles]$TableStyle = [OfficeOpenXml.Table.TableStyles]::Medium6,
-        [HashTable]$TableTotalSettings,
-        [Switch]$BarChart,
+        [Switch]$Barchart,
         [Switch]$PieChart,
         [Switch]$LineChart ,
         [Switch]$ColumnChart ,
@@ -79,7 +79,6 @@
         [Switch]$NoAliasOrScriptPropeties,
         [Switch]$DisplayPropertySet,
         [String[]]$NoNumberConversion,
-        [String[]]$NoHyperLinkConversion,
         [Object[]]$ConditionalFormat,
         [Object[]]$ConditionalText,
         [Object[]]$Style,
@@ -213,7 +212,7 @@
                 $row ++
                 $null = $ws.Cells[$row, $StartColumn].LoadFromDataTable($InputObject, $false )
                 if ($TableName -or $PSBoundParameters.ContainsKey('TableStyle')) {
-                    Add-ExcelTable -Range $ws.Cells[$ws.Dimension] -TableName $TableName -TableStyle $TableStyle -TableTotalSettings $TableTotalSettings
+                    Add-ExcelTable -Range $ws.Cells[$ws.Dimension] -TableName $TableName -TableStyle $TableStyle
                 }
             }
             else {
@@ -260,6 +259,11 @@
             try {
                 if ($null -eq $InputObject) { $row += 1 }
                 foreach ($TargetData in $InputObject) {
+                    
+                    if ($HeaderName -and $TargetData.psobject.TypeNames[0] -match 'System.String|System.Int32|System.Double|System.Char') {
+                        $TargetData = [PSCustomObject]@{ $HeaderName = $TargetData }
+                    }
+
                     if ($firstTimeThru) {
                         $firstTimeThru = $false
                         $isDataTypeValueType = ($null -eq $TargetData) -or ($TargetData.GetType().name -match 'string|timespan|datetime|bool|byte|char|decimal|double|float|int|long|sbyte|short|uint|ulong|ushort|URI|ExcelHyperLink')
@@ -319,9 +323,7 @@
                                 $ws.Cells[$row, $ColumnIndex].Value = $v
                                 if ($setNumformat) { $ws.Cells[$row, $ColumnIndex].Style.Numberformat.Format = $Numberformat }
                             }
-                            elseif ($v -is [uri] -and
-                                    $NoHyperLinkConversion -ne '*' -and
-                                    $NoHyperLinkConversion -notcontains $Name ) {
+                            elseif ($v -is [uri] ) {
                                 $ws.Cells[$row, $ColumnIndex].HyperLink = $v
                                 $ws.Cells[$row, $ColumnIndex].Style.Font.Color.SetColor([System.Drawing.Color]::Blue)
                                 $ws.Cells[$row, $ColumnIndex].Style.Font.UnderLine = $true
@@ -334,10 +336,7 @@
                                 $ws.Cells[$row, $ColumnIndex].Formula = ($v -replace '^=', '')
                                 if ($setNumformat) { $ws.Cells[$row, $ColumnIndex].Style.Numberformat.Format = $Numberformat }
                             }
-                            elseif ( $NoHyperLinkConversion -ne '*' -and # Put the check for 'NoHyperLinkConversion is null' first to skip checking for wellformedstring
-                                    $NoHyperLinkConversion -notcontains $Name -and
-                                    [System.Uri]::IsWellFormedUriString($v , [System.UriKind]::Absolute)
-                                ) { 
+                            elseif ( [System.Uri]::IsWellFormedUriString($v , [System.UriKind]::Absolute) ) {
                                 if ($v -match "^xl://internal/") {
                                     $referenceAddress = $v -replace "^xl://internal/" , ""
                                     $display = $referenceAddress -replace "!A1$"   , ""
@@ -350,8 +349,8 @@
                             }
                             else {
                                 $number = $null
-                                if ( $NoNumberConversion -ne '*' -and # Check if NoNumberConversion isn't specified. Put this first as it's going to stop the if clause. Quicker than putting regex check first
-                                    $numberRegex.IsMatch($v) -and # and if it contains digit(s) - this syntax is quicker than -match for many items and cuts out slow checks for non numbers
+                                if ( $numberRegex.IsMatch($v) -and # if it contains digit(s) - this syntax is quicker than -match for many items and cuts out slow checks for non numbers
+                                    $NoNumberConversion -ne '*' -and # and NoNumberConversion isn't specified
                                     $NoNumberConversion -notcontains $Name -and
                                     [Double]::TryParse($v, [System.Globalization.NumberStyles]::Any, [System.Globalization.NumberFormatInfo]::CurrentInfo, [Ref]$number)
                                 ) {
@@ -431,7 +430,7 @@
         if ($null -ne $TableName -or $PSBoundParameters.ContainsKey('TableStyle')) {
             #Already inserted Excel table if input was a DataTable
             if ($InputObject -isnot [System.Data.DataTable]) {
-                Add-ExcelTable -Range $ws.Cells[$dataRange] -TableName $TableName -TableStyle $TableStyle -TableTotalSettings $TableTotalSettings
+                Add-ExcelTable -Range $ws.Cells[$dataRange] -TableName $TableName -TableStyle $TableStyle
             }
         }
         elseif ($AutoFilter) {
@@ -500,7 +499,7 @@
             }
             elseif ($FreezeTopRow) {
                 if ($Title) {
-                    $ws.View.FreezePanes(3, 1)
+                    $ws.View.FreezePanes(2, 1)
                     Write-Verbose -Message "Froze title and header rows"
                 }
                 else {
@@ -643,9 +642,9 @@
                 }
                 elseif ($c.formatter) {
                     switch ($c.formatter) {
-                        "ThreeIconSet" { Add-ConditionalFormatting -Worksheet $ws -ThreeIconsSet $c.IconType -range $c.range -reverse:$c.reverse -ShowIconOnly:$c.ShowIconOnly}
-                        "FourIconSet" { Add-ConditionalFormatting -Worksheet $ws  -FourIconsSet $c.IconType -range $c.range -reverse:$c.reverse -ShowIconOnly:$c.ShowIconOnly}
-                        "FiveIconSet" { Add-ConditionalFormatting -Worksheet $ws  -FiveIconsSet $c.IconType -range $c.range -reverse:$c.reverse -ShowIconOnly:$c.ShowIconOnly}
+                        "ThreeIconSet" { Add-ConditionalFormatting -Worksheet $ws -ThreeIconsSet $c.IconType -range $c.range -reverse:$c.reverse }
+                        "FourIconSet" { Add-ConditionalFormatting -Worksheet $ws  -FourIconsSet $c.IconType -range $c.range -reverse:$c.reverse }
+                        "FiveIconSet" { Add-ConditionalFormatting -Worksheet $ws  -FiveIconsSet $c.IconType -range $c.range -reverse:$c.reverse }
                     }
                     Write-Verbose -Message "Added conditional formatting to range $($c.range)"
                 }

Public/Get-ExcelFileSchema.ps1

@@ -1,47 +0,0 @@
-function Get-ExcelFileSchema {
-    <#
-        .SYNOPSIS
-            Gets the schema of an Excel file.
-
-        .DESCRIPTION
-            The Get-ExcelFileSchema function gets the schema of an Excel file by returning the property names of the first row of each worksheet in the file.
-
-        .PARAMETER Path
-            Specifies the path to the Excel file.
-
-        .PARAMETER Compress
-            Indicates whether to compress the json output.
-
-        .OUTPUTS
-            Json
-
-        .EXAMPLE
-            Get-ExcelFileSchema -Path .\example.xlsx
-    #>
-
-    [CmdletBinding()]
-    param(
-        [Parameter(ValueFromPipelineByPropertyName, Mandatory)]
-        [Alias('FullName')]    
-        $Path,
-        [Switch]$Compress
-    )
-
-    Begin {
-        $result = @()
-    }
-
-    Process {        
-        $excelFiles = Get-ExcelFileSummary $Path
-        
-        foreach ($excelFile in $excelFiles) {
-            $data = Import-Excel $Path -WorksheetName $excelFile.WorksheetName | Select-Object -First 1
-            $names = $data[0].PSObject.Properties.name
-            $result += $excelFile | Add-Member -MemberType NoteProperty -Name "PropertyNames" -Value $names -PassThru
-        }
-    }
-
-    End {
-        $result | ConvertTo-Json -Compress:$Compress
-    }
-}

Public/Get-ExcelFileSummary.ps1

@@ -16,7 +16,6 @@ function Get-ExcelFileSummary {
             [PSCustomObject][Ordered]@{
                 ExcelFile     = Split-Path -Leaf $Path
                 WorksheetName = $workSheet.Name
-                Visible       = $workSheet.Hidden -eq 'Visible'
                 Rows          = $workSheet.Dimension.Rows
                 Columns       = $workSheet.Dimension.Columns
                 Address       = $workSheet.Dimension.Address

Public/Import-Excel.ps1

@@ -23,7 +23,7 @@
         [Parameter(ParameterSetName = 'PackageC', Mandatory)]
         [Switch]$NoHeader     ,
         [Alias('HeaderRow', 'TopRow')]
-        [ValidateRange(1, 1048576)]
+        [ValidateRange(1, 9999)]
         [Int]$StartRow = 1,
         [Alias('StopRow', 'BottomRow')]
         [Int]$EndRow ,

Public/New-ConditionalFormattingIconSet.ps1

@@ -1,12 +1,11 @@
 function New-ConditionalFormattingIconSet {
-    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification = 'Does not change system State')]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '',Justification='Does not change system State')]
     param(
-        [Parameter(Mandatory = $true)]
+        [Parameter(Mandatory=$true)]
         $Range,
-        [ValidateSet("ThreeIconSet", "FourIconSet", "FiveIconSet")]
+        [ValidateSet("ThreeIconSet","FourIconSet","FiveIconSet")]
         $ConditionalFormat,
-        [Switch]$Reverse,
-        [Switch]$ShowIconOnly
+        [Switch]$Reverse
     )
 
     DynamicParam {
@@ -41,14 +40,13 @@ function New-ConditionalFormattingIconSet {
 
     End {
 
-        $bp = @{} + $PSBoundParameters
+        $bp = @{}+$PSBoundParameters
 
         $obj = [PSCustomObject]@{
-            Range        = $Range
-            Formatter    = $ConditionalFormat
-            IconType     = $bp.IconType
-            Reverse      = $Reverse
-            ShowIconOnly = $ShowIconOnly
+            Range     = $Range
+            Formatter = $ConditionalFormat
+            IconType  = $bp.IconType
+            Reverse   = $Reverse
         }
 
         $obj.pstypenames.Clear()

Public/Set-CellComment.ps1

@@ -1,70 +0,0 @@
-[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Scope='Function', Target='Set*', Justification='Does not change system state')]
-param()
-
-function Set-CellComment {
-    [CmdletBinding(DefaultParameterSetName = "Range")]
-    param(
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnLetter")]
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnNumber")]
-        [Parameter(Mandatory = $False, ParameterSetName = "Range")]
-        [OfficeOpenXml.ExcelWorkSheet]$Worksheet,
-
-        [Parameter(Mandatory = $True, ParameterSetName = "Range", ValueFromPipeline = $true,Position=0)]
-        [Alias("Address")]
-        $Range,
-
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnLetter")]
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnNumber")]
-        [Int]$Row,
-
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnLetter")]
-        [String]$ColumnLetter,
-
-        [Parameter(Mandatory = $True, ParameterSetName = "ColumnNumber")]
-        [Int]$ColumnNumber,
-
-        [Parameter(Mandatory = $True)]
-        [String]$Text
-    )
-
-    If ($PSCmdlet.ParameterSetName -eq "Range") {
-        Write-Verbose "Using 'Range' Parameter Set"
-        if  ($Range -is [Array])  {
-            $null = $PSBoundParameters.Remove("Range")
-            $Range | Set-CellComment @PSBoundParameters
-        }
-        else {
-            #We should accept, a worksheet and a name of a range or a cell address; a table; the address of a table; a named range; a row, a column or .Cells[ ]
-            if ($Range -is [OfficeOpenXml.Table.ExcelTable]) {$Range = $Range.Address}
-            elseif ($Worksheet -and $Range -is [string]) {
-                # Convert range as string to OfficeOpenXml.ExcelAddress
-                $Range = [OfficeOpenXml.ExcelAddress]::new($Range)
-            }
-            elseif ($Range -is [string]) {Write-Warning -Message "The range parameter you have specified also needs a worksheet parameter." ;return}
-            #else we assume $Range is a OfficeOpenXml.ExcelAddress
-        }
-    }
-    ElseIf ($PSCmdlet.ParameterSetName -eq "ColumnNumber") {
-        $Range = [OfficeOpenXml.ExcelAddress]::new($Row, $ColumnNumber, $Row, $ColumnNumber)
-    }
-    ElseIf ($PSCmdlet.ParameterSetName -eq "ColumnLetter") {
-        $Range = [OfficeOpenXml.ExcelAddress]::new(("{0}{1}" -f $ColumnLetter,$Row))
-    }
-
-    If  ($Range -isnot [Array])  {
-        Foreach ($c in $Worksheet.Cells[$Range]) {
-            write-verbose $c.address
-            Try {
-                If ($Null -eq $c.comment) {
-                    [Void]$c.AddComment($Text, "ImportExcel")
-                }
-                Else {
-                    $c.Comment.Text = $Text
-                    $c.Comment.Author = "ImportExcel"
-                }
-                $c.Comment.AutoFit = $True
-            }
-            Catch { "Could not add comment to cell {0}: {1}" -f $c.Address, $_.ToString() }
-        }
-    }
-}

Public/Set-ExcelRange.ps1

@@ -58,7 +58,7 @@
             elseif ($Worksheet -and ($Range -is [string] -or $Range -is [OfficeOpenXml.ExcelAddress])) {
                 $Range = $Worksheet.Cells[$Range]
             }
-            elseif ($Range -is [string]) {Write-Warning -Message "The range parameter you have specified also needs a worksheet parameter." ;return}
+            elseif ($Range -is [string]) {Write-Warning -Message "The range pararameter you have specified also needs a worksheet parameter." ;return}
             #else we assume $Range is a range.
             if ($ClearAll)  {
                 $Range.Clear()

README.md

@@ -4,33 +4,15 @@
 
 <br/>
 
-Has the ImportExcel module helped you?
-- Made you look good to the boss?
-- Saved you time?
-- Made you more productive?
-
-Consider donating. Thank you!
-<br>
-<br>
-<a href="https://www.paypal.com/paypalme/DougCharlesFinke"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg" alt="Donate" height="28"></a>
-<br>
-<br>
-![](https://media.giphy.com/media/hpXxJ78YtpT0s/giphy.gif)
-<br>
-<br>
-
-[![Follow on Twitter](https://img.shields.io/twitter/follow/dfinke.svg?style=social&label=Follow%20%40dfinke)](https://twitter.com/dfinke)
-[![Subscribe on YouTube](https://img.shields.io/youtube/channel/subscribers/UCP47ZkO5EDkoI2sr-3P4ShQ
-)](https://youtube.com/@dougfinke/)
-<br/>
-<br/>
+[![Build Status](https://dougfinke.visualstudio.com/ImportExcel/_apis/build/status/dfinke.ImportExcel?branchName=master)](https://dougfinke.visualstudio.com/ImportExcel/_build)
 [![](https://img.shields.io/powershellgallery/v/ImportExcel.svg)](https://www.powershellgallery.com/packages/ImportExcel)
 [![](https://img.shields.io/powershellgallery/dt/ImportExcel.svg)](https://www.powershellgallery.com/packages/ImportExcel)
+[![](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/dfinke/ImportExcel/tree/70ab9e46c776e96fb287682d5b9b4b51a0ec3bac/LICENSE.txt)
 <a href="https://www.paypal.com/paypalme/DougCharlesFinke"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg" alt="Donate"></a>
 
 # Overview
 
-Automate Excel with PowerShell without having Excel installed. Works on Windows, Linux and Mac. Creating Tables, Pivot Tables, Charts and much more just got a lot easier.
+Automate Excel with PowerShell without having Excel installed. Works on Windows, Linux and MAC. Creating Tables, Pivot Tables, Charts and much more just got a lot easier.
 
 ## Examples ✨
 Check out the [more than 100 examples](Examples/) on ways to create amazing reports as well as make you more productive with PowerShell and Excel.

__tests__/Export-Excel.Tests.ps1

@@ -1,4 +1,4 @@
-#Requires -Modules @{ ModuleName="Pester"; ModuleVersion="4.0.0" }
+#Requires -Modules Pester
 [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', '', Justification = 'False Positives')]
 [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidAssignmentToAutomaticVariable', '', Justification = 'Only executes on versions without the automatic variable')]
 param()
@@ -205,7 +205,7 @@ Describe ExportExcel -Tag "ExportExcel" {
             else { $OtherCurrencySymbol = "£" }
             $path = "TestDrive:\test.xlsx"
             $warnVar = $null
-            #Test correct export of different data types and number formats; test hyperlinks, test -NoNumberConversion and -NoHyperLinkConversion test object is converted to a string with no warnings, test calcuation of formula
+            #Test correct export of different data types and number formats; test hyperlinks, test -NoNumberConversion test object is converted to a string with no warnings, test calcuation of formula
             Remove-item -Path $path -ErrorAction SilentlyContinue
             [PSCustOmobject][Ordered]@{
                 Date             = Get-Date
@@ -233,10 +233,9 @@ Describe ExportExcel -Tag "ExportExcel" {
                 Link3            = "xl://internal/sheet1!A1"
                 Link4            = "xl://internal/sheet1!C5"
                 Link5            = (New-Object -TypeName OfficeOpenXml.ExcelHyperLink -ArgumentList "Sheet1!E2" , "Display Text")
-                Link6            = "xl://internal/sheet1!C5"
                 Process          = (Get-Process -Id $PID)
                 TimeSpan         = [datetime]::Now.Subtract([datetime]::Today)
-            } | Export-Excel  -NoNumberConversion IPAddress, StrLeadZero, StrAltPhone2 -NoHyperLinkConversion Link6 -Path $path -Calculate -WarningVariable $warnVar
+            } | Export-Excel  -NoNumberConversion IPAddress, StrLeadZero, StrAltPhone2  -Path $path -Calculate -WarningVariable $warnVar
         }
 
         BeforeEach {
@@ -254,7 +253,7 @@ Describe ExportExcel -Tag "ExportExcel" {
         }
         it "Created the worksheet with the expected name, number of rows and number of columns     " {
             $ws.Name                                                    | Should      -Be "sheet1"
-            $ws.Dimension.Columns                                       | Should      -Be  28
+            $ws.Dimension.Columns                                       | Should      -Be  27
             $ws.Dimension.Rows                                          | Should      -Be  2
         }
         it "Set a date     in Cell A2                                                              " {
@@ -293,9 +292,6 @@ Describe ExportExcel -Tag "ExportExcel" {
             $ws.Cells[2, 25].Hyperlink.ReferenceAddress                | Should      -Be  "sheet1!E2"
             $ws.Cells[2, 25].Hyperlink.Display                         | Should      -Be  "Display Text"
         }
-        it "Create no link in cell Z2 (no hyperlink conversion)                                    " {
-            $ws.Cells[2, 26].Hyperlink                                 | Should      -BeNullOrEmpty
-        }
         it "Processed thousands according to local settings   (Cells H2 and I2)                    " {
             if ((Get-Culture).NumberFormat.NumberGroupSeparator -EQ ",") {
                 ($ws.Cells[2, 8].Value -is [valuetype] )               | Should      -Be  $true
@@ -318,13 +314,13 @@ Describe ExportExcel -Tag "ExportExcel" {
             ($ws.Cells[2, 19].Value -is [valuetype] )                   | Should      -Be  $true
             ($ws.Cells[2, 20].Value -is [valuetype] )                   | Should      -Be  $true
         }
-        it "Converted a nested object to a string (AA2)                                            " {
-            $ws.Cells[2, 27].Value                                     | Should      -Match '^System\.Diagnostics\.Process\s+\(.*\)$'
+        it "Converted a nested object to a string (Y2)                                             " {
+            $ws.Cells[2, 26].Value                                     | Should      -Match '^System\.Diagnostics\.Process\s+\(.*\)$'
         }
-        it "Processed a timespan object (AB2)                                                      " {
-            $ws.cells[2, 28].Value.ToOADate()                          | Should      -BeGreaterThan 0
-            $ws.cells[2, 28].Value.ToOADate()                          | Should      -BeLessThan    1
-            $ws.cells[2, 28].Style.Numberformat.Format                 | Should      -Be  '[h]:mm:ss'
+        it "Processed a timespan object (Z2)                                                       " {
+            $ws.cells[2, 27].Value.ToOADate()                          | Should      -BeGreaterThan 0
+            $ws.cells[2, 27].Value.ToOADate()                          | Should      -BeLessThan    1
+            $ws.cells[2, 27].Style.Numberformat.Format                 | Should      -Be  '[h]:mm:ss'
         }
     }
 
@@ -348,9 +344,8 @@ Describe ExportExcel -Tag "ExportExcel" {
                 PhoneNr1  = '+32 44'
                 PhoneNr2  = '+32 4 4444 444'
                 PhoneNr3  = '+3244444444'
-                Link1     = [uri]"https://github.com/dfinke/ImportExcel"
-                Link2     = [uri]"https://github.com/dfinke/ImportExcel"
-            } | Export-Excel -NoHyperLinkConversion Link2 -NoNumberConversion IPAddress, Number1  -Path $path -NoHeader
+                Link      = [uri]"https://github.com/dfinke/ImportExcel"
+            } | Export-Excel  -NoNumberConversion IPAddress, Number1  -Path $path -NoHeader
         }
 
         BeforeEach {
@@ -368,7 +363,7 @@ Describe ExportExcel -Tag "ExportExcel" {
 
         it "Created the worksheet with the expected name, number of rows and number of columns     " {
             $ws.Name                                                    | Should      -Be "sheet1"
-            $ws.Dimension.Columns                                       | Should      -Be  15
+            $ws.Dimension.Columns                                       | Should      -Be  14
             $ws.Dimension.Rows                                          | Should      -Be  1
         }
 
@@ -392,10 +387,6 @@ Describe ExportExcel -Tag "ExportExcel" {
         it "Set a hyperlink in Cell N1                                                             " {
             $ws.Cells[1, 14].Hyperlink                                   | Should      -Be  "https://github.com/dfinke/ImportExcel"
         }
-
-        it "Does not set a hyperlink in Cell O1                                                    " {
-            $ws.Cells[1, 15].Hyperlink                                   | Should      -BeNullOrEmpty
-        }
     }
 
     Context "#Example 5      # Adding a single conditional format " {
@@ -692,72 +683,6 @@ Describe ExportExcel -Tag "ExportExcel" {
         }
     }
 
-    Context "#Example 10     # Creates a file with a table with a 'totals' row".PadRight(87) {
-        BeforeEach {
-            $path = "TestDrive:\test.xlsx"
-            Remove-item -Path $path -ErrorAction SilentlyContinue
-            
-            #Test with a maximum of 50 processes for speed; export limited set of properties.
-            $processes = Get-Process | Where-Object { $_.StartTime } | Select-Object -First 50
-
-            # Export as table with a totals row with a set of possibilities
-            $TableTotalSettings = @{ 
-                Id      = "COUNT"
-                WS      = "SUM"
-                Handles = "AVERAGE"
-                CPU     = '=COUNTIF([CPU];"<1")'
-                NPM     = @{
-                    Function = '=SUMIF([Name];"=Chrome";[NPM])'
-                    Comment  = "Sum of Non-Paged Memory (NPM) for all chrome processes"
-                }
-            }
-            $Processes | Export-Excel $path -TableName "processes" -TableTotalSettings $TableTotalSettings
-            $TotalRows = $Processes.count + 2 # Column header + Data (50 processes) + Totals row
-            $Excel = Open-ExcelPackage -Path $path
-            $ws = $Excel.Workbook.Worksheets[1]
-        }
-
-        it "Totals row was created".PadRight(87) {
-            $ws.Tables[0].Address.Rows                                          | Should -Be $TotalRows
-            $ws.tables[0].ShowTotal                                             | Should -Be $True
-        }
-        
-        it "Added four calculations in the totals row".PadRight(87) {
-            $IDcolumn = $ws.Tables[0].Columns | Where-Object { $_.Name -eq "id" }
-            $WScolumn = $ws.Tables[0].Columns | Where-Object { $_.Name -eq "WS" }
-            $HandlesColumn = $ws.Tables[0].Columns | Where-Object { $_.Name -eq "Handles" }
-            $CPUColumn = $ws.Tables[0].Columns | Where-Object { $_.Name -eq "CPU" }
-            $NPMColumn = $ws.Tables[0].Columns | Where-Object { $_.Name -eq "NPM" }
-
-            # Testing column properties
-            $IDcolumn      | Select-Object -ExpandProperty TotalsRowFunction    | Should -Be "Count"
-            $WScolumn      | Select-Object -ExpandProperty TotalsRowFunction    | Should -Be "Sum"
-            $HandlesColumn | Select-Object -ExpandProperty TotalsRowFunction    | Should -Be "Average"
-            $CPUColumn     | Select-Object -ExpandProperty TotalsRowFunction    | Should -Be "Custom"
-            $CPUColumn     | Select-Object -ExpandProperty TotalsRowFormula     | Should -Be 'COUNTIF([CPU],"<1")'
-            $NPMColumn     | Select-Object -ExpandProperty TotalsRowFunction    | Should -Be "Custom"
-            $NPMColumn     | Select-Object -ExpandProperty TotalsRowFormula     | Should -Be 'SUMIF([Name],"=Chrome",[NPM])'
-
-            # Testing actual cell properties
-            $CountAddress = "{0}{1}" -f (Get-ExcelColumnName -ColumnNumber $IDcolumn.Id).ColumnName, $TotalRows
-            $SumAddress = "{0}{1}" -f (Get-ExcelColumnName -ColumnNumber $WScolumn.Id).ColumnName, $TotalRows
-            $AverageAddress = "{0}{1}" -f (Get-ExcelColumnName -ColumnNumber $HandlesColumn.Id).ColumnName, $TotalRows
-            $CustomAddress = "{0}{1}" -f (Get-ExcelColumnName -ColumnNumber $CPUColumn.Id).ColumnName, $TotalRows
-            $CustomCommentAddress = "{0}{1}" -f (Get-ExcelColumnName -ColumnNumber $NPMColumn.Id).ColumnName, $TotalRows
-
-            $ws.Cells[$CountAddress].Formula                                    | Should      -Be "SUBTOTAL(103,processes[Id])"
-            $ws.Cells[$SumAddress].Formula                                      | Should      -Be "SUBTOTAL(109,processes[Ws])"
-            $ws.Cells[$AverageAddress].Formula                                  | Should      -Be "SUBTOTAL(101,processes[Handles])"
-            $ws.Cells[$CustomAddress].Formula                                   | Should      -Be 'COUNTIF([CPU],"<1")'
-            $ws.Cells[$CustomCommentAddress].Formula                            | Should      -Be 'SUMIF([Name],"=Chrome",[NPM])'
-            $ws.Cells[$CustomCommentAddress].Comment.Text                       | Should -Not -BeNullOrEmpty
-        }
-
-        AfterEach {
-            Close-ExcelPackage -ExcelPackage $Excel
-        }
-    }
-
     # Context "#Example 11     # Create and append with title, inc ranges and Pivot table" {
     #     $path = "TestDrive:\test.xlsx"
     #     #Test New-PivotTableDefinition builds definition using -Pivotfilter and -PivotTotals options.
@@ -770,13 +695,7 @@ Describe ExportExcel -Tag "ExportExcel" {
             $path = "TestDrive:\test.xlsx"
             Remove-Item $path -ErrorAction SilentlyContinue
             #Test freezing top row/first column, adding formats and a pivot table - from Add-Pivot table not a specification variable - after the export
-            $Ex13Data = Get-Process | Select-Object -Property Name, Company, Handles, CPU, PM, NPM, WS
-            $excel = $Ex13Data | Export-Excel -Path $path -ClearSheet -WorkSheetname "Processes" -FreezeTopRowFirstColumn -PassThru
-            # Add extra worksheets for testing 'Freeze Top Row' and 'Freeze First Column' with or without title
-            $excel = Export-Excel -InputObject $Ex13Data -ExcelPackage $excel -WorksheetName "FreezeTopRow" -FreezeTopRow -Passthru
-            $excel = Export-Excel -InputObject $Ex13Data -ExcelPackage $excel -WorksheetName "FreezeFirstColumn" -FreezeFirstColumn -Passthru
-            $excel = Export-Excel -InputObject $Ex13Data -Title "Freeze Top Row" -ExcelPackage $excel -WorksheetName "FreezeTopRowTitle" -FreezeTopRow -Passthru
-            $excel = Export-Excel -InputObject $Ex13Data -Title "Freeze Top Row First Column" -ExcelPackage $excel -WorksheetName "FreezeTRFCTitle" -FreezeTopRowFirstColumn -Passthru
+            $excel = Get-Process | Select-Object -Property Name, Company, Handles, CPU, PM, NPM, WS | Export-Excel -Path $path -ClearSheet -WorkSheetname "Processes" -FreezeTopRowFirstColumn -PassThru
             $sheet = $excel.Workbook.Worksheets["Processes"]
             if ($isWindows) { $sheet.Column(1) | Set-ExcelRange -Bold -AutoFit }
             else { $sheet.Column(1) | Set-ExcelRange -Bold }
@@ -796,10 +715,6 @@ Describe ExportExcel -Tag "ExportExcel" {
 
             $excel = Open-ExcelPackage $path
             $sheet = $excel.Workbook.Worksheets["Processes"]
-            $sheetftr = $excel.Workbook.Worksheets["FreezeTopRow"]
-            $sheetffc = $excel.Workbook.Worksheets["FreezeFirstColumn"]
-            $sheetftrt = $excel.Workbook.Worksheets["FreezeTopRowTitle"]
-            $sheetftrfct = $excel.Workbook.Worksheets["FreezeTRFCTitle"]
         }
         it "Returned the rule when calling Add-ConditionalFormatting -passthru                     " {
             $rule                                                       | Should -Not -BeNullOrEmpty
@@ -846,27 +761,7 @@ Describe ExportExcel -Tag "ExportExcel" {
             $sheet.Names[6].Name                                        | Should      -Be $sheet.Cells['G1'].Value
         }
         it "Froze the panes                                                                        " {
-            $sheetPaneInfo = $sheet.worksheetxml.worksheet.sheetViews.sheetView.pane
-            $sheetftrPaneInfo = $sheetftr.worksheetxml.worksheet.sheetViews.sheetView.pane
-            $sheetffcPaneInfo = $sheetffc.worksheetxml.worksheet.sheetViews.sheetView.pane
-            $sheetftrtPaneInfo = $sheetftrt.worksheetxml.worksheet.sheetViews.sheetView.pane
-            $sheetftrfctPaneInfo = $sheetftrfct.worksheetxml.worksheet.sheetViews.sheetView.pane
-            $sheet.view.Panes.Count                                     | Should      -Be 3 # Don't know if this actually checks anything
-            $sheetPaneInfo.xSplit                                       | Should      -Be 1
-            $sheetPaneInfo.ySplit                                       | Should      -Be 1
-            $sheetPaneInfo.topLeftCell                                  | Should      -Be "B2"
-            $sheetftrPaneInfo.xSplit                                    | Should      -BeNullOrEmpty
-            $sheetftrPaneInfo.ySplit                                    | Should      -Be 1
-            $sheetftrPaneInfo.topLeftCell                               | Should      -Be "A2"
-            $sheetffcPaneInfo.xSplit                                    | Should      -Be 1
-            $sheetffcPaneInfo.ySplit                                    | Should      -BeNullOrEmpty
-            $sheetffcPaneInfo.topLeftCell                               | Should      -Be "B1"
-            $sheetftrtPaneInfo.xSplit                                   | Should      -BeNullOrEmpty
-            $sheetftrtPaneInfo.ySplit                                   | Should      -Be 2
-            $sheetftrtPaneInfo.topLeftCell                              | Should      -Be "A3"
-            $sheetftrfctPaneInfo.xSplit                                 | Should      -Be 1
-            $sheetftrfctPaneInfo.ySplit                                 | Should      -Be 2
-            $sheetftrfctPaneInfo.topLeftCell                            | Should      -Be "B3"
+            $sheet.view.Panes.Count                                     | Should      -Be 3
         }
 
         it "Created the pivot table                                                                " {
@@ -1237,120 +1132,4 @@ Describe ExportExcel -Tag "ExportExcel" {
             Close-ExcelPackage $excel -NoSave            
         }        
     }
-
-    It "Should have hyperlink created" -Tag hyperlink {
-        $path = "TestDrive:\testHyperLink.xlsx"
-        
-        $license = "cognc:MCOMEETADV_GOV,cognc:M365_G3_GOV,cognc:ENTERPRISEPACK_GOV,cognc:RIGHTSMANAGEMENT_ADHOC"
-        $ms365 = [PSCustomObject]@{
-            DisplayName       = "Test Subject"
-            UserPrincipalName = "test@contoso.com"
-            licenses          = $license
-        }
-
-        $ms365 | Export-Excel $path
-
-        $excel = Open-ExcelPackage $Path
-        
-        $ws = $excel.Sheet1
-        
-        $ws.Dimension.Rows    | Should -Be 2
-        $ws.Dimension.Columns | Should -Be 3
-
-        $ws.Cells["C2"].Hyperlink | Should -BeExactly $license
-
-        Close-ExcelPackage $excel
-
-        Remove-Item $path
-    }
-
-    It "Should have no hyperlink created" -Tag hyperlink {
-        $path = "TestDrive:\testHyperLink.xlsx"
-
-        $license = "cognc:MCOMEETADV_GOV,cognc:M365_G3_GOV,cognc:ENTERPRISEPACK_GOV,cognc:RIGHTSMANAGEMENT_ADHOC"
-        $ms365 = [PSCustomObject]@{
-            DisplayName       = "Test Subject"
-            UserPrincipalName = "test@contoso.com"
-            licenses          = $license
-        }
-
-        $ms365 | Export-Excel $path -NoHyperLinkConversion licenses
-
-        $excel = Open-ExcelPackage $Path
-
-        $ws = $excel.Sheet1
-        
-        $ws.Dimension.Rows    | Should -Be 2
-        $ws.Dimension.Columns | Should -Be 3
-
-        $ws.Cells["C2"].Hyperlink | Should -BeNullOrEmpty
-
-        Close-ExcelPackage $excel
-        Remove-Item $path
-    }
-
-    It "Should have no hyperlink created using wild card" -Tag hyperlink {
-        $path = "TestDrive:\testHyperLink.xlsx"
-
-        $license = "cognc:MCOMEETADV_GOV,cognc:M365_G3_GOV,cognc:ENTERPRISEPACK_GOV,cognc:RIGHTSMANAGEMENT_ADHOC"
-        $ms365 = [PSCustomObject]@{
-            DisplayName       = "Test Subject"
-            UserPrincipalName = "test@contoso.com"
-            licenses          = $license
-        }
-
-        $ms365 | Export-Excel $path -NoHyperLinkConversion *
-
-        $excel = Open-ExcelPackage $Path
-
-        $ws = $excel.Sheet1
-        
-        $ws.Dimension.Rows    | Should -Be 2
-        $ws.Dimension.Columns | Should -Be 3
-
-        $ws.Cells["A2"].Value | Should -BeExactly "Test Subject"
-        $ws.Cells["B2"].Value | Should -BeExactly "test@contoso.com" 
-        $ws.Cells["C2"].Hyperlink | Should -BeNullOrEmpty
-
-        Close-ExcelPackage $excel
-        Remove-Item $path
-    }
-
-    It "Should freeze the correct rows" -tag Freeze {
-        <#
-            Export-Excel -InputObject $Data -Path $OutputFile -TableName $SheetName.Replace(' ', '_') -WorksheetName $SheetName -AutoSize -FreezeTopRow -TableStyle $TableStyle -Title $SheetName -TitleBold -TitleSize 18
-        #>
-
-        $path = "TestDrive:\testFreeze.xlsx"
-        
-        $data = ConvertFrom-Csv @"
-        Region,State,Units,Price
-        West,Texas,927,923.71
-        North,Tennessee,466,770.67
-        East,Florida,520,458.68
-        East,Maine,828,661.24
-        West,Virginia,465,053.58
-        North,Missouri,436,235.67
-        South,Kansas,214,992.47
-        North,North Dakota,789,640.72
-        South,Delaware,712,508.55
-"@
-
-        Export-Excel -InputObject $data -Path $path -TableName 'TestTable' -WorksheetName 'TestSheet' -AutoSize -TableStyle Medium2 -Title 'Test Title' -TitleBold -TitleSize 18 -FreezeTopRow 
-
-        $excel = Open-ExcelPackage -Path $path
-        $ws = $excel.TestSheet
-
-        $r = $ws.worksheetxml.worksheet.sheetViews.sheetView.pane
-
-        $r | Should -Not -BeNullOrEmpty
-        $r.ySplit | Should -Be 2
-        $r.topLeftCell | Should -BeExactly 'A3'
-        $r.state | Should -BeExactly 'frozen'
-        $r.activePane | Should -BeExactly 'bottomLeft'
-
-        Close-ExcelPackage $excel
-
-        Remove-Item $path 
-    }
 }

__tests__/Get-ExcelFileSchema.tests.ps1

@@ -1,54 +0,0 @@
-if (-not (Get-command Import-Excel -ErrorAction SilentlyContinue)) {
-    Import-Module $PSScriptRoot\..\ImportExcel.psd1
-}
-
-Describe "Test getting the schema of an Excel file" -Tag GetExcelFileSchema {
-
-    BeforeAll {
-        $script:excelFile = "TestDrive:\test.xlsx"
-        $data = ConvertFrom-Csv @"
-Region,State,Units,Price
-West,Texas,927,923.71
-North,Tennessee,466,770.67
-East,Florida,520,458.68
-East,Maine,828,661.24
-West,Virginia,465,053.58
-North,Missouri,436,235.67
-South,Kansas,214,992.47
-North,North Dakota,789,640.72
-South,Delaware,712,508.55
-"@
-        $data | Export-Excel $excelFile 
-    }
-
-    It "Test Get-ExcelFileSchema function exists" {        
-        $function = Get-Command Get-ExcelFileSchema -ErrorAction SilentlyContinue
-        $function | Should -Not -Be $null
-    }
-
-    It "Test Get-ExcelFileSchema returns json" {
-        $actual = Get-ExcelFileSchema -Path $excelFile
-        $actual | Should -Not -Be $null
-        $actual | Should -BeOfType [string]        
-    }
-
-    It "Test Get-ExcelFileSchema correct json" {
-        $actual = Get-ExcelFileSchema -Path $excelFile
-        $actual = $actual | ConvertFrom-Json 
-
-        $actual.ExcelFile | Should -BeExactly "test.xlsx"
-        $actual.WorksheetName | Should -BeExactly "Sheet1"
-        $actual.Visible | Should -Be $true
-        $actual.Rows | Should -Be 10
-        $actual.Columns | Should -Be 4
-        $actual.Address | Should -BeExactly "A1:D10"
-        
-        $actual.Path | Should -BeExactly ("TestDrive:" + [System.IO.Path]::DirectorySeparatorChar)
-        
-        $actual.PropertyNames.Count | Should -Be 4
-        $actual.PropertyNames[0] | Should -BeExactly "Region"
-        $actual.PropertyNames[1] | Should -BeExactly "State"
-        $actual.PropertyNames[2] | Should -BeExactly "Units"
-        $actual.PropertyNames[3] | Should -BeExactly "Price"
-    }
-}

__tests__/Get-ExcelFileSummary.Tests.ps1

@@ -3,7 +3,9 @@
 [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidAssignmentToAutomaticVariable', '', Justification = 'Only executes on versions without the automatic variable')]
 param()
 
-Import-Module $PSScriptRoot\..\ImportExcel.psd1 -Force
+if (-not (Get-command Import-Excel -ErrorAction SilentlyContinue)) {
+    Import-Module $PSScriptRoot\..\ImportExcel.psd1
+}
 
 Describe 'All tests for Get-ExcelFileSummary' -Tag "Get-ExcelFileSummary" {
     Context "Test Get-ExcelFileSummary" {
@@ -12,7 +14,6 @@ Describe 'All tests for Get-ExcelFileSummary' -Tag "Get-ExcelFileSummary" {
 
             $actual.ExcelFile | Should -BeExactly 'TestData1.xlsx'
             $actual.WorksheetName | Should -BeExactly 'Sheet1'
-            $actual.Visible | Should -BeTrue
             $actual.Rows | Should -Be 3
             $actual.Columns | Should -Be 2
             $actual.Address | Should -BeExactly 'A1:B3'
@@ -25,7 +26,6 @@ Describe 'All tests for Get-ExcelFileSummary' -Tag "Get-ExcelFileSummary" {
 
             $actual[0].ExcelFile | Should -BeExactly 'MultipleSheets.xlsx'
             $actual[0].WorksheetName | Should -BeExactly 'Sheet1'
-            $actual[0].Visible | Should -BeTrue
             $actual[0].Rows | Should -Be 1
             $actual[0].Columns | Should -Be 4
             $actual[0].Address | Should -BeExactly 'A1:D1'
@@ -33,20 +33,11 @@ Describe 'All tests for Get-ExcelFileSummary' -Tag "Get-ExcelFileSummary" {
 
             $actual[1].ExcelFile | Should -BeExactly 'MultipleSheets.xlsx'
             $actual[1].WorksheetName | Should -BeExactly 'Sheet2'
-            $actual[1].Visible | Should -BeTrue
             $actual[1].Rows | Should -Be 2
             $actual[1].Columns | Should -Be 2
             $actual[1].Address | Should -BeExactly 'A1:B2'
             $actual[1].Path | Should -Not -BeNullOrEmpty
         }
 
-        It "Tests if sheet is hidden or not" {
-            $actual = Get-ExcelFileSummary "$PSScriptRoot\ImportExcelTests\SheetVisibleTesting.xlsx"
-
-            $actual[0].Visible | Should -BeTrue
-            $actual[1].Visible | Should -BeFalse
-            $actual[2].Visible | Should -BeTrue
-            $actual[3].Visible | Should -BeFalse                       
-        }
     }
 }

__tests__/HeaderName.tests.ps1

@@ -0,0 +1,88 @@
+if (-not (Get-command Import-Excel -ErrorAction SilentlyContinue)) {
+    Import-Module $PSScriptRoot\..\ImportExcel.psd1
+}
+
+Describe "Test HeaderName parameter" -Tag HeaderName {
+    It "Should add data as usual" {
+        $xlfile = "TestDrive:\headername.xlsx"
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+        1..10 | Export-Excel -Path $xlfile
+
+        { Test-Path $xlfile } | Should -BeTrue
+
+        $excel = Open-ExcelPackage $xlfile
+        
+        1..10 | ForEach-Object {
+            $excel.Sheet1.Cells[$_, 1].Text | Should -BeExactly $_
+        }
+
+        Close-ExcelPackage $excel
+
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+    }
+
+    It "Should add data and the first cell should have the header name" {
+        $xlfile = "TestDrive:\headername.xlsx"
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+        1..10 | Export-Excel -Path $xlfile -HeaderName MyNum
+
+        { Test-Path $xlfile } | Should -BeTrue
+
+        $excel = Open-ExcelPackage $xlfile
+
+        $excel.Sheet1.Cells[1, 1].Text | Should -BeExactly "MyNum"
+
+        1..10 | ForEach-Object {
+            $excel.Sheet1.Cells[($_ + 1), 1].Text | Should -BeExactly $_
+        }
+
+        Close-ExcelPackage $excel
+
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+    }
+
+    It "Should ignore the header name" {
+        $data = ConvertFrom-Csv @"
+Region,State,Units,Price
+West,Texas,927,923.71
+North,Tennessee,466,770.67
+East,Florida,520,458.68
+East,Maine,828,661.24
+West,Virginia,465,053.58
+North,Missouri,436,235.67
+South,Kansas,214,992.47
+North,North Dakota,789,640.72
+South,Delaware,712,508.55
+"@
+
+        $xlfile = "TestDrive:\headername.xlsx"
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+        $data | Export-Excel -Path $xlfile -HeaderName MyNum
+
+        { Test-Path $xlfile } | Should -BeTrue
+
+        $excel = Open-ExcelPackage $xlfile
+
+        $excel.Sheet1.Cells[1, 1].Text | Should -BeExactly "Region"
+        $excel.Sheet1.Cells[1, 2].Text | Should -BeExactly "State"
+        $excel.Sheet1.Cells[1, 3].Text | Should -BeExactly "Units"
+        $excel.Sheet1.Cells[1, 4].Text | Should -BeExactly "Price"
+
+        $excel.Sheet1.Cells[2, 1].Text | Should -BeExactly "West"
+        $excel.Sheet1.Cells[2, 2].Text | Should -BeExactly "Texas"
+        $excel.Sheet1.Cells[2, 3].Text | Should -Be 927
+        $excel.Sheet1.Cells[2, 4].Text | Should -Be 923.71
+
+        $excel.Sheet1.Cells[10, 1].Text | Should -BeExactly "South"
+        $excel.Sheet1.Cells[10, 2].Text | Should -BeExactly "Delaware"
+        $excel.Sheet1.Cells[10, 3].Text | Should -Be 712
+        $excel.Sheet1.Cells[10, 4].Text | Should -Be 508.55        
+
+        Close-ExcelPackage $excel
+
+        Remove-Item $xlfile -ErrorAction SilentlyContinue
+    }
+}

__tests__/ImportExcelTests/ImportExcelEndRowEndColumn.tests.ps1

@@ -32,12 +32,6 @@ Describe 'Test' -Tag ImportExcelEndRowAndCols {
             $colNames[0] | Should -Be 'Units'
             $colNames[1] | Should -Be 'Price'
         }
-
-        It 'Should read any row up to maximum allowed row' {
-            $xlMaxRows = "$PSScriptRoot\MaxRows.xlsx"
-            $actual = Import-Excel $xlMaxRows -StartRow 1048576 -EndRow 1048576 -NoHeader
-            $actual.P1 | Should -Be 1048576
-        }
     }
 
     Context 'Test reading multiple sheets with data in differnt rows and columns' {

__tests__/New-ConditionalFormattingIconSet.tests.ps1

@@ -1,66 +0,0 @@
-if (-not (Get-command Import-Excel -ErrorAction SilentlyContinue)) {
-    Import-Module $PSScriptRoot\..\ImportExcel.psd1
-}
-
-Describe "Test New Conditional Formatting IconSet" -Tag ConditionalFormattingIconSet { 
-    BeforeEach {
-        $xlFilename = "TestDrive:\ConditionalFormattingIconSet.xlsx"        
-        Remove-Item $xlFilename -ErrorAction SilentlyContinue
-
-        $data = ConvertFrom-Csv @"
-Region,State,Other,Units,Price,InStock
-West,Texas,1,927,923.71,1
-North,Tennessee,3,466,770.67,0
-East,Florida,0,1520,458.68,1
-East,Maine,1,1828,661.24,0
-West,Virginia,1,465,053.58,1
-North,Missouri,1,436,235.67,1
-South,Kansas,0,214,992.47,1
-North,North Dakota,1,789,640.72,0 
-South,Delaware,-1,712,508.55,1
-"@
-    }
-
-    It "Should set ThreeIconSet" {
-        # $cfi1 = New-ConditionalFormattingIconSet -Range C:C -ConditionalFormat ThreeIconSet -IconType Symbols -ShowIconOnly
-        $cfi1 = New-ConditionalFormattingIconSet -Range C:C -ConditionalFormat ThreeIconSet -IconType Symbols
-
-        $data | Export-Excel $xlFilename -ConditionalFormat $cfi1
-        $actual = Import-Excel $xlFilename
-        $actual.count | Should -Be 9
-
-        $xl = Open-ExcelPackage $xlFilename
-        $xl.Workbook.Worksheets.Count | Should -Be 1
-        $targetSheet = $xl.Workbook.Worksheets[1]
-        
-        $targetSheet.Name | Should -Be "Sheet1"
-        $targetSheet.ConditionalFormatting.Count | Should -Be 1
-        $targetSheet.ConditionalFormatting[0].Type | Should -Be "ThreeIconSet"
-        $targetSheet.ConditionalFormatting[0].IconSet | Should -Be "Symbols"
-        $targetSheet.ConditionalFormatting[0].Reverse | Should -BeFalse
-        $targetSheet.ConditionalFormatting[0].ShowValue | Should -BeTrue
-
-        Close-ExcelPackage $xl -NoSave
-    }
-
-    It "Should set ThreeIconSet with ShowOnlyIcon" {
-        $cfi1 = New-ConditionalFormattingIconSet -Range C:C -ConditionalFormat ThreeIconSet -IconType Symbols -ShowIconOnly
-
-        $data | Export-Excel $xlFilename -ConditionalFormat $cfi1
-        $actual = Import-Excel $xlFilename
-        $actual.count | Should -Be 9
-
-        $xl = Open-ExcelPackage $xlFilename
-        $xl.Workbook.Worksheets.Count | Should -Be 1
-        $targetSheet = $xl.Workbook.Worksheets[1]
-        
-        $targetSheet.Name | Should -Be "Sheet1"
-        $targetSheet.ConditionalFormatting.Count | Should -Be 1
-        $targetSheet.ConditionalFormatting[0].Type | Should -Be "ThreeIconSet"
-        $targetSheet.ConditionalFormatting[0].IconSet | Should -Be "Symbols"
-        $targetSheet.ConditionalFormatting[0].Reverse | Should -BeFalse
-        $targetSheet.ConditionalFormatting[0].ShowValue | Should -BeFalse
-
-        Close-ExcelPackage $xl -NoSave 
-    }
-}

__tests__/Path.tests.ps1

@@ -1,12 +1,11 @@
 Describe "Test reading relative paths" {
     BeforeAll {
         $script:xlfileName = "TestR.xlsx"
-        If ([String]::IsNullOrEmpty($PWD)) { $PWD = $PSScriptRoot }
-        @{data = 1 } | Export-Excel (Join-Path $PWD "TestR.xlsx")
+        @{data = 1 } | Export-Excel (Join-Path $PWD  "TestR.xlsx")
     }
 
     AfterAll {
-        Remove-Item (Join-Path $PWD "$($script:xlfileName)")
+        Remove-Item (Join-Path $PWD  "$($script:xlfileName)")
     }
 
     It "Should read local file".PadRight(90) {

__tests__/Set-CellComment.tests.ps1

@@ -1,44 +0,0 @@
-if (-not (Get-command Import-Excel -ErrorAction SilentlyContinue)) {
-    Import-Module $PSScriptRoot\..\ImportExcel.psd1
-}
-
-Describe "Test setting comment on cells in different ways" -Tag SetCellComment {
-    BeforeAll {
-        $data = ConvertFrom-Csv @"
-OrderId,Category,Sales,Quantity,Discount
-1,Cosmetics,744.01,07,0.7
-2,Grocery,349.13,25,0.3
-3,Apparels,535.11,88,0.2
-4,Electronics,524.69,60,0.1
-5,Electronics,439.10,41,0.0
-6,Apparels,56.84,54,0.8
-7,Electronics,326.66,97,0.7
-8,Cosmetics,17.25,74,0.6
-9,Grocery,199.96,39,0.4
-10,Grocery,731.77,20,0.3
-"@
-
-        $Excel = $data | Export-Excel -PassThru
-        $ws = $Excel.Workbook.Worksheets | Select-Object -First 1
-    }
-
-    AfterAll {
-        Close-ExcelPackage $Excel
-    }
-
-    It "Should add comments to multiple cells".PadRight(87) {
-        Set-CellComment -Range "A1" -Worksheet $ws -Text "This was added with a single cell range"
-        Set-CellComment -Range "A2:C2" -Worksheet $ws -Text "This was added with a multiple cell range"
-        Set-CellComment -ColumnLetter A -Row 3 -Worksheet $ws -Text "This was added using a column letter and rownumber"
-        Set-CellComment -ColumnNumber 1 -Row 4 -Worksheet $ws -Text "This was added using a column number and row number"
-
-        Set-CellComment -Range "B2" -Worksheet $ws -Text "This demonstrates an overwrite of a previously set comment"
-
-        $ws.Cells["A1"].Comment.Text | Should -BeExactly "This was added with a single cell range"
-        $ws.Cells["A2"].Comment.Text | Should -BeExactly "This was added with a multiple cell range" 
-        $ws.Cells["B2"].Comment.Text | Should -BeExactly "This demonstrates an overwrite of a previously set comment" 
-        $ws.Cells["C2"].Comment.Text | Should -BeExactly "This was added with a multiple cell range"
-        $ws.Cells["A3"].Comment.Text | Should -BeExactly "This was added using a column letter and rownumber"
-        $ws.Cells["A4"].Comment.Text | Should -BeExactly "This was added using a column number and row number"
-    }
-}

__tests__/Set-Row_Set-Column-SetFormat.tests.ps1

@@ -132,11 +132,6 @@ Describe "Set-ExcelColumn, Set-ExcelRow and Set-ExcelRange"  {
         12011,Crowbar,7,23.48
 "@
 
-        # Pester errors for countries with ',' as decimal separator
-        Foreach ($datarow in $data) {
-            $datarow.Price = [decimal]($datarow.Price)
-        }
-
         $DriverData = convertFrom-CSv @"
         Name,Wikipage,DateOfBirth
         Fernando Alonso,/wiki/Fernando_Alonso,1981-07-29
@@ -397,7 +392,7 @@ Describe "Table Formatting"  {
         $excel = $data2 | Export-excel -path $path -WorksheetName Hardware -AutoNameRange -AutoSize -BoldTopRow -FreezeTopRow -PassThru
         $ws = $excel.Workbook.Worksheets[1]
         #test showfilter & TotalSettings
-        $Table = Add-ExcelTable -PassThru -Range $ws.Cells[$($ws.Dimension.address)] -TableStyle Light1 -TableName HardwareTable  -TableTotalSettings @{"Total" = "Sum"} -ShowFirstColumn -ShowFilter:$false
+        $Table = Add-ExcelTable -PassThru -Range $ws.Cells[$($ws.Dimension.address)] -TableStyle Light1 -TableName HardwareTable  -TotalSettings @{"Total" = "Sum"} -ShowFirstColumn -ShowFilter:$false
         #test expnading named number formats
         Set-ExcelColumn -Worksheet $ws -Column 4 -NumberFormat 'Currency'
         Set-ExcelColumn -Worksheet $ws -Column 5 -NumberFormat 'Currency'

changelog.md

@@ -1,85 +1,15 @@
-# 7.8.10
-
-- Thank you https://github.com/evenmartinsen for the PR to fix the AV
-
-# 7.8.9
-
-- Thanks to (Edward Miller)[https://github.com/edwardmiller-mesirow] for improving `ConvertTo-ExcelXlsx`and making it more robust
-
-# 7.8.8
-
-- Fix the release
-
-# 7.8.7
-
-- Thanks to [Phil Bossman](https://github.com/pbossman) for the PR and fixing this.
-    
-    Now, back again, you can type `Import-Excel .\yearlySales.xlsx`, press <ctrl+space> and get a list of the worksheets in the Excel file
-
-    ![alt text](images/AutoCompleteSheetNames.png)    
-
-# Infrastructure change
-
-- Thank you to [RipFence](https://github.com/RipFence) who asked how to place a chart on a different sheet from the data and then did a PR adding the example.
-- added `ignore` so files checked into examples do not trigger a CI run
-
-# 7.8.6
-
-- Thank you [John Boyne](https://github.com/kyllath)
-    - Add missing parameter aliases to align with caller/callee
-
-# 7.8.5
-
-- Added `Get-ExcelFileSchema` to get the schema of an Excel file.
-- This was added to support interacting with `ChatGPT`. Passing the schema to the `ChatGPT` via `PowerShellAI` let's you ask questions about the data including generating code based on the schema.
-
-```powershell
-Get-ExcelFileSchema .\salesData.xlsx
-```
-
-```json
-{
-  "ExcelFile": "salesData.xlsx",
-  "WorksheetName": "Sheet1",
-  "Visible": true,
-  "Rows": 10,
-  "Columns": 4,
-  "Address": "A1:D10",
-  "Path": ".",
-  "PropertyNames": [
-    "Region",
-    "State",
-    "Units",
-    "Price"
-  ]
-}
-```
-
-# 7.8.x
-
-Thanks to [Thomas Hofkens](https://github.com/thkn-hofa)
-- Added `-NoHyperLinkConversion` to `Export-Excel` to no convert data to hyperlinks. [#1316](https://github.com/dfinke/ImportExcel/issues/1316)
-
-# 7.8.4
-
-- Add -ShowOnlyIcon to `New-ConditionalFormattingIconSet` does not show data in the cell, just the icon. Based on this discussion https://github.com/dfinke/ImportExcel/discussions/1340
-
-# 7.8.3
-
-Thanks [Thomas Hofkens](https://github.com/thkn-hofa)
-
-- Extended Export-Excel with parameter TableTotalSettings
-- New Feature: Set-CellComment
-- Fix Pester error for countries with ',' as decimal separator
-- Fix Pester error for Windows PowerShell 5.1
-
 # 7.8.2
 
-- Fix docs [#1254](https://github.com/dfinke/ImportExcel/pull/1251)`Add-Worksheet` warning. Thank you [Wilson Stewart](https://github.com/WilsonStewart)
-- Fix docs [#1251](https://github.com/dfinke/ImportExcel/pull/1251)`Add-Worksheet` warning. Thank you [Jeremiah Adams](https://github.com/JeremiahTheFirst)
-- Fix docs [#1253](https://github.com/dfinke/ImportExcel/pull/1253) `convertfrom-exceltosqlinsert`. Thank you [Wes Stahler](https://github.com/stahler)
-- Set Validate Range for rows to max rows available [#1273](https://github.com/dfinke/ImportExcel/pull/1273). Thank you [Stephen Brown](https://github.com/steve-daedilus)
-- Extended Get-ExcelFileSummary to include more Visible -eq $true|$false
+- Added `HeaderName` parameter to `Export-Excel`. Allows you to output an object with a property name. Otherwise the data is just the array of values.
+
+```powershell
+1..10 | Export-Excel -Path .\test.xlsx -HeaderName MyNum
+```
+
+- Added example `CopyFromOneSheetInSameWorkbook`. Shows how to copy a range of data from WorksheetA to WorksheetB
+- Added example `HeaderName`. Shows how to use the new `-HeaderName` parameter
+- Added example `HeaderName`. Shows how to use the new `-HeaderName` parameter
+- Added example `ConvertDictionaryOfArraysToExcel` example. Takes a dictionary of arrays and converts it Rows and Columns of data in Excel.
 
 # 7.8.1
 

mdHelp/en/add-conditionalformatting.md

@@ -66,7 +66,7 @@ PS\> $excel = $avdata | Export-Excel -Path (Join-path $FilePath "\Machines.XLSX"
      $excel.Save() ; $excel.Dispose()
 ```
 
-Here Export-Excel is called with the -PassThru parameter, so the ExcelPackage object representing Machines.XLSX is stored in $Excel. The desired worksheet is selected, and then columns" B" and "I" are conditionally formatted \(excluding the top row\) to show red text if they contain "2003" or "Disabled" respectively.
+Here Export-Excel is called with the -PassThru parameter, so the ExcelPackage object representing Machines.XLSX is stored in $Excel.The desired worksheet is selected, and then columns" B" and "I" are conditionally formatted \(excluding the top row\) to show red text if they contain "2003" or "Disabled" respectively.
 
 A fixed date format is then applied to columns D to G, and the top row is formatted.
 
@@ -83,7 +83,7 @@ Again Export-Excel has been called with -PassThru leaving a package object in $E
 
 This time B1:B100 has been conditionally formatted with 3 icons, using the "Flags" Icon-Set.
 
-Add-ConditionalFormatting does not provide access to every option in the formatting rule, so -PassThru has been used and the rule is modified to apply the flags in reverse order, and transitions between flags are set to 100 and 1000.
+Add-ConditionalFormatting does not provide accessto every option in the formatting rule, so -PassThru has been used and the rule is modified to apply the flags in reverse order, and transitions between flags are set to 100 and 1000.
 
 ### EXAMPLE 3
 

mdHelp/en/add-excelchart.md

@@ -81,7 +81,7 @@ PS\> $Excel = Invoke-Sum (Get-Process) Company Handles, PM, VirtualMemorySize |
 
 The first line exports information to a table in new file; and captures the excel Package object in $Excel
 
-The second line creates a chart on the first page of the work sheet, using the notation "TableName\[ColumnName\]" to refer to the data, the labels come Name column in the table, and the data series from its PM and VirtualMemorySize columns. The display names for these in the header are set to 'PM' and 'VMSize'.
+The second line creates a chart on the first page of the work sheet, using the notation "TableName\[ColumnnName\]" to refer to the data, the labels come Name column in the table, and the data series from its PM and VirtualMemorySize columns. The display names for these in the header are set to 'PM' and 'VMSize'.
 
 ### EXAMPLE 4
 
@@ -112,7 +112,7 @@ An existing Sheet where the chart will be created.
 
 ```yaml
 Type: ExcelWorksheet
-Parameter Sets: Worksheet
+Parameter Sets: Workshet
 Aliases:
 
 Required: True

mdHelp/en/add-exceltable.md

@@ -14,7 +14,7 @@ Adds Tables to Excel workbooks.
 ## SYNTAX
 
 ```text
-Add-ExcelTable [-Range] <ExcelRange> [[-TableName] <String>] [[-TableStyle] <TableStyles>] [-ShowHeader] [-ShowFilter] [-ShowTotal] [[-TableTotalSettings] <Hashtable>] [-ShowFirstColumn] [-ShowLastColumn]  [-ShowRowStripes] [-ShowColumnStripes] [-PassThru] [<CommonParameters>]
+Add-ExcelTable [-Range] <ExcelRange> [[-TableName] <String>] [[-TableStyle] <TableStyles>] [-ShowHeader] [-ShowFilter] [-ShowTotal] [[-TotalSettings] <Hashtable>] [-ShowFirstColumn] [-ShowLastColumn]  [-ShowRowStripes] [-ShowColumnStripes] [-PassThru] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -142,19 +142,9 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -TableTotalSettings
+### -TotalSettings
 
-A HashTable in the form of either
-
-- ColumnName = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var"|\<Custom Excel function starting with "="\>
-- ```powershell
-  ColumnName = @{
-      Function = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var"|<Custom Excel function starting with "=">
-      Comment = $HoverComment
-  }
-  ```
-
-if specified, -ShowTotal is not needed.
+A HashTable in the form ColumnName = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var" - if specified, -ShowTotal is not needed.
 
 ```yaml
 Type: Hashtable

mdHelp/en/convertfrom-exceltosqlinsert.md

@@ -137,7 +137,7 @@ Accept wildcard characters: False
 
 ### -Header
 
-Specifies custom property names to use, instead of the values defined in the column headers of the TopRow. If you provide fewer header names than there is data in the worksheet, then only the data with a corresponding header name will be imported and the data without header name will be disregarded. If you provide more header names than there is data in the worksheet, then all data will be imported and all objects will have all the property names you defined in the header names. As such, the last properties will be blank as there is no data for them.
+Specifies custom property names to use, instead of the values defined in the column headers of the TopRow. If you provide fewr header names than there is data in the worksheet, then only the data with a corresponding header name will be imported and the data without header name will be disregarded. If you provide more header names than there is data in the worksheet, then all data will be imported and all objects will have all the property names you defined in the header names. As such, the last properties will be blank as there is no data for them.
 
 ```yaml
 Type: String[]

mdHelp/en/export-excel.md

@@ -16,19 +16,19 @@ Exports data to an Excel worksheet.
 ### Default \(Default\)
 
 ```text
-Export-Excel [[-Path] <String>] [-InputObject <Object>] [-Calculate] [-Show] [-WorksheetName <String>] [-Password <String>] [-ClearSheet] [-Append] [-Title <String>] [-TitleFillPattern <ExcelFillStyle>] [-TitleBold] [-TitleSize <Int32>] [-TitleBackgroundColor <Object>][-IncludePivotTable] [-PivotTableName <String>] [-PivotRows <String[]> [-PivotColumns <String[]>] [-PivotData <Object>] [-PivotFilter <String[]>] [-PivotDataToColumn] [-PivotTableDefinition <Hashtable>] [-IncludePivotChart] [-ChartType <eChartType>] [-NoLegend] [-ShowCategory] [-ShowPercent] [-AutoSize] [-MaxAutoSizeRows <Object>] [-NoClobber] [-FreezeTopRow] [-FreezeFirstColumn] [-FreezeTopRowFirstColumn] [-FreezePane <Int32[]>] [-AutoFilter] [-BoldTopRow] [-NoHeader] [-RangeName <String>] [-TableName <Object>] [-TableStyle <TableStyles>] [-TableTotalSettings <HashTable>] [-Barchart] [-PieChart] [-LineChart] [-ColumnChart] [-ExcelChartDefinition <Object[]>] [-HideSheet <String[]>] [-UnHideSheet <String[]>] [-MoveToStart] [-MoveToEnd] [-MoveBefore <Object>] [-MoveAfter <Object>] [-KillExcel] [-AutoNameRange] [-StartRow <Int32>] [-StartColumn <Int32>] [-PassThru] [-Numberformat <String>] [-ExcludeProperty <String[]>] [-NoAliasOrScriptPropeties] [-DisplayPropertySet] [-NoNumberConversion <String[]>] [-NoHyperLinkConversion <String[]>] [-ConditionalFormat <Object[]>] [-ConditionalText <Object[]>] [-Style <Object[]>] [-CellStyleSB <ScriptBlock>] [-Activate] [-Now] [-ReturnRange] [-PivotTotals <String>] [-NoTotalsInPivot] [-ReZip] [<CommonParameters>]
+Export-Excel [[-Path] <String>] [-InputObject <Object>] [-Calculate] [-Show] [-WorksheetName <String>] [-Password <String>] [-ClearSheet] [-Append] [-Title <String>] [-TitleFillPattern <ExcelFillStyle>] [-TitleBold] [-TitleSize <Int32>] [-TitleBackgroundColor <Object>][-IncludePivotTable] [-PivotTableName <String>] [-PivotRows <String[]> [-PivotColumns <String[]>] [-PivotData <Object>] [-PivotFilter <String[]>] [-PivotDataToColumn] [-PivotTableDefinition <Hashtable>] [-IncludePivotChart] [-ChartType <eChartType>] [-NoLegend] [-ShowCategory] [-ShowPercent] [-AutoSize] [-MaxAutoSizeRows <Object>] [-NoClobber] [-FreezeTopRow] [-FreezeFirstColumn] [-FreezeTopRowFirstColumn] [-FreezePane <Int32[]>] [-AutoFilter] [-BoldTopRow] [-NoHeader] [-RangeName <String>] [-TableName <Object>] [-TableStyle <TableStyles>] [-Barchart] [-PieChart] [-LineChart] [-ColumnChart] [-ExcelChartDefinition <Object[]>] [-HideSheet <String[]>] [-UnHideSheet <String[]>] [-MoveToStart] [-MoveToEnd] [-MoveBefore <Object>] [-MoveAfter <Object>] [-KillExcel] [-AutoNameRange] [-StartRow <Int32>] [-StartColumn <Int32>] [-PassThru] [-Numberformat <String>] [-ExcludeProperty <String[]>] [-NoAliasOrScriptPropeties] [-DisplayPropertySet] [-NoNumberConversion <String[]>] [-ConditionalFormat <Object[]>] [-ConditionalText <Object[]>] [-Style <Object[]>] [-CellStyleSB <ScriptBlock>] [-Activate] [-Now] [-ReturnRange] [-PivotTotals <String>] [-NoTotalsInPivot] [-ReZip] [<CommonParameters>]
 ```
 
 ### Package
 
 ```text
-Export-Excel -ExcelPackage <ExcelPackage> [-InputObject <Object>] [-Calculate] [-Show] [-WorksheetName <String>] [-Password <String>] [-ClearSheet] [-Append] [-Title <String>] [-TitleFillPattern <ExcelFillStyle>] [-TitleBold] [-TitleSize <Int32>] [-TitleBackgroundColor <Object>] [-IncludePivotTable] [-PivotTableName <String>] [-PivotRows <String[]>] [-PivotColumns <String[]>] [-PivotData <Object>] [-PivotFilter <String[]>] [-PivotDataToColumn] [-PivotTableDefinition <Hashtable>] [-IncludePivotChart] [-ChartType <eChartType>] [-NoLegend] [-ShowCategory] [-ShowPercent] [-AutoSize] [-MaxAutoSizeRows <Object>] [-NoClobber] [-FreezeTopRow] [-FreezeFirstColumn] [-FreezeTopRowFirstColumn] [-FreezePane <Int32[]>] [-AutoFilter] [-BoldTopRow] [-NoHeader] [-RangeName <String>] [-TableName <Object>] [-TableStyle <TableStyles>] [-TableTotalSettings <HashTable>] [-Barchart] [-PieChart] [-LineChart] [-ColumnChart] [-ExcelChartDefinition <Object[]>] [-HideSheet <String[]>] [-UnHideSheet <String[]>] [-MoveToStart] [-MoveToEnd] [-MoveBefore <Object>] [-MoveAfter <Object>] [-KillExcel] [-AutoNameRange] [-StartRow <Int32>] [-StartColumn <Int32>] [-PassThru] [-Numberformat <String>] [-ExcludeProperty <String[]>]
- [-NoAliasOrScriptPropeties] [-DisplayPropertySet] [-NoNumberConversion <String[]>] [-NoHyperLinkConversion <String[]>] [-ConditionalFormat <Object[]>] [-ConditionalText <Object[]>] [-Style <Object[]>] [-CellStyleSB <ScriptBlock>] [-Activate] [-ReturnRange] [-PivotTotals <String>] [-NoTotalsInPivot] [-ReZip] [<CommonParameters>]
+Export-Excel -ExcelPackage <ExcelPackage> [-InputObject <Object>] [-Calculate] [-Show] [-WorksheetName <String>] [-Password <String>] [-ClearSheet] [-Append] [-Title <String>] [-TitleFillPattern <ExcelFillStyle>] [-TitleBold] [-TitleSize <Int32>] [-TitleBackgroundColor <Object>] [-IncludePivotTable] [-PivotTableName <String>] [-PivotRows <String[]>] [-PivotColumns <String[]>] [-PivotData <Object>] [-PivotFilter <String[]>] [-PivotDataToColumn] [-PivotTableDefinition <Hashtable>] [-IncludePivotChart] [-ChartType <eChartType>] [-NoLegend] [-ShowCategory] [-ShowPercent] [-AutoSize] [-MaxAutoSizeRows <Object>] [-NoClobber] [-FreezeTopRow] [-FreezeFirstColumn] [-FreezeTopRowFirstColumn] [-FreezePane <Int32[]>] [-AutoFilter] [-BoldTopRow] [-NoHeader] [-RangeName <String>] [-TableName <Object>] [-TableStyle <TableStyles>] [-Barchart] [-PieChart] [-LineChart] [-ColumnChart] [-ExcelChartDefinition <Object[]>] [-HideSheet <String[]>] [-UnHideSheet <String[]>] [-MoveToStart] [-MoveToEnd] [-MoveBefore <Object>] [-MoveAfter <Object>] [-KillExcel] [-AutoNameRange] [-StartRow <Int32>] [-StartColumn <Int32>] [-PassThru] [-Numberformat <String>] [-ExcludeProperty <String[]>]
+ [-NoAliasOrScriptPropeties] [-DisplayPropertySet] [-NoNumberConversion <String[]>] [-ConditionalFormat <Object[]>] [-ConditionalText <Object[]>] [-Style <Object[]>] [-CellStyleSB <ScriptBlock>] [-Activate] [-ReturnRange] [-PivotTotals <String>] [-NoTotalsInPivot] [-ReZip] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
-Exports data to an Excel file and where possible tries to convert numbers in text fields so Excel recognizes them as numbers instead of text. After all: Excel is a spreadsheet program used for number manipulation and calculations. The parameter -NoNumberConversion \* can be used if number conversion is not desired. In the same way the parameter NoHyperLinkConversion \* can be used if hyperlink conversion is not desired
+Exports data to an Excel file and where possible tries to convert numbers in text fields so Excel recognizes them as numbers instead of text. After all: Excel is a spreadsheet program used for number manipulation and calculations. The parameter -NoNumberConversion \* can be used if number conversion is not desired.
 
 ## EXAMPLES
 
@@ -108,10 +108,10 @@ PS\> [PSCustOmobject][Ordered]@{
     PhoneNr1  = '+32 44'
     PhoneNr2  = '+32 4 4444 444'
     PhoneNr3  =  '+3244444444'
-} | Export-Excel @ExcelParams -NoNumberConversion * -NoHyperLinkConversion *
+} | Export-Excel @ExcelParams -NoNumberConversion *
 ```
 
-Exports all data to the Excel file 'Excel.xslx' as is, no number or hyperlink conversion will take place. This means that Excel will show the exact same data that you handed over to the 'Export-Excel' function.
+Exports all data to the Excel file 'Excel.xslx' as is, no number conversion will take place. This means that Excel will show the exact same data that you handed over to the 'Export-Excel' function.
 
 ### EXAMPLE 5
 
@@ -156,29 +156,6 @@ If neither condition is met, the color will be the default, black text on a whit
 
 ### EXAMPLE 7
 
-```text
-PS\> $r = Get-ChildItem C:\WINDOWS\system32 -File
-
-PS\> $TotalSettings = @{ 
-         Name = "Count"
-         Extension = "=COUNTIF([Extension];`".exe`")"
-         Length = @{
-             Function = "=SUMIF([Extension];`".exe`";[Length])"
-             Comment = "Sum of all exe sizes"
-         }
-     }
-
-PS\> $r | Export-Excel -TableName system32files -TableStyle Medium10 -TableTotalSettings $TotalSettings -Show
-```
-
-Exports a list of files with a totals row with three calculated totals:
-
-- Total count of names
-- Count of files with the extension ".exe"
-- Total size of all file with extension ".exe" and add a comment as to not be mistaken that is is the total size of all files
-
-### EXAMPLE 8
-
 ```text
 PS\> $ExcelParams = @{
         Path      = $env:TEMP + '\Excel.xlsx'
@@ -212,25 +189,25 @@ PS\> $Array | Update-FirstObjectProperties | Export-Excel @ExcelParams -Workshee
 
 Updates the first object of the array by adding property 'Member3' and 'Member4'. Afterwards, all objects are exported to an Excel file and all column headers are visible.
 
-### EXAMPLE 9
+### EXAMPLE 8
 
 ```text
 PS\> Get-Process | Export-Excel .\test.xlsx -WorksheetName Processes -IncludePivotTable -Show -PivotRows Company -PivotData PM
 ```
 
-### EXAMPLE 10
+### EXAMPLE 9
 
 ```text
 PS\> Get-Process | Export-Excel .\test.xlsx -WorksheetName Processes -ChartType PieExploded3D -IncludePivotChart -IncludePivotTable -Show -PivotRows Company -PivotData PM
 ```
 
-### EXAMPLE 11
+### EXAMPLE 10
 
 ```text
 PS\> Get-Service | Export-Excel 'c:\temp\test.xlsx'  -Show -IncludePivotTable -PivotRows status -PivotData @{status='count'}
 ```
 
-### EXAMPLE 12
+### EXAMPLE 11
 
 ```text
 PS\> $pt = [ordered]@{}
@@ -260,7 +237,7 @@ Then it puts Service data on Sheet1 with one call to Export-Excel and Process Da
 
 The third and final call adds the two PivotTables and opens the spreadsheet in Excel.
 
-### EXAMPLE 13
+### EXAMPLE 12
 
 ```text
 PS\> Remove-Item  -Path .\test.xlsx
@@ -281,7 +258,7 @@ It then uses the package object to apply formatting, and then saves the workbook
 
 Note: Other commands in the module remove the need to work directly with the package object in this way.
 
-### EXAMPLE 14
+### EXAMPLE 13
 
 ```text
 PS\> Remove-Item -Path .\test.xlsx -ErrorAction Ignore
@@ -304,7 +281,7 @@ This a more sophisticated version of the previous example showing different ways
 
 In the final command a PivotChart is added and the workbook is opened in Excel.
 
-### EXAMPLE 15
+### EXAMPLE 14
 
 ```text
 PS\> 0..360 | ForEach-Object {[pscustomobject][ordered]@{X=$_; Sinx="=Sin(Radians(x)) "} } |
@@ -313,7 +290,7 @@ PS\> 0..360 | ForEach-Object {[pscustomobject][ordered]@{X=$_; Sinx="=Sin(Radian
 
 Creates a line chart showing the value of Sine\(x\) for values of X between 0 and 360 degrees.
 
-### EXAMPLE 16
+### EXAMPLE 15
 
 ```text
 PS\> Invoke-Sqlcmd -ServerInstance localhost\DEFAULT -Database AdventureWorks2014 -Query "select *  from sys.tables" -OutputAs DataRows |
@@ -360,7 +337,7 @@ Accept wildcard characters: False
 
 ### -InputObject
 
-Data is usually piped into Export-Excel, but it also accepts data through the InputObject parameter
+Date is usually piped into Export-Excel, but it also accepts data through the InputObject parameter
 
 ```yaml
 Type: Object
@@ -975,32 +952,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -TableTotalSettings
-
-A HashTable in the form of either
-
-- ColumnName = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var"|\<Custom Excel function starting with "="\>
-- ```powershell
-  ColumnName = @{
-      Function = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var"|<Custom Excel function starting with "=">
-      Comment = $HoverComment
-  }
-  ```
-
-if specified, -ShowTotal is not needed.
-
-```yaml
-Type: Hashtable
-Parameter Sets: (All)
-Aliases:
-
-Required: False
-Position: 4
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
 ### -Barchart
 
 Creates a "quick" bar chart using the first text column as labels and the first numeric column as values.
@@ -1357,24 +1308,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -NoHyperLinkConversion
-
-By default the command will convert all URIs to hyperlinks if possible, but this isn't always desirable. -NoHyperLinkConversion allows you to add exceptions for the conversion.
-
-The only Wildcard allowed is \* for all properties
-
-```yaml
-Type: String[]
-Parameter Sets: (All)
-Aliases:
-
-Required: False
-Position: Named
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
 ### -ConditionalFormat
 
 One or more conditional formatting rules defined with New-ConditionalFormattingIconSet.

mdHelp/en/import-excel.md

@@ -64,7 +64,6 @@ If the default behavior is not desired and you want to import the complete works
 ### EXAMPLE 1
 
 ```text
-
 ----------------------------------------------
 | File: Movies.xlsx     -      Sheet: Actors |
 ----------------------------------------------
@@ -90,7 +89,6 @@ Notice that column 'B' is not imported because there's no value in cell 'B1' tha
 ### EXAMPLE 2
 
 ```text
-
 ----------------------------------------------
 | File: Movies.xlsx     -      Sheet: Actors |
 ----------------------------------------------
@@ -122,7 +120,6 @@ Notice that the column header \(row 1\) is imported as an object too.
 ### EXAMPLE 3
 
 ```text
-
 ----------------------------------------------------------
 | File: Movies.xlsx            -           Sheet: Movies |
 ----------------------------------------------------------
@@ -163,7 +160,6 @@ Notice that empty rows are imported and that data for the property 'Genre' is no
 ### EXAMPLE 4
 
 ```text
-
 ----------------------------------------------------------
 | File: Movies.xlsx            -           Sheet: Movies |
 ----------------------------------------------------------
@@ -196,7 +192,6 @@ Notice that empty rows and empty columns are not imported.
 ### EXAMPLE 5
 
 ```text
-
 ----------------------------------------------------------
 | File: Movies.xlsx            -           Sheet: Actors |
 ----------------------------------------------------------