Use Copy method to copy ranges from one sheet to another

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

ImportExcel.psd1

@@ -6,7 +6,7 @@
     RootModule         = 'ImportExcel.psm1'
 
     # Version number of this module.
-    ModuleVersion      = '7.8.6'
+    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',
@@ -124,6 +122,7 @@ Check out the How To Videos https://www.youtube.com/watch?v=U3Ne_yX4tYo&list=PL5
         '.\ImportExcel.psd1',
         '.\ImportExcel.psm1',
         '.\LICENSE.txt',
+        '.\README.md',
         '.\Plot.ps1',
         '.\Private',
         '.\Public',

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) {
+            foreach ($k in $TotalSettings.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
                 if (-not $tbl.Columns[$k]) {Write-Warning -Message "Table does not have a Column '$k'."}
-                elseif ($TotalFunction -match "^=") {
+                elseif ($TotalSettings[$k] -notin @("Average", "Count", "CountNums", "Max", "Min", "None", "StdDev", "Sum", "Var") ) {
-                    ### A function in Excel uses ";" between parameters but the OpenXML parameter separator is ","
+                    Write-Warning -Message "'$($TotalSettings[$k])' is not a valid total function."
-                    ### 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
                 }
+                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]$HeaderRow = 1,
-        [int]$StartRow = 1,
         [string[]]$Header,
         [switch]$NoHeader,
         [switch]$DataOnly

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
+                            elseif ($v -is [uri] ) {
-                                    $NoHyperLinkConversion -ne '*' -and
-                                    $NoHyperLinkConversion -notcontains $Name ) {
                                 $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
+                            elseif ( [System.Uri]::IsWellFormedUriString($v , [System.UriKind]::Absolute) ) {
-                                    $NoHyperLinkConversion -notcontains $Name -and
-                                    [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
+                                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
-                                    $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
+                                    $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}
+                        "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 -ShowIconOnly:$c.ShowIconOnly}
+                        "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 -ShowIconOnly:$c.ShowIconOnly}
+                        "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

@@ -5,8 +5,7 @@ function New-ConditionalFormattingIconSet {
         $Range,
         [ValidateSet("ThreeIconSet","FourIconSet","FiveIconSet")]
         $ConditionalFormat,
-        [Switch]$Reverse,
+        [Switch]$Reverse
-        [Switch]$ShowIconOnly
     )
 
     DynamicParam {
@@ -48,7 +47,6 @@ function New-ConditionalFormattingIconSet {
             Formatter = $ConditionalFormat
             IconType  = $bp.IconType
             Reverse   = $Reverse
-            ShowIconOnly = $ShowIconOnly
         }
 
         $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,21 +4,6 @@
 
 <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>
-
 [![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)
@@ -27,7 +12,7 @@ Consider donating. Thank you!
 
 # 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)                                            " {
+        it "Converted a nested object to a string (Y2)                                             " {
-            $ws.Cells[2, 27].Value                                     | Should      -Match '^System\.Diagnostics\.Process\s+\(.*\)$'
+            $ws.Cells[2, 26].Value                                     | Should      -Match '^System\.Diagnostics\.Process\s+\(.*\)$'
         }
-        it "Processed a timespan object (AB2)                                                      " {
+        it "Processed a timespan object (Z2)                                                       " {
-            $ws.cells[2, 28].Value.ToOADate()                          | Should      -BeGreaterThan 0
+            $ws.cells[2, 27].Value.ToOADate()                          | Should      -BeGreaterThan 0
-            $ws.cells[2, 28].Value.ToOADate()                          | Should      -BeLessThan    1
+            $ws.cells[2, 27].Value.ToOADate()                          | Should      -BeLessThan    1
-            $ws.cells[2, 28].Style.Numberformat.Format                 | Should      -Be  '[h]:mm:ss'
+            $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"
+                Link      = [uri]"https://github.com/dfinke/ImportExcel"
-                Link2     = [uri]"https://github.com/dfinke/ImportExcel"
+            } | Export-Excel  -NoNumberConversion IPAddress, Number1  -Path $path -NoHeader
-            } | Export-Excel -NoHyperLinkConversion Link2 -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 = Get-Process | Select-Object -Property Name, Company, Handles, CPU, PM, NPM, WS | Export-Excel -Path $path -ClearSheet -WorkSheetname "Processes" -FreezeTopRowFirstColumn -PassThru
-            $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
             $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
+            $sheet.view.Panes.Count                                     | Should      -Be 3
-            $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"
         }
 
         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,7 +1,6 @@
 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")
     }
 

__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,60 +1,15 @@
-# 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)
+- 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.
-- 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)
+```powershell
-- 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)
+1..10 | Export-Excel -Path .\test.xlsx -HeaderName MyNum
-- Extended Get-ExcelFileSummary to include more Visible -eq $true|$false
+```
+
+- 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-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
+A HashTable in the form ColumnName = "Average"\|"Count"\|"CountNums"\|"Max"\|"Min"\|"None"\|"StdDev"\|"Sum"\|"Var" - if specified, -ShowTotal is not needed.
-
-- 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

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[]>]
+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[]>] [-NoHyperLinkConversion <String[]>] [-ConditionalFormat <Object[]>] [-ConditionalText <Object[]>] [-Style <Object[]>] [-CellStyleSB <ScriptBlock>] [-Activate] [-ReturnRange] [-PivotTotals <String>] [-NoTotalsInPivot] [-ReZip] [<CommonParameters>]
+ [-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 |
 ----------------------------------------------------------