Tweaked format

fix #802 and #795. Extra examples including pester-xlsx

.gitignore

@@ -63,5 +63,5 @@ ImportExcel.zip
 .vscode/settings.json
 
 ~$*
-InstallModule.ps1
-PublishToGallery.ps1
+# InstallModule.ps1
+# PublishToGallery.ps1

AddDataValidation.ps1

@@ -1,99 +0,0 @@
-Function Add-ExcelDataValidationRule {
-    <#
-      .Synopsis
-        Adds data validation to a range of cells
-      .Example
-        >
-        >Add-ExcelDataValidationRule -WorkSheet $PlanSheet -Range 'E2:E1001' -ValidationType Integer -Operator between -Value 0 -Value2 100 `
-             -ShowErrorMessage -ErrorStyle stop -ErrorTitle 'Invalid Data' -ErrorBody 'Percentage must be a whole number between 0 and 100'
-
-        This defines a validation rule on cells E2-E1001; it is an integer rule and requires a number between 0 and 100
-        If a value is input with a fraction, negative number, or positive number > 100 a stop dialog box appears.
-      .Example
-        >
-        >Add-ExcelDataValidationRule -WorkSheet $PlanSheet -Range 'B2:B1001' -ValidationType List  -Formula 'values!$a$2:$a$1000'
-               -ShowErrorMessage -ErrorStyle stop -ErrorTitle 'Invalid Data' -ErrorBody 'You must select an item from the list'
-        This defines a list rule on Cells B2:1001, and the posible values are in a sheet named "values" at cells A2 to A1000
-        Blank cells in this range are ignored. If $ signs are left out of the fomrmula B2 would be checked against A2-A1000
-        B3, against A3-A1001, B4 against A4-A1002 up to B1001 beng checked against A1001-A1999
-       .Example
-       >
-       >Add-ExcelDataValidationRule -WorkSheet $PlanSheet -Range 'I2:N1001' -ValidationType List    -ValueSet @('yes','YES','Yes')
-               -ShowErrorMessage -ErrorStyle stop -ErrorTitle 'Invalid Data' -ErrorBody "Select Yes or leave blank for no"
-        Similar to the previous example but this time provides a value set; Excel comparisons are case sesnsitive, hence 3 versions of Yes.
-    #>
-
-    [CmdletBinding()]
-    Param(
-        #The range of cells to be validate, e.g. "B2:C100"
-        [Parameter(ValueFromPipeline = $true,Position=0)]
-        [Alias("Address")]
-        $Range ,
-        #The worksheet where the cells should be validated
-        [OfficeOpenXml.ExcelWorksheet]$WorkSheet ,
-        #An option corresponding to a choice from the 'Allow' pull down on the settings page in the Excel dialog. Any means "any allowed" i.e. no Validation
-        [ValidateSet('Any','Custom','DateTime','Decimal','Integer','List','TextLength','Time')]
-        $ValidationType,
-        #The operator to apply to Decimal, Integer, TextLength, DateTime and time fields, e.g. equal, between
-        [OfficeOpenXml.DataValidation.ExcelDataValidationOperator]$Operator = [OfficeOpenXml.DataValidation.ExcelDataValidationOperator]::equal ,
-        #For Decimal, Integer, TextLength, DateTime the [first] data value
-        $Value,
-        #When using the between operator, the second data  value
-        $Value2,
-        #The [first] data value as a formula. Use absolute formulas $A$1 if (e.g.) you want all cells to check against the same list
-        $Formula,
-        #When using the between operator, the second data value as a formula
-        $Formula2,
-        #When using the list validation type, a set of values (rather than refering to Sheet!B$2:B$100 )
-        $ValueSet,
-        #Corresponds to the the 'Show Error alert ...' check box on error alert page in the Excel dialog
-        [switch]$ShowErrorMessage,
-        #Stop, Warning, or Infomation, corresponding to to the style setting in the Excel dialog
-        [OfficeOpenXml.DataValidation.ExcelDataValidationWarningStyle]$ErrorStyle,
-        #The title for the message box  corresponding to to the title setting in the Excel dialog
-        [String]$ErrorTitle,
-        #The error message corresponding to to the Error message setting in the Excel dialog
-        [String]$ErrorBody,
-        #Corresponds to the the 'Show Input message ...' check box on input message  page in the Excel dialog
-        [switch]$ShowPromptMessage,
-        #The prompt message corresponding to to the Input message setting in the Excel dialog
-        [String]$PromptBody,
-        #The title for the message box  corresponding to to the title setting in the Excel dialog
-        [String]$PromptTitle,
-        #By default the 'Ignore blank' option will be selected, unless NoBlank is sepcified.
-        [String]$NoBlank
-    )
-    if  ($Range -is [Array])  {
-        $null = $PSBoundParameters.Remove("Range")
-        $Range | Add-ExcelDataValidationRule @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      (-not $WorkSheet -and $Range.worksheet) {$WorkSheet = $Range.worksheet}
-        if      ($Range.Address)   {$Range = $Range.Address}
-
-        if      ($Range -isnot [string] -or -not $WorkSheet) {Write-Warning -Message "You need to provide a worksheet and range of cells." ;return}
-       #else we assume Range is a range.
-
-        $validation = $WorkSheet.DataValidations."Add$ValidationType`Validation"($Range)
-        if     ($validation.AllowsOperator) {$validation.Operator = $Operator}
-        if     ($PSBoundParameters.ContainsKey('value')) {
-                            $validation.Formula.Value          = $Value
-        }
-        elseif ($Formula)     {$validation.Formula.ExcelFormula   = $Formula}
-        elseif ($ValueSet)    {Foreach ($v in $ValueSet) {$validation.Formula.Values.Add($V)}}
-        if     ($PSBoundParameters.ContainsKey('Value2')) {
-            $validation.Formula2.Value         = $Value2
-        }
-        elseif ($Formula2)    {$validation.Formula2.ExcelFormula  = $Formula}
-        $validation.ShowErrorMessage = [bool]$ShowErrorMessage
-        $validation.ShowInputMessage = [bool]$ShowPromptMessage
-        $validation.AllowBlank      = -not $NoBlank
-
-        if ($PromptTitle) {$validation.PromptTitle = $PromptTitle}
-        if ($ErrorTitle)  {$validation.ErrorTitle  = $ErrorTitle}
-        if ($PromptBody)  {$validation.Prompt      = $PromptBody}
-        if ($ErrorBody)   {$validation.Error       = $ErrorBody}
-        if ($ErrorStyle)  {$validation.ErrorStyle  = $ErrorStyle}
-    }
- }

CI/CI.ps1

@@ -11,7 +11,9 @@ param
     # AppVeyor Only - Upload results to AppVeyor "Tests" tab.
     [Switch]$Finalize,
     # AppVeyor and Azure - Upload module as AppVeyor Artifact.
-    [Switch]$Artifact
+    [Switch]$Artifact,
+    # Azure - Runs PsScriptAnalyzer against one or more folders and pivots the results to form a report.
+    [Switch]$Analyzer
 )
 $ErrorActionPreference = 'Stop'
 if ($Initialize) {
@@ -93,7 +95,7 @@ if (-not $VersionFilePath) {
     '[Info] Testing On:'
     Get-EnvironmentInfo
     '[Progress] Installing Module.'
-    . .\Install.ps1
+    . .\CI\Install.ps1
     '[Progress] Invoking Pester.'
     Invoke-Pester -OutputFile ('TestResultsPS{0}.xml' -f $PSVersionTable.PSVersion)
 }
@@ -139,4 +141,68 @@ if ($Artifact) {
         #Write-Host "##vso[task.setvariable variable=ModuleName]$ModuleName"
         Copy-Item -Path $ModulePath -Destination $env:Build_ArtifactStagingDirectory -Recurse
     }
+}
+if ($Analyzer) {
+    if (!(Get-Module -Name PSScriptAnalyzer -ListAvailable)) {
+        '[Progress] Installing PSScriptAnalyzer.'
+        Install-Module -Name PSScriptAnalyzer -Force
+    }
+
+    if ($env:System_PullRequest_TargetBranch) {
+        '[Progress] Get target branch.'
+        $TempGitClone = Join-Path ([IO.Path]::GetTempPath()) (New-Guid)
+        Copy-Item -Path $PWD -Destination $TempGitClone -Recurse
+        (Get-Item (Join-Path $TempGitClone '.git')).Attributes += 'Hidden'
+        "[Progress] git clean."
+        git -C $TempGitClone clean -f
+        "[Progress] git reset."
+        git -C $TempGitClone reset --hard
+        "[Progress] git checkout."
+        git -C $TempGitClone checkout -q $env:System_PullRequest_TargetBranch
+
+        $DirsToProcess = @{ 'Pull Request' = $PWD ; $env:System_PullRequest_TargetBranch = $TempGitClone }
+    }
+    else {
+        $DirsToProcess = @{ 'GitHub' = $PWD }
+    }
+
+    "[Progress] Running Script Analyzer."
+    $AnalyzerResults = $DirsToProcess.GetEnumerator() | ForEach-Object {
+        $DirName = $_.Key
+        Write-Verbose "[Progress] Running Script Analyzer on $DirName."
+        Invoke-ScriptAnalyzer -Path $_.Value -Recurse -ErrorAction SilentlyContinue |
+        Add-Member -MemberType NoteProperty -Name Location -Value $DirName -PassThru
+    }
+
+    if ($AnalyzerResults) {
+        if (!(Get-Module -Name ImportExcel -ListAvailable)) {
+            '[Progress] Installing ImportExcel.'
+            Install-Module -Name ImportExcel -Force
+        }
+        '[Progress] Creating ScriptAnalyzer.xlsx.'
+        $ExcelParams = @{
+            Path          = 'ScriptAnalyzer.xlsx'
+            WorksheetName = 'FullResults'
+            Now           = $true
+            Activate      = $true
+            Show          = $false
+        }
+        $PivotParams = @{
+            PivotTableName = 'BreakDown'
+            PivotData      = @{RuleName = 'Count' }
+            PivotRows      = 'Severity', 'RuleName'
+            PivotColumns   = 'Location'
+            PivotTotals    = 'Rows'
+        }
+        Remove-Item -Path $ExcelParams['Path'] -ErrorAction SilentlyContinue
+
+        $PivotParams['PivotChartDefinition'] = New-ExcelChartDefinition -ChartType 'BarClustered' -Column (1 + $DirsToProcess.Count) -Title "Script analysis" -LegendBold
+        $ExcelParams['PivotTableDefinition'] = New-PivotTableDefinition @PivotParams
+
+        $AnalyzerResults | Export-Excel @ExcelParams
+        '[Progress] Analyzer finished.'
+    }
+    else {
+        "[Info] Invoke-ScriptAnalyzer didn't return any problems."
+    }
 }

CI/Install.ps1

@@ -4,7 +4,7 @@
     File must not have BOM for GitHub deploy to work.
 #>
 [CmdletBinding(DefaultParameterSetName = 'Default')]
-Param (
+param(
     # Path to install the module to, if not provided -Scope used.
     [Parameter(Mandatory, ParameterSetName = 'ModulePath')]
     [ValidateNotNullOrEmpty()]
@@ -22,53 +22,28 @@ Param (
 )
 # Set Files and Folders patterns to Include/Exclude.
 $IncludeFiles = @(
-    '*.dll',
+    'EPPlus.dll',
     '*.psd1',
     '*.psm1',
-    'AddConditionalFormatting.ps1',
-    'AddDataValidation.ps1',
-    'Charting.ps1',
-    'ColorCompletion.ps1',
-    'Compare-WorkSheet.ps1',
-    'ConvertExcelToImageFile.ps1',
-    'ConvertFromExcelData.ps1',
-    'ConvertFromExcelToSQLInsert.ps1',
-    'ConvertToExcelXlsx.ps1',
-    'Copy-ExcelWorkSheet.ps1',
-    'Export-Excel.ps1',
-    'Export-ExcelSheet.ps1',
-    'Export-StocksToExcel.ps1',
-    'Get-ExcelColumnName.ps1',
-    'Get-ExcelSheetInfo.ps1',
-    'Get-ExcelWorkbookInfo.ps1',
-    'Get-HtmlTable.ps1',
-    'Get-Range.ps1',
-    'Get-XYRange.ps1',
-    'Import-Html.ps1',
-    'InferData.ps1',
-    'Invoke-Sum.ps1',
-    'Join-Worksheet.ps1',
-    'Merge-Worksheet.ps1',
-    'New-ConditionalFormattingIconSet.ps1',
-    'New-ConditionalText.ps1',
-    'New-ExcelChart.ps1',
-    'New-PSItem.ps1',
-    'Open-ExcelPackage.ps1',
-    'Pivot.ps1',
-    'PivotTable.ps1',
-    'Plot.ps1',
-    'RemoveWorksheet.ps1',
-    'Send-SQLDataToExcel.ps1',
-    'Set-CellStyle.ps1',
-    'Set-Column.ps1',
-    'Set-Row.ps1',
-    'Set-WorkSheetProtection.ps1',
-    'SetFormat.ps1',
-    'TrackingUtils.ps1',
-    'Update-FirstObjectProperties.ps1'
-)
+    '*.ps1'
+    'Charting',
+    'en-US',
+    'Examples',
+    'Public',
+    'Private',
+    'images',
+    'InferData',
+    'InternalFunctions',
+    'Pivot',
+    'spikes',
+    'Testimonials',
+    'README.md',
+    'LICENSE.txt'
+    )
 $ExcludeFiles = @(
-    'Install.ps1'
+    'Install.ps1',
+    'InstallModule.ps1',
+    'PublishToGallery.PS1'
 )
 
 
@@ -106,8 +81,9 @@ function Invoke-MultiLike {
     }
 }
 
-Try {
-    Write-Verbose -Message 'Module installation started'
+Push-Location "$PSScriptRoot\.."
+try {
+    Write-Verbose -Message "Module installation started. Installing from $PWD"
 
     if (!$ModulePath) {
         if ($Scope -eq 'CurrentUser') {
@@ -124,6 +100,7 @@ Try {
         }
         $ModulePath = ($env:PSModulePath -split $ModulePathSeparator)[$ModulePathIndex]
     }
+    Write-Verbose -Message "Installing to $ModulePath"
 
     # Get $ModuleName, $TargetPath, [$Links]
     if ($FromGitHub) {
@@ -140,8 +117,8 @@ Try {
         $ModuleVersion = (. ([Scriptblock]::Create((Invoke-WebRequest -Uri ($Links | Where-Object { $_.name -eq "$ModuleName.psd1" }).download_url)))).ModuleVersion
     }
     else {
-        $ModuleName = [System.IO.Path]::GetFileNameWithoutExtension((Get-ChildItem -File -Filter *.psm1 -Name -Path $PSScriptRoot))
-        $ModuleVersion = (. ([Scriptblock]::Create((Get-Content -Path (Join-Path $PSScriptRoot "$ModuleName.psd1") | Out-String)))).ModuleVersion
+        $ModuleName = [System.IO.Path]::GetFileNameWithoutExtension((Get-ChildItem -File -Filter *.psm1 -Name -Path $PWD))
+        $ModuleVersion = (. ([Scriptblock]::Create((Get-Content -Path (Join-Path $PWD "$ModuleName.psd1") | Out-String)))).ModuleVersion
     }
     $TargetPath = Join-Path -Path $ModulePath -ChildPath $ModuleName
     $TargetPath = Join-Path -Path $TargetPath -ChildPath $ModuleVersion
@@ -185,7 +162,7 @@ Try {
         }
     }
     else {
-        Get-ChildItem -Path $PSScriptRoot -Exclude $ExcludeFiles | Where-Object { LikeAny $_.Name $IncludeFiles } | ForEach-Object {
+        Get-ChildItem -Path $PWD -Exclude $ExcludeFiles | Where-Object { LikeAny $_.Name $IncludeFiles } | ForEach-Object {
             if ($_.Attributes -ne 'Directory') {
                 Copy-Item -Path $_ -Destination $TargetPath
                 Write-Verbose -Message ('Installed module file "{0}"' -f $_)
@@ -202,7 +179,7 @@ Try {
     Import-Module -Name $ModuleName -Force
     Write-Verbose -Message "Module installed"
 }
-Catch {
+catch {
     throw ('Failed installing module "{0}". Error: "{1}" in Line {2}' -f $ModuleName, $_, $_.InvocationInfo.ScriptLineNumber)
 }
 finally {
@@ -210,4 +187,5 @@ finally {
     #    [Net.ServicePointManager]::SecurityProtocol = $SecurityProtocol
     #}
     Write-Verbose -Message 'Module installation end'
+    Pop-Location
 }

CI/InstallPowerShell.ps1

@@ -6,11 +6,15 @@
 Param
 (
     # Version to install in the format from the .msi, for example "7.0.0-preview.1"
-    [Parameter(Mandatory)]
     [String]$Version
 )
 $ErrorActionPreference = 'Stop'
 
+if (-not $Version) {
+    $Version = (Invoke-RestMethod https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/metadata.json).StableReleaseTag
+}
+$Version = $Version -replace "^v",""
+
 '[Progress] Downloading PowerShell Core.'
 $MsiPath = Join-Path $env:TEMP "PowerShell-$Version-win-x64.msi"
 [System.Net.WebClient]::new().DownloadFile("https://github.com/PowerShell/PowerShell/releases/download/v$Version/PowerShell-$Version-win-x64.msi", $MsiPath)

CI/PS-CI.ps1

@@ -0,0 +1,255 @@
+[cmdletbinding(DefaultParameterSetName='Scope')]
+Param(
+    [Parameter(Mandatory = $true, ParameterSetName = 'ModulePath')]
+    [ValidateNotNullOrEmpty()]
+    [String]$ModulePath,
+
+    # Path to install the module to, PSModulePath "CurrentUser" or "AllUsers", if not provided "CurrentUser" used.
+    [Parameter(ParameterSetName = 'Scope')]
+    [ValidateSet('CurrentUser', 'AllUsers')]
+    [string]
+    $Scope = 'CurrentUser',
+
+    [Parameter(Mandatory=$true, ParameterSetName = 'PreCheckOnly')]
+    [switch]$PreCheckOnly,
+    [Parameter(ParameterSetName = 'ModulePath')]
+    [Parameter(ParameterSetName = 'Scope')]
+    [switch]$SkipPreChecks,
+    [Parameter(ParameterSetName = 'ModulePath')]
+    [Parameter(ParameterSetName = 'Scope')]
+    [switch]$SkipPostChecks,
+    [Parameter(ParameterSetName = 'ModulePath')]
+    [Parameter(ParameterSetName = 'Scope')]
+    [switch]$SkipPesterTests,
+    [Parameter(ParameterSetName = 'ModulePath')]
+    [Parameter(ParameterSetName = 'Scope')]
+    [switch]$SkipHelp,
+    [Parameter(ParameterSetName = 'ModulePath')]
+    [Parameter(ParameterSetName = 'Scope')]
+    [switch]$CleanModuleDir
+)
+Function Show-Warning {
+    param(
+        [Parameter(Position=0,ValueFromPipeline=$true)]
+        $message
+    )
+    process {
+        write-output "##vso[task.logissue type=warning]File $message"
+        $message >> $script:warningfile
+    }
+}
+
+if ($PSScriptRoot) {
+    $workingdir = Split-Path -Parent $PSScriptRoot
+    Push-Location $workingdir
+}
+$psdpath = Get-Item "*.psd1"
+if (-not $psdpath -or $psdpath.count -gt 1) {
+    if ($PSScriptRoot) { Pop-Location }
+    throw "Did not find a unique PSD file "
+}
+else {
+    try   {$null        = Test-ModuleManifest -Path $psdpath -ErrorAction stop}
+    catch {throw $_ ; return}
+    $ModuleName         = $psdpath.Name -replace '\.psd1$' , ''
+    $Settings           = $(& ([scriptblock]::Create(($psdpath | Get-Content -Raw))))
+    $approvedVerbs      = Get-Verb | Select-Object -ExpandProperty verb
+    $script:warningfile = Join-Path -Path $pwd -ChildPath "warnings.txt"
+}
+
+#pre-build checks - manifest found, files in it found, public functions and aliases loaded in it. Public functions correct.
+if (-not $SkipPreChecks) {
+
+    #Check files in the manifest are present
+    foreach ($file in $Settings.FileList) {
+        if (-not (Test-Path $file)) {
+           Show-Warning "File $file in the manifest file list is not present"
+        }
+    }
+
+    #Check files in public have Approved_verb-noun names and are 1 function using the file name as its name with
+    #  its name and any alias names in the manifest; function should have a param block and help should be in an MD file
+    # We will want a regex which captures from "function verb-noun {" to its closing "}"
+    # need to match each { to a } - $reg is based on https://stackoverflow.com/questions/7898310/using-regex-to-balance-match-parenthesis
+    $reg  = [Regex]::new(@"
+        function\s*[-\w]+\s*{ # The function name and opening '{'
+            (?:
+            [^{}]+                  # Match all non-braces
+            |
+            (?<open>  { )           # Match '{', and capture into 'open'
+            |
+            (?<-open> } )           # Match '}', and delete the 'open' capture
+            )*
+            (?(open)(?!))           # Fails if 'open' stack isn't empty
+        }                         # Functions closing '}'
+"@, 57)  # 57 = compile,multi-line ignore case and white space.
+    foreach ($file in (Get-Item .\Public\*.ps1)) {
+        $name = $file.name -replace(".ps1","")
+        if ($name -notmatch ("(\w+)-\w+"))         {Show-Warning "$name in the public folder is not a verb-noun name"}
+        elseif ($Matches[1] -notin $approvedVerbs) {Show-Warning "$name in the public folder does not start with an approved verb"}
+        if(-not ($Settings.FunctionsToExport -ceq $name)) {
+            Show-Warning ('File {0} in the public folder does not match an exported function in the manifest' -f $file.name)
+        }
+        else {
+            $fileContent = Get-Content $file -Raw
+            $m    = $reg.Matches($fileContent)
+            if     ($m.Count -eq 0)                         {Show-Warning ('Could not find {0} function in {1}'  -f $name, $file.name); continue}
+            elseif ($m.Count -ge 2)                         {Show-Warning ('Multiple functions in {0}' -f $item.name)         ; Continue}
+            elseif ($m[0] -imatch "^\function\s" -and
+                    $m[0] -cnotmatch "^\w+\s+$name")        {Show-Warning ('function name does not match file name for {0}' -f $file.name)}
+            #$m[0] runs form the f of function to its final }  -find the section up to param, check for aliases & comment-based help
+            $m2 = [regex]::Match($m[0],"^.*?param",17) # 17 = multi-line, ignnore case
+            if (-not $m2.Success)                           {Show-Warning "function $name has no param() block"}
+            else {
+                if ($m2.value -match "(?<!#\s*)\[\s*Alias\(\s*.([\w-]+).\s*\)\s*\]") {
+                    foreach ($a in  ($Matches[1] -split '\s*,\s*')) {
+                        $a = $a -replace "'",""  -replace '"',''
+                        if (-not ($Settings.AliasesToExport   -eq $a)) {
+                            Show-Warning "Function $name has alias $a which is not in the manifest"
+                        }
+                     }
+                }
+                if ($m2.value -match "\.syopsis|\.Description|\.Example") {
+                            Show-Warning "Function $name appears to have comment based help."
+                }
+            }
+        }
+    }
+
+    #Warn about functions which are exported but not found in public
+    $notFromPublic = $Settings.FunctionsToExport.Where({-not (Test-Path ".\public\$_.ps1")})
+    If ($notFromPublic) {Show-Warning ('Exported function(s) {0} are not loaded from the Public folder' -f ($notFromPublic -join ', '))}
+}
+
+if ($PreCheckOnly) {return}
+
+#region build, determine module path if necessary, create target directory if necessary, copy files based on manifest, build help
+try     {
+    if ($ModulePath) {
+        $ModulePath = $ModulePath -replace "\\$|/$",""
+    }
+    else {
+        if ($IsLinux -or $IsMacOS)      {$ModulePathSeparator = ':' }
+        else                            {$ModulePathSeparator = ';' }
+        if ($Scope   -eq 'CurrentUser') {$dir =  [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::UserProfile) }
+        else                            {$dir =  [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::ProgramFiles) }
+        $ModulePath = ($env:PSModulePath -split $ModulePathSeparator).where({$_ -like "$dir*"},"First",1)
+        $ModulePath = Join-Path -Path $ModulePath -ChildPath $ModuleName
+        $ModulePath = Join-Path -Path $ModulePath -ChildPath $Settings.ModuleVersion
+    }
+    # Clean-up / Create Directory
+    if (-not  (Test-Path -Path $ModulePath)) {
+        $null = New-Item -Path $ModulePath -ItemType Directory -ErrorAction Stop
+        'Created module folder: "{0}"' -f $ModulePath
+    }
+    elseif ($CleanModuleDir) {
+        '{0} exists - cleaning before copy' -f $ModulePath
+        Get-ChildItem -Path $ModulePath | Remove-Item -Force -Recurse
+    }
+    'Copying files to:      "{0}"' -f $ModulePath
+    $outputFile = $psdpath | Copy-Item -Destination $ModulePath -PassThru
+    $outputFile.fullname
+    foreach ($file in $Settings.FileList) {
+        if  ($file -like '.\*') {
+             $dest = ($file -replace '\.\\',"$ModulePath\")
+             if (-not (Test-Path -PathType Container (Split-Path -Parent $dest))) {
+                $null = New-item -Type Directory -Path (Split-Path -Parent $dest)
+             }
+        }
+        else  {$dest = $ModulePath }
+        Copy-Item -Path $file  -Destination $dest -Force -Recurse
+    }
+
+    if ((Test-Path -PathType Container "mdHelp") -and -not $SkipHelp) {
+        if (-not (Get-Module -ListAvailable platyPS)) {
+            'Installing Platyps to build help files'
+            Install-Module -Name platyPS -Force -SkipPublisherCheck
+        }
+        $platypsInfo = Import-Module platyPS  -PassThru -force
+        Get-ChildItem .\mdHelp -Directory | ForEach-Object {
+           'Building help for language ''{0}'', using {1} V{2}.' -f $_.Name,$platypsInfo.Name, $platypsInfo.Version
+            $Null = New-ExternalHelp -Path $_.FullName  -OutputPath (Join-Path $ModulePath $_.Name) -Force
+        }
+    }
+    #Leave module path for things which follow.
+    $env:PSNewBuildModule = $ModulePath
+}
+catch   {
+    if ($PSScriptRoot) { Pop-Location }
+    throw ('Failed installing module "{0}". Error: "{1}" in Line {2}' -f $ModuleName, $_, $_.InvocationInfo.ScriptLineNumber)
+}
+finally {
+    if (-not $outputFile -or -not (Test-Path $outputFile)) { throw "Failed to create module"}
+}
+#endregion
+
+if ($env:Build_ArtifactStagingDirectory) {
+    Copy-Item -Path (split-path -Parent $ModulePath) -Destination $env:Build_ArtifactStagingDirectory -Recurse
+}
+
+#Check valid command names, help, run script analyzer over the files in the module directory
+if (-not $SkipPostChecks) {
+    try   {$outputFile | Import-Module -Force -ErrorAction stop }
+    catch {
+            if ($PSScriptRoot) { Pop-Location }
+            throw "New module failed to load"
+    }
+    $commands = Get-Command -Module $ModuleName -CommandType function,Cmdlet
+    $commands.where({$_.name -notmatch "(\w+)-\w+" -or $Matches[1] -notin $approvedVerbs}) | ForEach-Object {
+        Show-Warning ('{0} does not meet the ApprovedVerb-Noun naming rules' -f $_.name)
+    }
+    $helpless = $commands | Get-Help | Where-Object {$_.Synopsis -match "^\s+$($_.name)\s+\["} | Select-Object -ExpandProperty name
+    foreach ($command in $helpless ) {
+        Show-Warning ('On-line help is missing for {0}.' -f $command)
+    }
+    if (-not (Get-Module -Name PSScriptAnalyzer -ListAvailable)) {
+        Install-Module -Name PSScriptAnalyzer -Force
+    }
+    $PSSAInfo = Import-module -Name PSScriptAnalyzer  -PassThru -force
+    "Running {1} V{2} against '{0}' " -f $ModulePath , $PSSAInfo.name, $PSSAInfo.Version
+    $AnalyzerResults = Invoke-ScriptAnalyzer -Path $ModulePath -Recurse -ErrorAction SilentlyContinue
+    if ($AnalyzerResults) {
+        if (-not (Get-Module -Name ImportExcel -ListAvailable)) {
+            #ironically we use this to build import-excel Shouldn't need this there!
+            'Installing ImportExcel.'
+            Install-Module -Name ImportExcel -Force
+        }
+        $chartDef = New-ExcelChartDefinition -ChartType 'BarClustered' -Column 2 -Title "Script analysis" -LegendBold
+        $ExcelParams = @{
+            Path                 = (Join-Path $pwd  'ScriptAnalyzer.xlsx')
+            WorksheetName        = 'FullResults'
+            TableStyle           = 'Medium6'
+            AutoSize             = $true
+            Activate             = $true
+            PivotTableDefinition = @{BreakDown = @{
+                PivotData            = @{RuleName = 'Count' }
+                PivotRows            = 'Severity', 'RuleName'
+                PivotTotals          = 'Rows'
+                PivotChartDefinition = $chartDef }}
+        }
+        Remove-Item -Path $ExcelParams['Path'] -ErrorAction SilentlyContinue
+        $AnalyzerResults | Export-Excel @ExcelParams
+        if (Test-Path $ExcelParams['Path']) {
+            "Try to uploadfile     {0}" -f $ExcelParams['Path']
+            "##vso[task.uploadfile]{0}" -f $ExcelParams['Path']
+        }
+    }
+}
+
+if (Test-Path $script:warningfile) {
+    "Try to uploadfile     {0}" -f $script:warningfile
+    "##vso[task.uploadfile]{0}" -f $script:warningfile
+}
+
+#if there are test files, run pester (unless told not to)
+if (-not $SkipPesterTests -and (Get-ChildItem -Recurse *.tests.ps1)) {
+    Import-Module -Force $outputFile
+    if (-not (Get-Module -ListAvailable pester | Where-Object -Property version -ge ([version]::new(4,4,1)))) {
+        Install-Module Pester -Force -SkipPublisherCheck
+    }
+    Import-Module Pester
+    $PesterOutputPath = Join-Path $pwd  -ChildPath ('TestResultsPS{0}.xml' -f $PSVersionTable.PSVersion)
+    if ($PSScriptRoot) { Pop-Location }
+    Invoke-Pester -OutputFile $PesterOutputPath
+}
+elseif ($PSScriptRoot) { Pop-Location }

CI/Publish.ps1

@@ -2,6 +2,7 @@
     .SYNOPSIS
     Deploy module to PowerShellGallery.
 #>
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseDeclaredVarsMoreThanAssignments", "Success")]
 [CmdletBinding(DefaultParameterSetName = 'ModuleName')]
 Param
 (

CI/PublishToGallery.ps1

@@ -0,0 +1,6 @@
+$p = @{
+    Name        = "ImportExcel"
+    NuGetApiKey = $NuGetApiKey
+}
+
+Publish-Module @p

CI/Test-SingleFunctions.ps1

@@ -0,0 +1,54 @@
+
+function Test-SingleFunction {
+    param (
+    [parameter(ValueFromPipeline=$true)]
+    $path )
+    begin {
+        $psd = Get-Content -Raw "$PSScriptRoot\..\ImportExcel.psd1"
+        $exportedFunctions =  (Invoke-Command ([scriptblock]::Create($psd))).functionsToExport
+        $reg  = [Regex]::new(@"
+          function\s*[-\w]+\s*{ # The function name and opening '{'
+            (?:
+            [^{}]+                  # Match all non-braces
+            |
+            (?<open>  { )           # Match '{', and capture into 'open'
+            |
+            (?<-open> } )           # Match '}', and delete the 'open' capture
+            )*
+            (?(open)(?!))           # Fails if 'open' stack isn't empty
+          }                         # Functions closing '}'
+"@, 57)  # 41 = compile ignore case and white space.
+$reg2  = [Regex]::new(@"
+    ^function\s*[-\w]+\s*{     # The function name and opening '{'
+    (
+        \#.*?[\r\n]+             # single line comment
+        |                        #  or
+        \s*<\#.*?\#>             # <#comment block#>
+        |                        #  or
+        \s*\[.*?\]               # [attribute tags]
+    )*
+"@, 57)
+# 43 = compile, multi-line, ignore case and white space.
+    }
+    process {
+        $item = Get-item $Path
+        $name = $item.Name -replace "\.\w+$",""
+        Write-Verbose $name
+        $file = Get-Content $item -Raw
+        $m    = $reg.Matches($file)
+
+        #based on https://stackoverflow.com/questions/7898310/using-regex-to-balance-match-parenthesis
+        if     ($m.Count -eq 0)                         {return "Could not find $name function in $($item.name)"}
+        elseif ($m.Count -ge 2)                         {return "Multiple functions in $($item.name)"}
+        elseif ($exportedFunctions -cnotcontains $name) {return "$name not exported (or in the wrong case)"}
+        elseif ($m[0] -cnotmatch "^\w+\s+$name")        {return "function $name in wrong case"}
+        $m2 = [regex]::Match($m[0],"param",[System.Text.RegularExpressions.RegexOptions]::IgnoreCase)
+        if (-not $m2.Success)                           {return "No param block in $name"}
+    #    elseif ($m[0] -inotmatch "(?s)^function\s*$name\s*{(\s*<\#.*?\#>|\s*\[.*?\])*\s*param")
+    #    elseif ($reg2.IsMatch($m[0].Value))             {return "function $name has comment-based help"}
+        elseif ($m[0] -inotmatch "\[CmdletBinding\(" -and
+                $m[0] -inotmatch "\[parameter\("   )    {return "$name has is not an advanced function"}
+        #elseif (-not (& $Name -?).synopsis)             {return "$name has no help"}
+        else   {Write-Verbose "$name OK"}
+    }
+}

CI/build.ps1

@@ -0,0 +1,80 @@
+[CmdletBinding(DefaultParameterSetName = 'Default')]
+param(
+    # Path to install the module to, if not provided -Scope used.
+    [Parameter(Mandatory, ParameterSetName = 'ModulePath')]
+    [ValidateNotNullOrEmpty()]
+    [String]$ModulePath,
+
+    # Path to install the module to, PSModulePath "CurrentUser" or "AllUsers", if not provided "CurrentUser" used.
+    [Parameter(Mandatory, ParameterSetName = 'Scope')]
+    [ValidateSet('CurrentUser', 'AllUsers')]
+    [string]
+    $Scope = 'CurrentUser',
+    [switch]$Passthru
+)
+
+if ($PSScriptRoot) { Push-Location "$PSScriptRoot\.." }
+
+$psdpath = Get-Item "*.psd1"
+if (-not $psdpath -or $psdpath.count -gt 1) {
+    throw "Did not find a unique PSD file "
+}
+else {
+    $ModuleName = $psdpath.Name -replace '\.psd1$' , ''
+    $Settings   = $(& ([scriptblock]::Create(($psdpath | Get-Content -Raw))))
+}
+
+try {
+    Write-Verbose -Message 'Module installation started'
+
+    if (!$ModulePath) {
+        if ($IsLinux -or $IsMacOS) {$ModulePathSeparator = ':' }
+        else                       {$ModulePathSeparator = ';' }
+
+        if ($Scope -eq 'CurrentUser') { $dir =  [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::UserProfile) }
+        else                          { $dir =  [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::ProgramFiles) }
+        $ModulePath = ($env:PSModulePath -split $ModulePathSeparator).where({$_ -like "$dir*"},"First",1)
+        $ModulePath = Join-Path -Path $ModulePath -ChildPath $ModuleName
+        $ModulePath = Join-Path -Path $ModulePath -ChildPath $Settings.ModuleVersion
+    }
+
+    # Create Directory
+    if (-not  (Test-Path -Path $ModulePath)) {
+        $null = New-Item -Path $ModulePath -ItemType Directory -ErrorAction Stop
+        Write-Verbose -Message ('Created module folder: "{0}"' -f $ModulePath)
+    }
+
+    Write-Verbose -Message ('Copying files to "{0}"' -f $ModulePath)
+    $outputFile = $psdpath | Copy-Item -Destination $ModulePath -PassThru
+    Foreach ($file in $Settings.FileList) {
+        if  ($file -like '.\*') {
+             $dest = ($file -replace '\.\\',"$ModulePath\")
+             if (-not (Test-Path -PathType Container (Split-Path -Parent $dest))) {
+                $null = New-item -Type Directory -Path (Split-Path -Parent $dest)
+             }
+        }
+        else  {$dest = $ModulePath }
+        Copy-Item $file  -Destination $dest -Force -Recurse
+    }
+
+    if (Test-Path -PathType Container "mdHelp") {
+        if (-not (Get-Module -ListAvailable platyPS)) {
+            Write-Verbose-Message ('Installing Platyps to build help files')
+            Install-Module -Name platyPS -Force -SkipPublisherCheck
+        }
+        Import-Module platyPS
+        Get-ChildItem .\mdHelp -Directory | ForEach-Object {
+            New-ExternalHelp -Path $_.FullName  -OutputPath (Join-Path $ModulePath $_.Name) -Force -Verbose
+        }
+    }
+    $env:PSNewBuildModule = $ModulePath
+
+    if ($Passthru) {$outputFile}
+}
+catch {
+    throw ('Failed installing module "{0}". Error: "{1}" in Line {2}' -f $ModuleName, $_, $_.InvocationInfo.ScriptLineNumber)
+}
+finally {
+    if ($PSScriptRoot) { Pop-Location }
+    Write-Verbose -Message 'Module installation end'
+}

CI/pipeline.yml

@@ -0,0 +1,75 @@
+# https://aka.ms/yaml
+
+trigger:
+  branches:
+    include:
+    - '*'
+    # - master
+    # - releases/*
+  paths:
+    exclude:
+    - README.md
+    - CHANGELOG.md
+
+jobs:
+  - job: 'Windows_PowerShell_all_options'
+    pool:
+      vmImage: 'windows-latest'
+    steps:
+    - powershell: 'Install-Module -Name Pester -Force -SkipPublisherCheck'
+      displayName: 'Update Pester'
+    - powershell: './CI/PS-CI.ps1 '
+      displayName: 'Check Build Check Pack Test'
+    - task: PublishTestResults@2
+      inputs:
+        testResultsFormat: 'NUnit'
+        testResultsFiles: '**/TestResults*.xml'
+        failTaskOnFailedTests: true
+    - task: PublishPipelineArtifact@1
+      inputs:
+        targetPath: '$(Build.ArtifactStagingDirectory)/ImportExcel'
+        artifact: 'ImportExcel'
+
+  - job: 'PowerShell_Core_on_Windows_Build_and_Pester_only'
+    pool:
+      vmImage: 'windows-latest'
+    steps:
+    - pwsh: 'Install-Module -Name Pester -Force'
+      displayName: 'Update Pester'
+    - pwsh: '.\CI\PS-CI.ps1 -SkipPreChecks -SkipHelp -SkipPostChecks'
+      displayName: 'Install and Test'
+    - task: PublishTestResults@2
+      inputs:
+        testResultsFormat: 'NUnit'
+        testResultsFiles: '**/TestResults*.xml'
+        failTaskOnFailedTests: true
+
+  - job: 'Ubuntu_Build_and_Pester_Only'
+    pool:
+      vmImage: 'ubuntu-latest'
+    steps:
+    - powershell: 'Install-Module -Name Pester -Force'
+      displayName: 'Update Pester'
+    - powershell: './CI/PS-CI.ps1 -SkipPreChecks -SkipHelp -SkipPostChecks   '
+      displayName: 'Install and Test'
+    - task: PublishTestResults@2
+      inputs:
+        testResultsFormat: 'NUnit'
+        testResultsFiles: '**/TestResults*.xml'
+        failTaskOnFailedTests: true
+
+  - job: 'macOS_Build_and_Pester_Only'
+    pool:
+      vmImage: 'macOS-latest'
+    steps:
+    - script: brew install mono-libgdiplus
+      displayName: 'Install mono-libgdiplus'
+    - powershell: 'Install-Module -Name Pester -Force'
+      displayName: 'Update Pester'
+    - powershell: './CI/PS-CI.ps1 -SkipPreChecks -SkipHelp -SkipPostChecks'
+      displayName: 'Install and Test'
+    - task: PublishTestResults@2
+      inputs:
+        testResultsFormat: 'NUnit'
+        testResultsFiles: '**/TestResults*.xml'
+        failTaskOnFailedTests: true

Charting/BarChart.md

@@ -0,0 +1,137 @@
+---
+external help file: ImportExcel-help.xml
+Module Name: ImportExcel
+online version:
+schema: 2.0.0
+---
+
+# BarChart
+
+## SYNOPSIS
+{{ Fill in the Synopsis }}
+
+## SYNTAX
+
+```
+BarChart [[-targetData] <Object>] [[-title] <Object>] [[-ChartType] <eChartType>] [-NoLegend] [-ShowCategory]
+ [-ShowPercent] [<CommonParameters>]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -ChartType
+{{ Fill ChartType Description }}
+
+```yaml
+Type: eChartType
+Parameter Sets: (All)
+Aliases:
+Accepted values: Area, Line, Pie, Bubble, ColumnClustered, ColumnStacked, ColumnStacked100, ColumnClustered3D, ColumnStacked3D, ColumnStacked1003D, BarClustered, BarStacked, BarStacked100, BarClustered3D, BarStacked3D, BarStacked1003D, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, PieExploded, PieExploded3D, BarOfPie, XYScatterSmooth, XYScatterSmoothNoMarkers, XYScatterLines, XYScatterLinesNoMarkers, AreaStacked, AreaStacked100, AreaStacked3D, AreaStacked1003D, DoughnutExploded, RadarMarkers, RadarFilled, Surface, SurfaceWireframe, SurfaceTopView, SurfaceTopViewWireframe, Bubble3DEffect, StockHLC, StockOHLC, StockVHLC, StockVOHLC, CylinderColClustered, CylinderColStacked, CylinderColStacked100, CylinderBarClustered, CylinderBarStacked, CylinderBarStacked100, CylinderCol, ConeColClustered, ConeColStacked, ConeColStacked100, ConeBarClustered, ConeBarStacked, ConeBarStacked100, ConeCol, PyramidColClustered, PyramidColStacked, PyramidColStacked100, PyramidBarClustered, PyramidBarStacked, PyramidBarStacked100, PyramidCol, XYScatter, Radar, Doughnut, Pie3D, Line3D, Column3D, Area3D
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -NoLegend
+{{ Fill NoLegend Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowCategory
+{{ Fill ShowCategory Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowPercent
+{{ Fill ShowPercent Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -targetData
+{{ Fill targetData Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -title
+{{ Fill title Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### System.Object
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS

Charting/ColumnChart.md

@@ -0,0 +1,137 @@
+---
+external help file: ImportExcel-help.xml
+Module Name: ImportExcel
+online version:
+schema: 2.0.0
+---
+
+# ColumnChart
+
+## SYNOPSIS
+{{ Fill in the Synopsis }}
+
+## SYNTAX
+
+```
+ColumnChart [[-targetData] <Object>] [[-title] <Object>] [[-ChartType] <eChartType>] [-NoLegend]
+ [-ShowCategory] [-ShowPercent] [<CommonParameters>]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -ChartType
+{{ Fill ChartType Description }}
+
+```yaml
+Type: eChartType
+Parameter Sets: (All)
+Aliases:
+Accepted values: Area, Line, Pie, Bubble, ColumnClustered, ColumnStacked, ColumnStacked100, ColumnClustered3D, ColumnStacked3D, ColumnStacked1003D, BarClustered, BarStacked, BarStacked100, BarClustered3D, BarStacked3D, BarStacked1003D, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, PieExploded, PieExploded3D, BarOfPie, XYScatterSmooth, XYScatterSmoothNoMarkers, XYScatterLines, XYScatterLinesNoMarkers, AreaStacked, AreaStacked100, AreaStacked3D, AreaStacked1003D, DoughnutExploded, RadarMarkers, RadarFilled, Surface, SurfaceWireframe, SurfaceTopView, SurfaceTopViewWireframe, Bubble3DEffect, StockHLC, StockOHLC, StockVHLC, StockVOHLC, CylinderColClustered, CylinderColStacked, CylinderColStacked100, CylinderBarClustered, CylinderBarStacked, CylinderBarStacked100, CylinderCol, ConeColClustered, ConeColStacked, ConeColStacked100, ConeBarClustered, ConeBarStacked, ConeBarStacked100, ConeCol, PyramidColClustered, PyramidColStacked, PyramidColStacked100, PyramidBarClustered, PyramidBarStacked, PyramidBarStacked100, PyramidCol, XYScatter, Radar, Doughnut, Pie3D, Line3D, Column3D, Area3D
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -NoLegend
+{{ Fill NoLegend Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowCategory
+{{ Fill ShowCategory Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowPercent
+{{ Fill ShowPercent Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -targetData
+{{ Fill targetData Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -title
+{{ Fill title Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### System.Object
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS

Charting/LineChart.md

@@ -0,0 +1,137 @@
+---
+external help file: ImportExcel-help.xml
+Module Name: ImportExcel
+online version: https://github.com/dfinke/ImportExcel
+schema: 2.0.0
+---
+
+# LineChart
+
+## SYNOPSIS
+{{ Fill in the Synopsis }}
+
+## SYNTAX
+
+```
+LineChart [[-targetData] <Object>] [[-title] <Object>] [[-ChartType] <eChartType>] [-NoLegend] [-ShowCategory]
+ [-ShowPercent] [<CommonParameters>]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -ChartType
+{{ Fill ChartType Description }}
+
+```yaml
+Type: eChartType
+Parameter Sets: (All)
+Aliases:
+Accepted values: Area, Line, Pie, Bubble, ColumnClustered, ColumnStacked, ColumnStacked100, ColumnClustered3D, ColumnStacked3D, ColumnStacked1003D, BarClustered, BarStacked, BarStacked100, BarClustered3D, BarStacked3D, BarStacked1003D, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, PieExploded, PieExploded3D, BarOfPie, XYScatterSmooth, XYScatterSmoothNoMarkers, XYScatterLines, XYScatterLinesNoMarkers, AreaStacked, AreaStacked100, AreaStacked3D, AreaStacked1003D, DoughnutExploded, RadarMarkers, RadarFilled, Surface, SurfaceWireframe, SurfaceTopView, SurfaceTopViewWireframe, Bubble3DEffect, StockHLC, StockOHLC, StockVHLC, StockVOHLC, CylinderColClustered, CylinderColStacked, CylinderColStacked100, CylinderBarClustered, CylinderBarStacked, CylinderBarStacked100, CylinderCol, ConeColClustered, ConeColStacked, ConeColStacked100, ConeBarClustered, ConeBarStacked, ConeBarStacked100, ConeCol, PyramidColClustered, PyramidColStacked, PyramidColStacked100, PyramidBarClustered, PyramidBarStacked, PyramidBarStacked100, PyramidCol, XYScatter, Radar, Doughnut, Pie3D, Line3D, Column3D, Area3D
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -NoLegend
+{{ Fill NoLegend Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowCategory
+{{ Fill ShowCategory Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowPercent
+{{ Fill ShowPercent Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -targetData
+{{ Fill targetData Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -title
+{{ Fill title Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### System.Object
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS

Charting/PieChart.md

@@ -0,0 +1,137 @@
+---
+external help file: ImportExcel-help.xml
+Module Name: ImportExcel
+online version:
+schema: 2.0.0
+---
+
+# PieChart
+
+## SYNOPSIS
+{{ Fill in the Synopsis }}
+
+## SYNTAX
+
+```
+PieChart [[-targetData] <Object>] [[-title] <Object>] [[-ChartType] <eChartType>] [-NoLegend] [-ShowCategory]
+ [-ShowPercent] [<CommonParameters>]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -ChartType
+{{ Fill ChartType Description }}
+
+```yaml
+Type: eChartType
+Parameter Sets: (All)
+Aliases:
+Accepted values: Area, Line, Pie, Bubble, ColumnClustered, ColumnStacked, ColumnStacked100, ColumnClustered3D, ColumnStacked3D, ColumnStacked1003D, BarClustered, BarStacked, BarStacked100, BarClustered3D, BarStacked3D, BarStacked1003D, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, PieExploded, PieExploded3D, BarOfPie, XYScatterSmooth, XYScatterSmoothNoMarkers, XYScatterLines, XYScatterLinesNoMarkers, AreaStacked, AreaStacked100, AreaStacked3D, AreaStacked1003D, DoughnutExploded, RadarMarkers, RadarFilled, Surface, SurfaceWireframe, SurfaceTopView, SurfaceTopViewWireframe, Bubble3DEffect, StockHLC, StockOHLC, StockVHLC, StockVOHLC, CylinderColClustered, CylinderColStacked, CylinderColStacked100, CylinderBarClustered, CylinderBarStacked, CylinderBarStacked100, CylinderCol, ConeColClustered, ConeColStacked, ConeColStacked100, ConeBarClustered, ConeBarStacked, ConeBarStacked100, ConeCol, PyramidColClustered, PyramidColStacked, PyramidColStacked100, PyramidBarClustered, PyramidBarStacked, PyramidBarStacked100, PyramidCol, XYScatter, Radar, Doughnut, Pie3D, Line3D, Column3D, Area3D
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -NoLegend
+{{ Fill NoLegend Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowCategory
+{{ Fill ShowCategory Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowPercent
+{{ Fill ShowPercent Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -targetData
+{{ Fill targetData Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -title
+{{ Fill title Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### System.Object
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS

Charting/doChart.md

@@ -0,0 +1,134 @@
+---
+external help file: ImportExcel-help.xml
+Module Name: ImportExcel
+online version:
+schema: 2.0.0
+---
+
+# DoChart
+
+## SYNOPSIS
+{{ Fill in the Synopsis }}
+
+## SYNTAX
+
+```
+DoChart [[-targetData] <Object>] [[-title] <Object>] [[-ChartType] <eChartType>] [-NoLegend] [-ShowCategory]
+ [-ShowPercent]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -ChartType
+{{ Fill ChartType Description }}
+
+```yaml
+Type: eChartType
+Parameter Sets: (All)
+Aliases:
+Accepted values: Area, Line, Pie, Bubble, ColumnClustered, ColumnStacked, ColumnStacked100, ColumnClustered3D, ColumnStacked3D, ColumnStacked1003D, BarClustered, BarStacked, BarStacked100, BarClustered3D, BarStacked3D, BarStacked1003D, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, PieExploded, PieExploded3D, BarOfPie, XYScatterSmooth, XYScatterSmoothNoMarkers, XYScatterLines, XYScatterLinesNoMarkers, AreaStacked, AreaStacked100, AreaStacked3D, AreaStacked1003D, DoughnutExploded, RadarMarkers, RadarFilled, Surface, SurfaceWireframe, SurfaceTopView, SurfaceTopViewWireframe, Bubble3DEffect, StockHLC, StockOHLC, StockVHLC, StockVOHLC, CylinderColClustered, CylinderColStacked, CylinderColStacked100, CylinderBarClustered, CylinderBarStacked, CylinderBarStacked100, CylinderCol, ConeColClustered, ConeColStacked, ConeColStacked100, ConeBarClustered, ConeBarStacked, ConeBarStacked100, ConeCol, PyramidColClustered, PyramidColStacked, PyramidColStacked100, PyramidBarClustered, PyramidBarStacked, PyramidBarStacked100, PyramidCol, XYScatter, Radar, Doughnut, Pie3D, Line3D, Column3D, Area3D
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -NoLegend
+{{ Fill NoLegend Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowCategory
+{{ Fill ShowCategory Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowPercent
+{{ Fill ShowPercent Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -targetData
+{{ Fill targetData Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 0
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -title
+{{ Fill title Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS

ColorCompletion.ps1

@@ -1,44 +0,0 @@
-Function ColorCompletion {
-    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter)
-    [System.Drawing.KnownColor].GetFields() | Where-Object {$_.IsStatic -and $_.name -like "$wordToComplete*" } |
-        Sort-Object name | ForEach-Object {New-CompletionResult $_.name $_.name
-    }
-}
-
-if (Get-Command -Name register-argumentCompleter -ErrorAction SilentlyContinue) {
-    Register-ArgumentCompleter -CommandName Export-Excel               -ParameterName TitleBackgroundColor   -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Add-ConditionalFormatting  -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Add-ConditionalFormatting  -ParameterName DataBarColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Add-ConditionalFormatting  -ParameterName ForeGroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Add-ConditionalFormatting  -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Compare-Worksheet          -ParameterName AllDataBackgroundColor -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Compare-Worksheet          -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Compare-Worksheet          -ParameterName FontColor              -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Compare-Worksheet          -ParameterName TabColor               -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Join-Worksheet             -ParameterName TitleBackgroundColor   -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-Worksheet            -ParameterName AddBackgroundColor     -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-Worksheet            -ParameterName ChangeBackgroundColor  -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-Worksheet       `    -ParameterName DeleteBackgroundColor  -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-MulipleSheets        -ParameterName KeyFontColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-MulipleSheets        -ParameterName AddBackgroundColor     -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-MulipleSheets        -ParameterName ChangeBackgroundColor  -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-MulipleSheets   `    -ParameterName DeleteBackgroundColor  -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Merge-MulipleSheets        -ParameterName KeyFontColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ConditionalText        -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ConditionalText        -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ConditionalText        -ParameterName ConditionalTextColor   -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ExcelStyle             -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ExcelStyle             -ParameterName FontColor              -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ExcelStyle             -ParameterName BorderColor            -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName New-ExcelStyle             -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRange             -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRange             -ParameterName FontColor              -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRange             -ParameterName BorderColor            -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRange             -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelColumn            -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelColumn            -ParameterName FontColor              -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelColumn            -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRow               -ParameterName BackgroundColor        -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRow               -ParameterName FontColor              -ScriptBlock $Function:ColorCompletion
-    Register-ArgumentCompleter -CommandName Set-ExcelRow               -ParameterName PatternColor           -ScriptBlock $Function:ColorCompletion
-}

ConvertFromExcelToSQLInsert.ps1

@@ -1,118 +0,0 @@
-function ConvertFrom-ExcelToSQLInsert {
-    <#
-      .SYNOPSIS
-        Generate SQL insert statements from Excel spreadsheet.
-      .DESCRIPTION
-        Generate SQL insert statements from Excel spreadsheet.
-      .PARAMETER TableName
-        Name of the target database table.
-      .PARAMETER Path
-        Path to an existing .XLSX file
-        This parameter is passed to Import-Excel as is.
-      .PARAMETER WorkSheetname
-        Specifies the name of the worksheet in the Excel workbook to import. By default, if no name is provided, the first worksheet will be imported.
-        This parameter is passed to Import-Excel as is.
-      .PARAMETER StartRow
-        The row from where we start to import data, all rows above the StartRow are disregarded. By default this is the first row.
-        When the parameters ‘-NoHeader’ and ‘-HeaderName’ are not provided, this row will contain the column headers that will be used as property names. When one of both parameters are provided, the property names are automatically created and this row will be treated as a regular row containing data.
-      .PARAMETER Header
-        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.
-      .PARAMETER NoHeader
-        Automatically generate property names (P1, P2, P3, ..) instead of the ones defined in the column headers of the TopRow.
-        This switch is best used when you want to import the complete worksheet ‘as is’ and are not concerned with the property names.
-      .PARAMETER DataOnly
-        Import only rows and columns that contain data, empty rows and empty columns are not imported.
-      .PARAMETER ConvertEmptyStringsToNull
-        If specified, cells without any data are replaced with NULL, instead of an empty string.
-        This is to address behviors in certain DBMS where an empty string is insert as 0 for INT column, instead of a NULL value.
-
-      .EXAMPLE
-        Generate SQL insert statements from Movies.xlsx file, leaving blank cells as empty strings:
-
-        ----------------------------------------------------------
-        | File: Movies.xlsx            -           Sheet: Sheet1 |
-        ----------------------------------------------------------
-        |           A            B            C                  |
-        |1     Movie Name      Year         Rating               |
-        |2     The Bodyguard   1992           9                  |
-        |3     The Matrix      1999           8                  |
-        |4     Skyfall         2012           9                  |
-        |5     The Avengers    2012                              |
-        ----------------------------------------------------------
-
-        PS C:\> Import-Excel -TableName "Movies" -Path 'C:\Movies.xlsx'
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Bodyguard', '1992', '9');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Matrix', '1999', '8');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('Skyfall', '2012', '9');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Avengers', '2012', '');
-
-      .EXAMPLE
-        Generate SQL insert statements from Movies.xlsx file, specify NULL instead of an empty string.
-
-        ----------------------------------------------------------
-        | File: Movies.xlsx            -           Sheet: Sheet1 |
-        ----------------------------------------------------------
-        |           A            B            C                  |
-        |1     Movie Name      Year         Rating               |
-        |2     The Bodyguard   1992           9                  |
-        |3     The Matrix      1999           8                  |
-        |4     Skyfall         2012           9                  |
-        |5     The Avengers    2012                              |
-        ----------------------------------------------------------
-
-        PS C:\> ConvertFrom-ExcelToSQLInsert -TableName "Movies" -Path "C:\Movies.xlsx" -ConvertEmptyStringsToNull
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Bodyguard', '1992', '9');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Matrix', '1999', '8');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('Skyfall', '2012', '9');
-        INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Avengers', '2012', NULL);
-
-    #>
-    [CmdletBinding()]
-    param(
-        [Parameter(Mandatory = $true)]
-        $TableName,
-        [Alias("FullName")]
-        [Parameter(ValueFromPipelineByPropertyName = $true, ValueFromPipeline = $true, Mandatory = $true)]
-        [ValidateScript( { Test-Path $_ -PathType Leaf })]
-        $Path,
-        [Alias("Sheet")]
-        $WorkSheetname = 1,
-        [Alias('HeaderRow', 'TopRow')]
-        [ValidateRange(1, 9999)]
-        [Int]$StartRow,
-        [string[]]$Header,
-        [switch]$NoHeader,
-        [switch]$DataOnly,
-        [switch]$ConvertEmptyStringsToNull,
-        [switch]$UseMSSQLSyntax
-    )
-
-    $null = $PSBoundParameters.Remove('TableName')
-    $null = $PSBoundParameters.Remove('ConvertEmptyStringsToNull')
-    $null = $PSBoundParameters.Remove('UseMSSQLSyntax')
-
-    $params = @{} + $PSBoundParameters
-
-    ConvertFrom-ExcelData @params {
-        param($propertyNames, $record)
-
-        $ColumnNames = "'" + ($PropertyNames -join "', '") + "'"
-        if($UseMSSQLSyntax) {
-            $ColumnNames = "[" + ($PropertyNames -join "], [") + "]"
-        }
-
-        $values = foreach ($propertyName in $PropertyNames) {
-            if ($ConvertEmptyStringsToNull.IsPresent -and [string]::IsNullOrEmpty($record.$propertyName)) {
-                'NULL'
-            }
-            else {
-                "'" + $record.$propertyName + "'"
-            }
-        }
-        $targetValues = ($values -join ", ")
-
-        "INSERT INTO {0} ({1}) Values({2});" -f $TableName, $ColumnNames, $targetValues
-    }
-}

Examples/AddWorkSheet/AddMultiWorkSheet.ps1

@@ -1,15 +1,15 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlSourcefile = "$env:TEMP\Source.xlsx"
-write-host "Save location: $xlSourcefile"
+Write-Verbose -Verbose -Message  "Save location: $xlSourcefile"
 
 Remove-Item $xlSourcefile -ErrorAction Ignore
 
 #Put some simple data in a worksheet and Get an excel package object to represent the file
-$TabData1 = 1..5 | Export-Excel $xlSourcefile -WorksheetName 'Tab 1' -AutoSize -AutoFilter
+1..5 | Export-Excel $xlSourcefile -WorksheetName 'Tab1' -AutoSize -AutoFilter
 
 #Add another tab.  Replace the $TabData2 with your data
-$TabData2 = 1..10 | Export-Excel $xlSourcefile -WorksheetName 'Tab 2' -AutoSize -AutoFilter
+1..10 | Export-Excel $xlSourcefile -WorksheetName 'Tab 2' -AutoSize -AutoFilter
 
 #Add another tab.  Replace the $TabData3 with your data
-$TabData3 = 1..15  | Export-Excel $xlSourcefile -WorksheetName 'Tab 3' -AutoSize -AutoFilter -Show
+1..15  | Export-Excel $xlSourcefile -WorksheetName 'Tab 3' -AutoSize -AutoFilter -Show

Examples/AddWorkSheet/AddWorkSheet.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlSourcefile = "$env:TEMP\Source.xlsx"
 
@@ -7,6 +7,6 @@ Remove-Item $xlSourcefile -ErrorAction Ignore
 #Put some simple data in a worksheet and Get an excel package object to represent the file
 $excel = 1..10 | Export-Excel $xlSourcefile -PassThru
 #Add a new worksheet named 'NewSheet' and copying the sheet that was just made (Sheet1) to the new sheet
-Add-WorkSheet -ExcelPackage $excel -WorkSheetname "NewSheet" -CopySource $excel.Workbook.Worksheets["Sheet1"]
+Add-Worksheet -ExcelPackage $excel -WorkSheetname "NewSheet" -CopySource $excel.Workbook.Worksheets["Sheet1"]
 #Save and open in Excel
 Close-ExcelPackage -ExcelPackage $excel -Show

Examples/Charts/MultiSeries.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item temp.xlsx -ErrorAction Ignore
 

Examples/Charts/MultiSeries1.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item temp.xlsx -ErrorAction Ignore
 

Examples/Charts/MultipleCharts.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item -Path Tools.xlsx
 

Examples/Charts/plot.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 function plot {
     param(
@@ -25,4 +25,4 @@ function plot {
 
 function pi {[math]::pi}
 
-plot {[math]::Tan($args[0])} (pi) (3*(pi)/2-.01)
+plot -f {[math]::Tan($args[0])} -minx (pi) -maxx (3*(pi)/2-.01)

Examples/CommunityContributions/MultipleWorksheets.ps1

@@ -0,0 +1,27 @@
+<#
+    To see this written up with example screenshots, head over to the IT Splat blog
+    URL: http://bit.ly/2SxieeM
+#>
+
+## Create an Excel file with multiple worksheets
+# Get a list of processes on the system
+$processes = Get-Process | Sort-Object -Property ProcessName | Group-Object -Property ProcessName | Where-Object {$_.Count -gt 2}
+
+# Export the processes to Excel, each process on its own sheet
+$processes | ForEach-Object { $_.Group | Export-Excel -Path MultiSheetExample.xlsx -WorksheetName $_.Name -AutoSize -AutoFilter }
+
+# Show the completed file
+Invoke-Item .\MultiSheetExample.xlsx
+
+## Add an additional sheet to the new workbook
+# Use Open-ExcelPackage to open the workbook
+$excelPackage = Open-ExcelPackage -Path .\MultiSheetExample.xlsx
+
+# Create a new worksheet and give it a name, set MoveToStart to make it the first sheet
+$ws = Add-Worksheet -ExcelPackage $excelPackage -WorksheetName 'All Services' -MoveToStart
+
+# Get all the running services on the system
+Get-Service | Export-Excel -ExcelPackage $excelPackage -WorksheetName $ws -AutoSize -AutoFilter
+
+# Close the package and show the final result
+Close-ExcelPackage -ExcelPackage $excelPackage -Show

Examples/ConditionalFormatting/CodeGenExamples.ps1

@@ -1,9 +1,9 @@
-echo Last7Days LastMonth LastWeek NextMonth NextWeek ThisMonth ThisWeek Today Tomorrow Yesterday |
+"Last7Days", "LastMonth", "LastWeek", "NextMonth", "NextWeek", "ThisMonth", "ThisWeek", "Today", "Tomorrow", "Yesterday" |
     Foreach-Object {
     $text = @"
 `$f = ".\testExport.xlsx"
 
-rm `$f -ErrorAction Ignore
+remove-item `$f -ErrorAction Ignore
 
 .\GenDates.ps1 |
     Export-Excel `$f -Show -AutoSize -ConditionalText `$(

Examples/ConditionalFormatting/ConditionalText.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "$env:temp\conditionalTextFormatting.xlsx"
 Remove-Item $file -ErrorAction Ignore

Examples/ConditionalFormatting/ContainsBlanks.ps1

@@ -1,10 +1,10 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 #Define a "Contains blanks" rule. No format is specified so it default to dark-red text on light-pink background.
 $ContainsBlanks = New-ConditionalText -ConditionalType ContainsBlanks
 
 $data = $(
-    New-PSItem a b c (echo p1 p2 p3)
+    New-PSItem a b c @('p1', 'p2', 'p3')
     New-PSItem
     New-PSItem d e f
     New-PSItem

Examples/ConditionalFormatting/Databar.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $path = "$env:temp\test.xlsx"
 Remove-Item -Path $path -ErrorAction Ignore
@@ -10,23 +10,23 @@ $excel = Get-Process |
 
 $sheet = $excel.Workbook.Worksheets["Processes"]
 
-#Apply fixed formatting to columns. Set-Format is an Alias for Set-Excel Range, -NFormat is an alias for numberformat
+#Apply fixed formatting to columns.  -NFormat is an alias for numberformat
 $sheet.Column(1) | Set-ExcelRange -Bold -AutoFit
-$sheet.Column(2) | Set-Format -Width 29 -WrapText
-$sheet.Column(3) | Set-Format -HorizontalAlignment Right -NFormat "#,###"
+$sheet.Column(2) | Set-ExcelRange -Width 29 -WrapText
+$sheet.Column(3) | Set-ExcelRange -HorizontalAlignment Right -NFormat "#,###"
 
 Set-ExcelRange -Range -Address $sheet.Cells["E1:H1048576"]  -HorizontalAlignment Right -NFormat "#,###"
-#Set-Format is an alias for Set-ExcelRange
-Set-Format -Range   $sheet.Column(4)  -HorizontalAlignment Right -NFormat "#,##0.0" -Bold
-#In Set-ExcelRange / Set-Format "-Address" is an alias for "-Range"
-Set-Format -Address $sheet.Row(1) -Bold -HorizontalAlignment Center
+
+Set-ExcelRange -Range   $sheet.Column(4)  -HorizontalAlignment Right -NFormat "#,##0.0" -Bold
+#In Set-ExcelRange   "-Address" is an alias for "-Range"
+Set-ExcelRange -Address $sheet.Row(1) -Bold -HorizontalAlignment Center
 
 #Create a Red Data-bar for the values in Column D
-Add-ConditionalFormatting -WorkSheet $sheet -Address "D2:D1048576" -DataBarColor Red
+Add-ConditionalFormatting -Worksheet $sheet -Address "D2:D1048576" -DataBarColor Red
 # Conditional formatting applies to "Addreses" aliases allow either "Range" or "Address" to be used in Set-ExcelRange or Add-Conditional formatting.
-Add-ConditionalFormatting -WorkSheet $sheet -Range  "G2:G1048576" -RuleType GreaterThan -ConditionValue "104857600"  -ForeGroundColor Red
+Add-ConditionalFormatting -Worksheet $sheet -Range  "G2:G1048576" -RuleType GreaterThan -ConditionValue "104857600"  -ForeGroundColor Red
 
-foreach ($c in 5..9) {Set-Format -Address $sheet.Column($c)  -AutoFit }
+foreach ($c in 5..9) {Set-ExcelRange -Address $sheet.Column($c)  -AutoFit }
 
 #Create a pivot and save the file.
 Export-Excel -ExcelPackage $excel -WorkSheetname "Processes" -IncludePivotChart -ChartType ColumnClustered -NoLegend -PivotRows company  -PivotData @{'Name'='Count'}  -Show

Examples/ConditionalFormatting/FormatCalculations.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = "$env:TEMP\testExport.xlsx"
 
@@ -6,7 +6,7 @@ Remove-Item $f -ErrorAction Ignore
 
 $data = $(
 
-    New-PSItem North 111 (echo Region Amount )
+    New-PSItem North 111 @( 'Region', 'Amount' )
     New-PSItem East 111
     New-PSItem West 122
     New-PSItem South 200
@@ -21,8 +21,8 @@ $data = $(
     New-PSItem Westerly 120
     New-PSItem SouthWest 118
 )
-# in this example instead of doing $variable = New-Conditional text <parameters> .... ; Export-excel -conditionalText $variable <other parameters>
-# the syntax is used is Export-excel -conditionalText (New-Conditional text <parameters>) <other parameters>
+# in this example instead of doing $variable = New-Conditional text <parameters> .... ; Export-excel -ConditionalText $variable <other parameters>
+# the syntax is used is Export-excel -ConditionalText (New-Conditional text <parameters>) <other parameters>
 
 
 #$data  | Export-Excel $f -Show -AutoSize -ConditionalText (New-ConditionalText -ConditionalType AboveAverage)

Examples/ConditionalFormatting/GenDates.ps1

@@ -1,6 +1,6 @@
 function Get-DateOffset {
     param($days=0)
-    
+
     (Get-Date).AddDays($days).ToShortDateString()
 }
 
@@ -8,7 +8,7 @@ function Get-Number {
     Get-Random -Minimum 10 -Maximum 100
 }
 
-New-PSItem (Get-DateOffset -7)  (Get-Number) 'LastWeek,Last7Days,ThisMonth' (echo Date Amount Label)
+New-PSItem (Get-DateOffset -7)  (Get-Number) 'LastWeek,Last7Days,ThisMonth' @('Date', 'Amount', 'Label')
 New-PSItem (Get-DateOffset)     (Get-Number) 'Today,ThisMonth,ThisWeek'
 New-PSItem (Get-DateOffset -30) (Get-Number) LastMonth
 New-PSItem (Get-DateOffset -1)  (Get-Number) 'Yesterday,ThisMonth,ThisWeek'

Examples/ConditionalFormatting/GetProcess.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item "$env:TEMP\testExport.xlsx" -ErrorAction Ignore
 

Examples/ConditionalFormatting/Highlight-Last7Days.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-LastMonth.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-LastWeek.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-NextMonth.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-NextWeek.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-ThisMonth.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-ThisWeek.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-Today.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-Tomorrow.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/Highlight-Yesterday.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 

Examples/ConditionalFormatting/HighlightDuplicates.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 
@@ -6,7 +6,7 @@ Remove-Item $f -ErrorAction Ignore
 
 $data = $(
 
-    New-PSItem North 111 (echo Region Amount )
+    New-PSItem North 111 @('Region', 'Amount' )
     New-PSItem East 11
     New-PSItem West 12
     New-PSItem South 1000

Examples/ConditionalFormatting/MonthlyTemperatuesDatabar.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item -Path .\test.xlsx -ErrorAction Ignore
 
@@ -20,6 +20,6 @@ Dec,44,63,46
     Export-Excel -Path .\test.xlsx -WorkSheetname Sheet1 -AutoNameRange -AutoSize -Title "Monthly Temperatures" -PassThru
 
 $sheet = $excel.Workbook.Worksheets["Sheet1"]
-Add-ConditionalFormatting -WorkSheet $sheet -Range "B1:D14" -DataBarColor CornflowerBlue
+Add-ConditionalFormatting -Worksheet $sheet -Range "B1:D14" -DataBarColor CornflowerBlue
 
 Close-ExcelPackage $excel -Show

Examples/ConditionalFormatting/RangeFormatting.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = ".\testExport.xlsx"
 Remove-Item $f -ErrorAction Ignore
@@ -8,7 +8,7 @@ function Get-DateOffset ($days=0) {
 }
 
 $(
-    New-PSItem (Get-DateOffset -1) (Get-DateOffset 1) (echo Start End)
+    New-PSItem (Get-DateOffset -1) (Get-DateOffset 1) @("Start", "End")
     New-PSItem (Get-DateOffset) (Get-DateOffset 7)
     New-PSItem (Get-DateOffset -10) (Get-DateOffset -1)
 ) |

Examples/ConditionalFormatting/SalesReportWithDatabar.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Remove-Item -Path .\test.xlsx -ErrorAction Ignore
 
@@ -14,9 +14,9 @@ Jun,621
      Export-Excel -Path .\test.xlsx -WorkSheetname Sheet1 -AutoNameRange -PassThru
 
 $sheet = $excel.Workbook.Worksheets["Sheet1"]
-Add-ConditionalFormatting -WorkSheet $sheet -Range "B1:B7" -DataBarColor LawnGreen
+Add-ConditionalFormatting -Worksheet $sheet -Range "B1:B7" -DataBarColor LawnGreen
 
-Set-Format -Address $sheet.Cells["A8"] -Value "Total"
-Set-Format -Address $sheet.Cells["B8"] -Formula "=Sum(Sales)"
+Set-ExcelRange -Address $sheet.Cells["A8"] -Value "Total"
+Set-ExcelRange -Address $sheet.Cells["B8"] -Formula "=Sum(Sales)"
 
 Close-ExcelPackage $excel -Show

Examples/ConditionalFormatting/TextComparisons.ps1

@@ -1,7 +1,7 @@
-try {ipmo ..\..\ImportExcel.psd1 -Force} catch {}
+try {Import-Module ..\..\ImportExcel.psd1 -Force} catch {throw ; return}
 
 $data = $(
-    New-PSItem 100 (echo test testx)
+    New-PSItem 100 @('test', 'testx')
     New-PSItem 200
     New-PSItem 300
     New-PSItem 400
@@ -11,8 +11,8 @@ $data = $(
 $file1 = "$env:Temp\tryComparison1.xlsx"
 $file2 = "$env:Temp\tryComparison2.xlsx"
 
-rm $file1 -ErrorAction Ignore
-rm $file2 -ErrorAction Ignore
+Remove-Item -Path $file1 -ErrorAction Ignore
+Remove-Item -Path  $file2 -ErrorAction Ignore
 
 $data | Export-Excel $file1 -Show -ConditionalText $(
     New-ConditionalText -ConditionalType GreaterThan 300

Examples/ConvertFrom/ConvertFrom.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 ConvertFrom-ExcelToSQLInsert People .\testSQLGen.xlsx
 

Examples/CustomReporting/CustomReport.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $f = "$env:temp\dashboard.xlsx"
 Remove-Item $f -ErrorAction Ignore
@@ -22,51 +22,51 @@ $sheet1 = $excel.Workbook.Worksheets["sheet1"]
 $sheet1.View.ShowGridLines = $false
 $sheet1.View.ShowHeaders = $false
 
-Set-Format -Address $sheet1.Cells["C:C"] -NumberFormat "$#,##0" -WrapText -HorizontalAlignment Center
-Set-Format -Address $sheet1.Cells["D:D"] -NumberFormat "#.#0%"  -WrapText -HorizontalAlignment Center
+Set-ExcelRange -Address $sheet1.Cells["C:C"] -NumberFormat "$#,##0" -WrapText -HorizontalAlignment Center
+Set-ExcelRange -Address $sheet1.Cells["D:D"] -NumberFormat "#.#0%"  -WrapText -HorizontalAlignment Center
 
-Set-Format -Address $sheet1.Cells["E:E"] -NumberFormat "$#,##0" -WrapText -HorizontalAlignment Center
-Set-Format -Address $sheet1.Cells["F:F"] -NumberFormat "#.#0%"  -WrapText -HorizontalAlignment Center
+Set-ExcelRange -Address $sheet1.Cells["E:E"] -NumberFormat "$#,##0" -WrapText -HorizontalAlignment Center
+Set-ExcelRange -Address $sheet1.Cells["F:F"] -NumberFormat "#.#0%"  -WrapText -HorizontalAlignment Center
 
-Set-Format -Address $sheet1.Cells["G:H"] -WrapText -HorizontalAlignment Center
+Set-ExcelRange -Address $sheet1.Cells["G:H"] -WrapText -HorizontalAlignment Center
 
 ## Insert Rows/Columns
 $sheet1.InsertRow(1, 1)
 
-foreach ($col in Write-Output 2 4 6 8 10 12 14) {
+foreach ($col in @(2, 4, 6, 8, 10, 12, 14)) {
     $sheet1.InsertColumn($col, 1)
     $sheet1.Column($col).width = .75
 }
 
-Set-Format -Address $sheet1.Cells["E:E"] -Width 12
-Set-Format -Address $sheet1.Cells["I:I"] -Width 12
+Set-ExcelRange -Address $sheet1.Cells["E:E"] -Width 12
+Set-ExcelRange -Address $sheet1.Cells["I:I"] -Width 12
 
 $BorderBottom = "Thick"
 $BorderColor = "Black"
 
-Set-Format -Address $sheet1.Cells["A2"]    -BorderBottom $BorderBottom -BorderColor $BorderColor
+Set-ExcelRange -Address $sheet1.Cells["A2"]    -BorderBottom $BorderBottom -BorderColor $BorderColor
 
-Set-Format -Address $sheet1.Cells["C2"]    -BorderBottom $BorderBottom -BorderColor $BorderColor
-Set-Format -Address $sheet1.Cells["E2:G2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
-Set-Format -Address $sheet1.Cells["I2:K2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
-Set-Format -Address $sheet1.Cells["M2:O2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
+Set-ExcelRange -Address $sheet1.Cells["C2"]    -BorderBottom $BorderBottom -BorderColor $BorderColor
+Set-ExcelRange -Address $sheet1.Cells["E2:G2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
+Set-ExcelRange -Address $sheet1.Cells["I2:K2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
+Set-ExcelRange -Address $sheet1.Cells["M2:O2"] -BorderBottom $BorderBottom -BorderColor $BorderColor
 
-Set-Format -Address $sheet1.Cells["A2:C8"] -FontColor Gray
+Set-ExcelRange -Address $sheet1.Cells["A2:C8"] -FontColor Gray
 
 $HorizontalAlignment = "Center"
-Set-Format -Address $sheet1.Cells["F1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Revenue
-Set-Format -Address $sheet1.Cells["J1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Margin
-Set-Format -Address $sheet1.Cells["N1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Passenger
+Set-ExcelRange -Address $sheet1.Cells["F1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Revenue
+Set-ExcelRange -Address $sheet1.Cells["J1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Margin
+Set-ExcelRange -Address $sheet1.Cells["N1"] -HorizontalAlignment $HorizontalAlignment -Bold -Value Passenger
 
-Set-Format -Address $sheet1.Cells["E2"] -Value '($)'
-Set-Format -Address $sheet1.Cells["G2"] -Value '%'
-Set-Format -Address $sheet1.Cells["I2"] -Value '($)'
-Set-Format -Address $sheet1.Cells["K2"] -Value '%'
+Set-ExcelRange -Address $sheet1.Cells["E2"] -Value '($)'
+Set-ExcelRange -Address $sheet1.Cells["G2"] -Value '%'
+Set-ExcelRange -Address $sheet1.Cells["I2"] -Value '($)'
+Set-ExcelRange -Address $sheet1.Cells["K2"] -Value '%'
 
-Set-Format -Address $sheet1.Cells["C10"] -HorizontalAlignment Right -Bold -Value "Grand Total Calculation"
-Set-Format -Address $sheet1.Cells["E10"] -Formula "=Sum(E3:E8)" -Bold
-Set-Format -Address $sheet1.Cells["I10"] -Formula "=Sum(I3:I8)" -Bold
-Set-Format -Address $sheet1.Cells["M10"] -Formula "=Sum(M3:M8)" -Bold
-Set-Format -Address $sheet1.Cells["O10"] -Formula "=Sum(O3:O8)" -Bold
+Set-ExcelRange -Address $sheet1.Cells["C10"] -HorizontalAlignment Right -Bold -Value "Grand Total Calculation"
+Set-ExcelRange -Address $sheet1.Cells["E10"] -Formula "=Sum(E3:E8)" -Bold
+Set-ExcelRange -Address $sheet1.Cells["I10"] -Formula "=Sum(I3:I8)" -Bold
+Set-ExcelRange -Address $sheet1.Cells["M10"] -Formula "=Sum(M3:M8)" -Bold
+Set-ExcelRange -Address $sheet1.Cells["O10"] -Formula "=Sum(O3:O8)" -Bold
 
 Close-ExcelPackage $excel -Show

Examples/CustomizeExportExcel/Out-Excel.ps1

@@ -10,7 +10,7 @@
        Preset2 will set AutoFilter and add the Title "Daily Report".
        (see comments and code below).
 #>
-Function Out-Excel {
+function Out-Excel {
     [CmdletBinding(DefaultParameterSetName = 'Default')]
     param(
         [switch]

Examples/ExcelBuiltIns/DSUM.ps1

@@ -0,0 +1,31 @@
+# DSUM
+# Adds the numbers in a field (column) of records in a list or database that match conditions that you specify.
+
+$xlfile = "$env:TEMP\test.xlsx"
+Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+$data = ConvertFrom-Csv @"
+Color,Date,Sales
+Red,1/15/2018,250
+Blue,1/15/2018,200
+Red,1/16/2018,175
+Blue,1/16/2018,325
+Red,1/17/2018,150
+Blue,1/17/2018,300
+"@
+
+$xl = Export-Excel -InputObject $data -Path $xlfile -AutoSize -AutoFilter -TableName SalesInfo -AutoNameRange -PassThru
+
+$databaseAddress = $xl.Sheet1.Dimension.Address
+Set-Format -Worksheet $xl.Sheet1 -Range C:C -NumberFormat '$##0'
+
+Set-Format -Worksheet $xl.Sheet1 -Range E1 -Value Color
+Set-Format -Worksheet $xl.Sheet1 -Range F1 -Value Date
+Set-Format -Worksheet $xl.Sheet1 -Range G1 -Value Sales
+
+Set-Format -Worksheet $xl.Sheet1 -Range E2 -Value Red
+
+Set-Format -Worksheet $xl.Sheet1 -Range E4 -Value Sales
+Set-Format -Worksheet $xl.Sheet1 -Range F4 -Formula ('=DSUM({0},"Sales",E1:G2)' -f $databaseAddress) -NumberFormat '$##0'
+
+Close-ExcelPackage $xl -Show

Examples/ExcelBuiltIns/VLOOKUP.ps1

@@ -0,0 +1,19 @@
+$xlfile = "$env:TEMP\test.xlsx"
+Remove-Item $xlfile -ErrorAction SilentlyContinue
+
+$data = ConvertFrom-Csv @"
+Fruit,Amount
+Apples,50
+Oranges,20
+Bananas,60
+Lemons,40
+"@
+
+$xl = Export-Excel -InputObject $data -Path $xlfile -PassThru -AutoSize
+
+Set-ExcelRange -Worksheet $xl.Sheet1 -Range D2 -BackgroundColor LightBlue -Value Apples
+
+$Rows = $xl.Sheet1.Dimension.Rows
+Set-ExcelRange -Worksheet $xl.Sheet1 -Range E2 -Formula "=VLookup(D2,A2:B$($Rows),2,FALSE)"
+
+Close-ExcelPackage $xl -Show

Examples/ExcelDataValidation/MutipleValidations.ps1

@@ -13,7 +13,7 @@
         * Add .01 in column F
 #>
 
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $path = "$Env:TEMP\DataValidation.xlsx"
 Remove-Item $path -ErrorAction SilentlyContinue
@@ -39,7 +39,7 @@ $excelPackage = @('Chisel', 'Crowbar', 'Drill', 'Hammer', 'Nails', 'Saw', 'Screw
 
 #region Creating a list using a PowerShell array
 $ValidationParams = @{
-    WorkSheet        = $excelPackage.sales
+    Worksheet        = $excelPackage.sales
     ShowErrorMessage = $true
     ErrorStyle       = 'stop'
     ErrorTitle       = 'Invalid Data'

Examples/ExcelToSQLInsert/DemoSQLInsert.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 ConvertFrom-ExcelToSQLInsert -TableName "Movies" -Path ".\Movies.xlsx" -ConvertEmptyStringsToNull
 ''

Examples/Fibonacci/ShowFibonacci.ps1

@@ -1,6 +1,6 @@
 param ($fibonacciDigits=10)
 
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "fib.xlsx"
 Remove-Item "fib.xlsx" -ErrorAction Ignore

Examples/FormatCellStyles/ApplyFormatInScriptBlock.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlfile = "$env:temp\testFmt.xlsx"
 

Examples/FormatCellStyles/ApplyStyle.ps1

@@ -16,9 +16,9 @@ $pkg = $data | Export-Excel -Path $f -AutoSize -PassThru
 
 $ws = $pkg.Workbook.Worksheets["Sheet1"]
 
-Set-ExcelRange -WorkSheet $ws -Range "A2:C6" -BackgroundColor PeachPuff -FontColor Purple        -FontSize 12 -Width 12
-Set-ExcelRange -WorkSheet $ws -Range "D2:D6" -BackgroundColor WhiteSmoke -FontColor Orange -Bold -FontSize 12 -Width 12
-Set-ExcelRange -WorkSheet $ws -Range "A1:D1" -BackgroundColor BlueViolet -FontColor Wheat        -FontSize 12 -Width 12
-Set-ExcelRange -WorkSheet $ws -Range "A:A"                                                                    -Width 15
+Set-ExcelRange -Worksheet $ws -Range "A2:C6" -BackgroundColor PeachPuff -FontColor Purple        -FontSize 12 -Width 12
+Set-ExcelRange -Worksheet $ws -Range "D2:D6" -BackgroundColor WhiteSmoke -FontColor Orange -Bold -FontSize 12 -Width 12
+Set-ExcelRange -Worksheet $ws -Range "A1:D1" -BackgroundColor BlueViolet -FontColor Wheat        -FontSize 12 -Width 12
+Set-ExcelRange -Worksheet $ws -Range "A:A"                                                                    -Width 15
 
 Close-ExcelPackage -ExcelPackage $pkg -Show

Examples/FormatCellStyles/PassInScriptBlock.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlfile = "$env:temp\testFmt.xlsx"
 Remove-Item $xlfile -ErrorAction Ignore
@@ -11,7 +11,7 @@ $RandomStyle = {
     )
 
     2..$totalRows | ForEach-Object{
-        Set-CellStyle $workSheet $_ $LastColumn Solid (Write-Output LightGreen Gray Red|Get-Random)
+        Set-CellStyle $workSheet $_ $LastColumn Solid (Get-Random @("LightGreen", "Gray", "Red"))
     }
 }
 

Examples/GenerateData/GenDataForCustomReport.ps1

@@ -1,26 +1,26 @@
-if(!(gcm ig -ErrorAction SilentlyContinue)) {
+if(!(Get-Command ig -ErrorAction SilentlyContinue)) {
 
     "Use ``Install-Module NameIT`` to get the needed module from the gallery to support running this script"
 
     return
-} 
+}
 
-$sign=@{sign=echo + -}
-$location=@{location=echo Atlanta Newark Washington Chicago Philadelphia Houston Phoneix}
+$sign=@{sign=@( "+", "-" )}
+$location=@{location=@("Atlanta", "Newark", "Washington", "Chicago", "Philadelphia", "Houston", "Phoneix")}
 
 $(1..6 | Foreach-Object {
-    
+
     $from=$to=""
     while($from -eq $to) {
         $from=ig "[location]" -CustomData $location
         $to=ig "[location]" -CustomData $location
-    }    
+    }
 
     [double]$a=ig "########"
     [double]$b=ig ".####"
     [double]$c=ig "#######"
     [double]$d=ig "[sign].##" -CustomData $sign
-    [double]$e=ig "###" 
+    [double]$e=ig "###"
     [double]$f=ig "[sign]##" -CustomData $sign
 
     #"{0},{1},{2},{3},{4},{5},{6},{7}" -f $from, $to, $a, $b, $c, $d, $e, $f

Examples/Grouping/TimestampBucket.ps1

@@ -13,7 +13,7 @@ Timestamp,Tenant
 10/29/2018 3:01:40.989,1
 10/29/2018 3:01:50.545,1
 10/29/2018 3:02:00.999,1
-"@ | Select-Object @{n = 'Timestamp'; e = {get-date $_.timestamp}}, tenant, @{n = 'Bucket'; e = { - (get-date $_.timestamp).Second % 30}}
+"@ | Select-Object @{n = 'Timestamp'; e = {Get-date $_.timestamp}}, tenant, @{n = 'Bucket'; e = { - (Get-date $_.timestamp).Second % 30}}
 
 $f = "$env:temp\pivottest.xlsx"
 Remove-Item $f -ErrorAction SilentlyContinue

Examples/HyperLinks/Hyperlinks.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 @"
 site,link

Examples/ImportHtml/DemoGraphics.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 
 Import-Html "http://en.wikipedia.org/wiki/Demographics_of_India" 4

Examples/ImportHtml/PeriodicElements.ps1

@@ -1,3 +1,3 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Import-Html "http://www.science.co.il/PTelements.asp" 1

Examples/ImportHtml/StarTrek.ps1

@@ -1,3 +1,3 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 Import-Html "https://en.wikipedia.org/wiki/List_of_Star_Trek:_The_Original_Series_episodes" 2

Examples/Index - Music.ps1

@@ -1,5 +1,5 @@
 #requires -modules "Get-IndexedItem"
-[cmdletbinding()]
+[CmdletBinding()]
 Param()
 Remove-Item ~\documents\music.xlsx -ErrorAction SilentlyContinue
 [System.Diagnostics.Stopwatch]$stopwatch = [System.Diagnostics.Stopwatch]::StartNew()
@@ -22,7 +22,7 @@ $ws    = $excel.Music
 Set-ExcelRow    -Worksheet $ws -Row 1 -Value {($worksheet.cells[$row,$column].value -replace '^SYSTEM\.','') -replace '^MEDIA\.|^AUDIO\.|^MUSIC\.','' }
 Set-ExcelColumn -Worksheet $ws -Column 5 -NumberFormat 'mm:ss.0' -StartRow 2 -Value {$worksheet.cells[$row,$column].value / 864000000000 }
 Write-Verbose -Message ("Cells Reset: " + $stopwatch.Elapsed.TotalSeconds)
-Set-Column      -Worksheet $ws -Column 6 -NumberFormat '#.#,,"MB"'
+Set-ExcelColumn -Worksheet $ws -Column 6 -NumberFormat '#.#,,"MB"'
 Set-ExcelColumn -Worksheet $ws -Column 7 -NumberFormat '0.0,"KHz"'
 $ws.Cells[$ws.Dimension].AutoFitColumns()
 

Examples/JoinWorksheet/Join-worksheet-blocks.sample.ps1

@@ -2,7 +2,7 @@
 $path = "$env:TEMP\Test.xlsx"
 Remove-item -Path $path -ErrorAction SilentlyContinue
 #Export disk volume, and Network adapter to their own sheets.
-Get-WmiObject -Class win32_logicaldisk |
+Get-CimInstance -ClassName Win32_LogicalDisk   |
     Select-Object -Property DeviceId,VolumeName, Size,Freespace |
         Export-Excel -Path $path -WorkSheetname Volumes -NumberFormat "0,000"
 Get-NetAdapter  |

Examples/JoinWorksheet/JoinSalesData.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlfile = "$env:temp\AllSales.xlsx"
 

Examples/JustCharts/CentralLimitTheorem.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 ColumnChart -Title "Central Limit Theorem" -NoLegend ($(
         for ($i = 1; $i -le 500; $i++) {

Examples/JustCharts/PieChartHandles.ps1

@@ -2,7 +2,7 @@
 # Sum up handles by company
 # Show the Pie Chart
 
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 PieChart -Title "Total Handles by Company" `
     (Invoke-Sum (Get-Process | Where-Object company) company handles)

Examples/JustCharts/PieChartPM.ps1

@@ -2,7 +2,7 @@
 # Sum up PM by company
 # Show the Pie Chart
 
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 PieChart -Title "Total PM by Company" `
     (Invoke-Sum (Get-Process|Where-Object company) company pm)

Examples/JustCharts/TargetData.ps1

@@ -1,4 +1,4 @@
-$PropertyNames = echo Cost Date Name
+$PropertyNames = @("Cost", "Date", "Name")
 
 New-PSItem 1.1  1/1/2015 John $PropertyNames
 New-PSItem 2.1  1/2/2015 Tom

Examples/JustCharts/TryBarChart.ps1

@@ -1,3 +1,3 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 BarChart (.\TargetData.ps1) "A BarChart"

Examples/JustCharts/TryColumnChart.ps1

@@ -1,3 +1,3 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 ColumnChart (.\TargetData.ps1) "A ColumnChart"

Examples/JustCharts/TryPieChart.ps1

@@ -1,3 +1,3 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 PieChart (.\TargetData.ps1) "A PieChart"

Examples/MergeWorkSheet/MergeCSV.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlFile = "$env:TEMP\mw.xlsx"
 

Examples/MergeWorkSheet/Merge_2_Servers_Services.ps1

@@ -1,7 +1,7 @@
 Remove-Item -Path  "$env:temp\server*.xlsx" , "$env:temp\Combined*.xlsx" -ErrorAction SilentlyContinue
 
 #Get a subset of services into $s and export them
-[System.Collections.ArrayList]$s = get-service | Select-Object -first 25 -Property *
+[System.Collections.ArrayList]$s = Get-service | Select-Object -first 25 -Property *
 $s | Export-Excel -Path $env:temp\server1.xlsx
 
 #$s is a zero based array, excel rows are 1 based and excel has a header row so Excel rows will be 2 + index in $s.

Examples/MergeWorkSheet/Merge_3_Servers_Services.ps1

@@ -1,7 +1,7 @@
 Remove-Item -Path  "$env:temp\server*.xlsx" , "$env:temp\Combined*.xlsx" -ErrorAction SilentlyContinue
 
 #Get a subset of services into $s and export them
-[System.Collections.ArrayList]$s = get-service | Select-Object -first 25 -Property Name,DisplayName,StartType
+[System.Collections.ArrayList]$s = Get-service | Select-Object -first 25 -Property Name,DisplayName,StartType
 $s | Export-Excel -Path $env:temp\server1.xlsx
 
 #$s is a zero based array, excel rows are 1 based and excel has a header row so Excel rows will be 2 + index in $s.

Examples/MortgageCalculator/MortgageCalculator.ps1

@@ -9,6 +9,7 @@ param(
 )
 
 function New-CellData {
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification='Does not change system state')]
     param(
         $Range,
         $Value,
@@ -16,7 +17,7 @@ function New-CellData {
     )
 
     $setFormatParams = @{
-        WorkSheet    = $ws
+        Worksheet    = $ws
         Range        = $Range
         NumberFormat = $Format
     }
@@ -28,7 +29,7 @@ function New-CellData {
         $setFormatParams.Value = $Value
     }
 
-    Set-Format @setFormatParams
+    Set-ExcelRange @setFormatParams
 }
 
 $f = "$PSScriptRoot\mortgage.xlsx"
@@ -37,19 +38,19 @@ Remove-Item $f -ErrorAction SilentlyContinue
 $pkg = "" | Export-Excel $f -Title 'Fixed Rate Loan Payments' -PassThru -AutoSize
 $ws = $pkg.Workbook.Worksheets["Sheet1"]
 
-New-CellData A3 'Amount'
-New-CellData B3 $Amount '$#,##0'
+New-CellData -Range A3 -Value 'Amount'
+New-CellData -Range B3 -Value $Amount -Format '$#,##0'
 
-New-CellData A4 "Interest Rate"
-New-CellData B4 $InterestRate 'Percentage'
+New-CellData -Range A4 -Value "Interest Rate"
+New-CellData -Range B4 -Value $InterestRate -Format 'Percentage'
 
-New-CellData A5 "Term (Years)"
-New-CellData B5 $Term
+New-CellData -Range A5 -Value "Term (Years)"
+New-CellData -Range B5 -Value $Term
 
-New-CellData D3 "Monthly Payment"
-New-CellData F3 "=-PMT(F4, B5*12, B3)" '$#,##0.#0'
+New-CellData -Range D3 -Value "Monthly Payment"
+New-CellData -Range F3 -Value "=-PMT(F4, B5*12, B3)" -Format '$#,##0.#0'
 
-New-CellData D4 "Monthly Rate"
-New-CellData F4 "=((1+B4)^(1/12))-1" 'Percentage'
+New-CellData -Range D4 -Value "Monthly Rate"
+New-CellData -Range F4 -Value "=((1+B4)^(1/12))-1" -Format 'Percentage'
 
 Close-ExcelPackage $pkg -Show

Examples/MoveSheets/MoveSheets.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlfile = "$env:TEMP\testThis.xlsx"
 Remove-Item $xlfile -ErrorAction Ignore

Examples/Nasa/FireBalls.ps1

@@ -1,16 +1,17 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
-$header = echo `
-    'Date/Time - Peak Brightness (UT)' `
-    'Latitude (Deg)' `
-    'Longitude (Deg)' `
-    'Altitude (km)' `
-    'Velocity (km/s)' `
-    'Velocity Components (km/s) vx' `
-    'Velocity Components (km/s) vy' `
-    'Velocity Components (km/s) vz' `
-    'Total Radiated Energy (J)' `
+$header = @(
+    'Date/Time - Peak Brightness (UT)' ,
+    'Latitude (Deg)' ,
+    'Longitude (Deg)' ,
+    'Altitude (km)' ,
+    'Velocity (km/s)' ,
+    'Velocity Components (km/s) vx' ,
+    'Velocity Components (km/s) vy' ,
+    'Velocity Components (km/s) vz' ,
+    'Total Radiated Energy (J)' ,
     'Calculated Total Impact Energy (kt)'
+)
 
 $splat=@{
     url='http://neo.jpl.nasa.gov/fireballs/'

Examples/New-PSItem.ps1

@@ -1,5 +1,6 @@
 function New-PSItem {
-
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification='Does not change system state')]
+    param()
     $totalArgs = $args.Count
 
     if($args[-1] -is [array]) {

Examples/NumberFormat/ColorizeNumbers.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "$env:TEMP\disks.xlsx"
 

Examples/NumberFormat/CurrencyFormat.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "$env:temp\disks.xlsx"
 

Examples/NumberFormat/PercentagFormat.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "disks.xlsx"
 

Examples/NumberFormat/PosNegNumbers.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "disks.xlsx"
 

Examples/NumberFormat/Win32LogicalDisk.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "disks.xlsx"
 

Examples/NumberFormat/Win32LogicalDiskFormatted.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "disks.xlsx"
 

Examples/OutTabulator/start-demo.ps1

@@ -3,10 +3,10 @@
 ## This is an overhaul of Jeffrey Snover's original Start-Demo script by Joel "Jaykul" Bennett
 ##
 ## I've switched it to using ReadKey instead of ReadLine (you don't have to hit Enter each time)
-## As a result, I've changed the names and keys for a lot of the operations, so that they make 
+## As a result, I've changed the names and keys for a lot of the operations, so that they make
 ## sense with only a single letter to tell them apart (sorry if you had them memorized).
 ##
-## I've also been adding features as I come across needs for them, and you'll contribute your 
+## I've also been adding features as I come across needs for them, and you'll contribute your
 ## improvements back to the PowerShell Script repository as well.
 ##################################################################################################
 ## Revision History (version 3.3)
@@ -32,12 +32,14 @@
 ##                 so you have a chance to "go back" after the last line of you demo
 ##################################################################################################
 ##
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingWriteHost', '', Justification='Correct and desirable usage')]
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingInvokeExpression', '', Justification='Correct and desirable usage')]
 param(
-  $file=".\demo.txt", 
-  [int]$command=0, 
-  [System.ConsoleColor]$promptColor="Yellow", 
-  [System.ConsoleColor]$commandColor="White", 
-  [System.ConsoleColor]$commentColor="Green", 
+  $file=".\demo.txt",
+  [int]$command=0,
+  [System.ConsoleColor]$promptColor="Yellow",
+  [System.ConsoleColor]$commandColor="White",
+  [System.ConsoleColor]$commentColor="Green",
   [switch]$FullAuto,
   [int]$AutoSpeed = 3,
   [switch]$NoPauseAfterExecute
@@ -46,7 +48,7 @@ param(
 $RawUI = $Host.UI.RawUI
 $hostWidth = $RawUI.BufferSize.Width
 
-# A function for reading in a character 
+# A function for reading in a character
 function Read-Char() {
   $_OldColor = $RawUI.ForeGroundColor
   $RawUI.ForeGroundColor = "Red"
@@ -93,20 +95,20 @@ Write-Host -nonew -back black -fore $promptColor "for help.$(' ' * ($hostWidth -
 Write-Host -nonew -back black -fore $promptColor $(" " * $hostWidth)
 
 # We use a FOR and an INDEX ($_i) instead of a FOREACH because
-# it is possible to start at a different location and/or jump 
+# it is possible to start at a different location and/or jump
 # around in the order.
 for ($_i = $Command; $_i -lt $_lines.count; $_i++)
-{  
+{
 	# Put the current command in the Window Title along with the demo duration
 	$Dur = [DateTime]::Now - $_StartTime
-   $RawUI.WindowTitle = "$(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s   {3}" -f 
+   $RawUI.WindowTitle = "$(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s   {3}" -f
                         $dur.Hours, $dur.Minutes, $dur.Seconds, $($_Lines[$_i])
 
 	# Echo out the commmand to the console with a prompt as though it were real
 	Write-Host -nonew -fore $promptColor "[$_i]$([char]0x2265) "
-	if ($_lines[$_i].Trim(" ").StartsWith("#") -or $_lines[$_i].Trim(" ").Length -le 0) { 
+	if ($_lines[$_i].Trim(" ").StartsWith("#") -or $_lines[$_i].Trim(" ").Length -le 0) {
 		Write-Host -fore $commentColor "$($_Lines[$_i])  "
-		continue 
+		continue
 	} else {
 		Write-Host -nonew -fore $commandColor "$($_Lines[$_i])  "
 	}
@@ -119,7 +121,7 @@ for ($_i = $Command; $_i -lt $_lines.count; $_i++)
 
 Running demo: $file
 (n) Next       (p) Previous
-(q) Quit       (s) Suspend 
+(q) Quit       (s) Suspend
 (t) Timecheck  (v) View $(split-path $file -leaf)
 (g) Go to line by number
 (f) Find lines by string
@@ -148,15 +150,15 @@ Running demo: $file
 			break;
 		}
 		"v" { # View Source
-			$lines[0..($_i-1)] | Write-Host -Fore Yellow 
+			$lines[0..($_i-1)] | Write-Host -Fore Yellow
 			$lines[$_i]        | Write-Host -Fore Green
-			$lines[($_i+1)..$lines.Count] | Write-Host -Fore Yellow 
+			$lines[($_i+1)..$lines.Count] | Write-Host -Fore Yellow
 			$_i-- # back a line, we're gonna step forward when we loop
 		}
 		"t" { # Time Check
 			 $dur = [DateTime]::Now - $_StartTime
        Write-Host -Fore $promptColor $(
-          "{3} -- $(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s" -f 
+          "{3} -- $(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s" -f
           $dur.Hours, $dur.Minutes, $dur.Seconds, ([DateTime]::Now.ToShortTimeString()))
 			 $_i-- # back a line, we're gonna step forward when we loop
 		}
@@ -170,7 +172,7 @@ Running demo: $file
 			if($i -le $_lines.Count) {
 				if($i -gt 0) {
                # extra line back because we're gonna step forward when we loop
-               $_i = Rewind $_lines $_i (($_i-$i)+1)
+               $_i = Rewind -lines $_lines -index $_i -steps (($_i-$i)+1)
 				} else {
 					$_i = -1 # Start negative, because we step forward when we loop
 				}
@@ -178,18 +180,18 @@ Running demo: $file
 		}
 		"f" { # Find by pattern
 			$match = $_lines | Select-String (Read-Host "search string")
-			if($match -eq $null) {
+			if($null -eq $match) {
 				Write-Host -Fore Red "Can't find a matching line"
 			} else {
-				$match | % { Write-Host -Fore $promptColor $("[{0,2}] {1}" -f ($_.LineNumber - 1), $_.Line) }
+				$match | ForEach-Object { Write-Host -Fore $promptColor $("[{0,2}] {1}" -f ($_.LineNumber - 1), $_.Line) }
 				if($match.Count -lt 1) {
 					$_i = $match.lineNumber - 2  # back a line, we're gonna step forward when we loop
-				} else {               
+				} else {
 					$_i-- # back a line, we're gonna step forward when we loop
 				}
 			}
 		}
-      "c" { 
+      "c" {
          Clear-Host
          $_i-- # back a line, we're gonna step forward when we loop
       }
@@ -197,7 +199,7 @@ Running demo: $file
 			Write-Host
 			trap [System.Exception] {Write-Error $_; continue;}
 			Invoke-Expression ($_lines[$_i]) | out-default
-			if(-not $NoPauseAfterExecute -and -not $FullAuto) { 
+			if(-not $NoPauseAfterExecute -and -not $FullAuto) {
 				$null = $RawUI.ReadKey("NoEcho,IncludeKeyUp")  # Pause after output for no apparent reason... ;)
 			}
 		}
@@ -210,7 +212,7 @@ Running demo: $file
 }
 $dur = [DateTime]::Now - $_StartTime
 Write-Host -Fore $promptColor $(
-   "<Demo Complete -- $(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s>" -f 
+   "<Demo Complete -- $(if($dur.Hours -gt 0){'{0}h '})$(if($dur.Minutes -gt 0){'{1}m '}){2}s>" -f
    $dur.Hours, $dur.Minutes, $dur.Seconds, [DateTime]::Now.ToLongTimeString())
 Write-Host -Fore $promptColor $([DateTime]::now)
 Write-Host

Examples/PassThru/TryPassThru.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $file = "$env:Temp\sales.xlsx"
 

Examples/Pester-To-XLSx.ps1

@@ -0,0 +1,147 @@
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSPossibleIncorrectComparisonWithNull', '', Justification = 'Intentional use to select non null array items')]
+[CmdletBinding(DefaultParameterSetName = 'Default')]
+param(
+  [Parameter(Position = 0)]
+  [string]$XLFile,
+
+  [Parameter(ParameterSetName = 'Default', Position = 1)]
+  [Alias('Path', 'relative_path')]
+  [object[]]$Script = '.',
+
+  [Parameter(ParameterSetName = 'Existing', Mandatory = $true)]
+  [switch]
+  $UseExisting,
+
+  [Parameter(ParameterSetName = 'Default', Position = 2)]
+  [Parameter(ParameterSetName = 'Existing', Position = 2, Mandatory = $true)]
+  [string]$OutputFile,
+
+  [Parameter(ParameterSetName = 'Default')]
+  [Alias("Name")]
+  [string[]]$TestName,
+
+  [Parameter(ParameterSetName = 'Default')]
+  [switch]$EnableExit,
+
+  [Parameter(ParameterSetName = 'Default')]
+  [Alias('Tags')]
+  [string[]]$Tag,
+  [string[]]$ExcludeTag,
+
+  [Parameter(ParameterSetName = 'Default')]
+  [switch]$Strict,
+
+  [string]$WorkSheetName = 'PesterResults',
+  [switch]$append,
+  [switch]$Show
+)
+
+$InvokePesterParams = @{OutputFormat = 'NUnitXml' } + $PSBoundParameters
+if (-not $InvokePesterParams['OutputFile']) {
+  $InvokePesterParams['OutputFile'] = Join-Path -ChildPath 'Pester.xml'-Path ([environment]::GetFolderPath([System.Environment+SpecialFolder]::MyDocuments))
+}
+if ($InvokePesterParams['Show']  ) { }
+if ($InvokePesterParams['XLFile']) { $InvokePesterParams.Remove('XLFile') }
+else { $XLFile = $InvokePesterParams['OutputFile'] -replace '.xml$', '.xlsx' }
+if (-not $UseExisting) {
+  $InvokePesterParams.Remove('Append')
+  $InvokePesterParams.Remove('UseExisting')
+  $InvokePesterParams.Remove('Show')
+  $InvokePesterParams.Remove('WorkSheetName')
+  Invoke-Pester @InvokePesterParams
+}
+
+if (-not (Test-Path -Path $InvokePesterParams['OutputFile'])) {
+  throw "Could not output file $($InvokePesterParams['OutputFile'])"; return
+}
+
+$resultXML = ([xml](Get-Content $InvokePesterParams['OutputFile'])).'test-results'
+$startDate = [datetime]$resultXML.date
+$startTime = $resultXML.time
+$machine = $resultXML.environment.'machine-name'
+#$user       = $resultXML.environment.'user-domain' + '\' + $resultXML.environment.user
+$os = $resultXML.environment.platform -replace '\|.*$', " $($resultXML.environment.'os-version')"
+<#hierarchy goes
+    root, [date], start [time], [Name] (always "Pester"), test results broken down as [total],[errors],[failures],[not-run] etc.
+      Environment (user & machine info)
+      Culture-Info (current, and currentUi culture)
+      Test-Suite [name] = "Pester" [result], [time] to execute, etc.
+        Results
+          Test-Suite [name] = filename,[result], [Time] to Execute etc
+            Results
+               Test-Suite [Name] = Describe block Name, [result], [Time] to execute etc..
+                 Results
+                   Test-Suite [Name] = Context block name [result], [Time] to execute etc.
+                      Results
+                        Test-Case [name] = Describe.Context.It block names [description]= it block name, result], [Time] to execute etc
+                      or if the tests are parameterized
+                        Test suite [description] - name in the the it block with <vars> not filled in
+                          Results
+                             Test-case  [description] - name as rendered for display with <vars> filled in
+#>
+$testResults = foreach ($test in $resultXML.'test-suite'.results.'test-suite') {
+  $testPs1File = $test.name
+  #Test if there are context blocks in the hierarchy OR if we go straight from Describe to test-case
+  if ($test.results.'test-suite'.results.'test-suite' -ne $null) {
+    foreach ($suite in $test.results.'test-suite') {
+      $Describe = $suite.description
+      foreach ($subsuite in $suite.results.'test-suite') {
+        $Context = $subsuite.description
+        if ($subsuite.results.'test-suite'.results.'test-case') {
+          $testCases = $subsuite.results.'test-suite'.results.'test-case'
+        }
+        else { $testCases = $subsuite.results.'test-case' }
+        $testCases | ForEach-Object {
+          New-Object -TypeName psobject -Property ([ordered]@{
+              Machine = $machine    ; OS = $os
+              Date = $startDate  ; Time = $startTime
+              Executed = $(if ($_.executed -eq 'True') { 1 })
+              Success = $(if ($_.success -eq 'True') { 1 })
+              Duration = $_.time
+              File = $testPs1File; Group = $Describe
+              SubGroup = $Context    ; Name = ($_.Description -replace '\s{2,}', ' ')
+              Result = $_.result   ; FullDesc = '=Group&" "&SubGroup&" "&Name'
+            })
+        }
+      }
+    }
+  }
+  else {
+    $test.results.'test-suite' | ForEach-Object {
+      $Describe = $_.description
+      $_.results.'test-case' | ForEach-Object {
+        New-Object -TypeName psobject -Property ([ordered]@{
+            Machine = $machine    ; OS = $os
+            Date = $startDate  ; Time = $startTime
+            Executed = $(if ($_.executed -eq 'True') { 1 })
+            Success = $(if ($_.success -eq 'True') { 1 })
+            Duration = $_.time
+            File = $testPs1File; Group = $Describe
+            SubGroup = $null       ; Name = ($_.Description -replace '\s{2,}', ' ')
+            Result = $_.result   ; FullDesc = '=Group&" "&Test'
+          })
+      }
+    }
+  }
+}
+if (-not $testResults) { Write-Warning 'No Results found' ; return }
+$clearSheet = -not $Append
+$excel = $testResults | Export-Excel  -Path $xlFile -WorkSheetname $WorkSheetName -ClearSheet:$clearSheet -Append:$append -PassThru  -BoldTopRow -FreezeTopRow -AutoSize -AutoFilter -AutoNameRange
+$ws = $excel.Workbook.Worksheets[$WorkSheetName]
+<#  Worksheet should look like ..
+  |A        |B             |C      D      |E        |F       |G          |H       |I        |J        |K    |L       |M
+ 1|Machine  |OS            |Date   Time   |Executed |Success |Duration   |File    |Group    |SubGroup |Name |Result  |FullDescription
+ 2|Flatfish |Name_Version  |[run started] |Boolean  |Boolean |In seconds |xx.ps1  |Describe |Context  |It   |Success |Desc_Context_It
+#>
+
+#Display Date as a date, not a date time
+Set-Column -Worksheet $ws -Column 3 -NumberFormat 'Short Date' # -AutoSize
+
+#Hide columns E to J (Executed, Success, Duration, File, Group and Subgroup)
+(5..10) | ForEach-Object { Set-ExcelColumn -Worksheet $ws -Column $_ -Hide }
+
+#Use conditional formatting to make Failures red, and Successes green (skipped remains black ) ... and save
+$endRow = $ws.Dimension.End.Row
+Add-ConditionalFormatting -WorkSheet $ws -range "L2:L$endrow" -RuleType ContainsText -ConditionValue "Failure" -BackgroundPattern None -ForegroundColor Red   -Bold
+Add-ConditionalFormatting -WorkSheet $ws -range "L2:L$endRow" -RuleType ContainsText -ConditionValue "Success" -BackgroundPattern None -ForeGroundColor Green
+Close-ExcelPackage -ExcelPackage $excel  -Show:$show

Examples/PivotTable/MultiplePivotTables.ps1

@@ -20,11 +20,11 @@ $pivotTableParams = @{
     PivotTableName  = "ByRegion"
     Address         = $excel.Sheet1.cells["F1"]
     SourceWorkSheet = $excel.Sheet1
-    PivotRows       = echo Region Fruit Date
+    PivotRows       = @("Region", "Fruit", "Date")
     PivotData       = @{'sold' = 'sum'}
     PivotTableStyle = 'Light21'
     GroupDateRow    = "Date"
-    GroupDatePart   = echo Years Quarters
+    GroupDatePart   = @("Years", "Quarters")
 }
 
 $pt = Add-PivotTable @pivotTableParams -PassThru
@@ -33,21 +33,21 @@ $pt.RowHeaderCaption = "By " + ($pivotTableParams.PivotRows -join ",")
 
 $pivotTableParams.PivotTableName = "ByFruit"
 $pivotTableParams.Address = $excel.Sheet1.cells["J1"]
-$pivotTableParams.PivotRows = echo Fruit Region Date
+$pivotTableParams.PivotRows = @("Fruit", "Region", "Date")
 
 $pt = Add-PivotTable @pivotTableParams -PassThru
 $pt.RowHeaderCaption = "By Fruit,Region"
 
 $pivotTableParams.PivotTableName = "ByDate"
 $pivotTableParams.Address = $excel.Sheet1.cells["N1"]
-$pivotTableParams.PivotRows = echo Date Region Fruit
+$pivotTableParams.PivotRows = @("Date", "Region", "Fruit")
 
 $pt = Add-PivotTable @pivotTableParams -PassThru
 $pt.RowHeaderCaption = "By Date,Region,Fruit"
 
 $pivotTableParams.PivotTableName = "ByYears"
 $pivotTableParams.Address = $excel.Sheet1.cells["S1"]
-$pivotTableParams.GroupDatePart = echo Years
+$pivotTableParams.GroupDatePart = "Years"
 
 $pt = Add-PivotTable @pivotTableParams -PassThru
 $pt.RowHeaderCaption = "By Years,Region"

Examples/PivotTable/PivotTableWithName.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $ExcelParams = @{
     Path              = "$env:TEMP\test1.xlsx"

Examples/PivotTableFilters/testPivotFilter.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $xlFile="$env:TEMP\testPivot.xlsx"
 Remove-Item $xlFile -ErrorAction Ignore

Examples/Plot/PlotCos.ps1

@@ -1,4 +1,4 @@
-try {. $PSScriptRoot\..\..\LoadPSD1.ps1} catch {}
+try {Import-Module $PSScriptRoot\..\..\ImportExcel.psd1} catch {throw ; return}
 
 $plt = New-Plot
 $plt.Plot((Get-Range 0 5 .02|Foreach-Object {[math]::Cos(2*[math]::pi*$_)}))

Examples/PsGallery.ps1

@@ -0,0 +1,21 @@
+
+$top1000 = foreach ($p in 1..50) {
+    $c =  Invoke-WebRequest -Uri "https://www.powershellgallery.com/packages" -method Post  -Body "q=&sortOrder=package-download-count&page=$p"
+    [regex]::Matches($c.Content,'<table class="width-hundred-percent">.*?</table>', [System.Text.RegularExpressions.RegexOptions]::Singleline) | foreach {
+        $name = [regex]::Match($_, "(?<=<h1><a href=.*?>).*(?=</a></h1>)").value
+        $n =    [regex]::replace($_,'^.*By:\s*<li role="menuitem">','', [System.Text.RegularExpressions.RegexOptions]::Singleline)
+        $n =    [regex]::replace($n,'</div>.*$','', [System.Text.RegularExpressions.RegexOptions]::Singleline)
+        $by =   [regex]::match($n,'(?<=">).*(?=</a>)').value
+        $qty =  [regex]::match($n,'\S*(?= downloads)').value
+        [PSCustomObject]@{
+            Name = $name
+            by   = $by
+            Downloads = $qty
+        }
+    }
+}
+
+del "~\Documents\gallery.xlsx"
+$pivotdef = New-PivotTableDefinition -PivotTableName 'Summary' -PivotRows by -PivotData @{name="Count"
+                                     Downloads="Sum"} -PivotDataToColumn -Activate -ChartType ColumnClustered -PivotNumberFormat '#,###'
+$top1000 | export-excel -path '~\Documents\gallery.xlsx' -Numberformat '#,###' -PivotTableDefinition $pivotdef -TableName 'TopDownloads' -Show

Examples/ReadAllSheets/Get-ExcelSheets.ps1

@@ -10,10 +10,10 @@ $hash = @{ }
 
 $e = Open-ExcelPackage $path
 
-foreach ($sheet in $e.workbook.worksheets) { 
-    $hash[$sheet.name] = Import-Excel -ExcelPackage $e -WorksheetName $sheet.name 
-} 
+foreach ($sheet in $e.workbook.worksheets) {
+    $hash[$sheet.name] = Import-Excel -ExcelPackage $e -WorksheetName $sheet.name
+}
 
-Close-ExcelPackage $e -NoSave 
+Close-ExcelPackage $e -NoSave
 
 $hash

Examples/ReadAllSheets/ReadAllSheets.ps1

@@ -1,4 +1,4 @@
 $xlfile = "$env:TEMP\MultipleSheets.xlsx"
 
-.\GenerateXlsx.ps1 $xlfile 
-.\Get-ExcelSheets.ps1 $xlfile 
+.\GenerateXlsx.ps1 $xlfile
+.\Get-ExcelSheets.ps1 $xlfile