Private/AzStackHci.ModuleManagement.Helpers.ps1

# ////////////////////////////////////////////////////////////////////////////
# Strict Mode v1 (PS 5.1 safe) - surfaces reads of uninitialised variables at runtime.
Set-StrictMode -Version 1.0

# Function to check if a command exists

# Timeout (seconds) for PSGallery version checks — prevents hangs when gallery is unreachable
$script:FindModuleTimeoutSeconds = 15

Function Test-CommandExists
{
    Param ($command)

    begin {
        # Write-Debug "Test-CommandExists: Beginning command existence check for '$command'"
        $oldPreference = $ErrorActionPreference
        $ErrorActionPreference = "Stop"
        [bool]$CommandExists = $false
    }

    process {
        try {
            if(Get-Command $command){
                $CommandExists = $true
            }
        } Catch {
            $CommandExists = $false
        } Finally {
            $ErrorActionPreference=$oldPreference
        }

    } # End of process block

    end {
        # Write-Debug "Test-CommandExists: Command existence check completed"

        # Return the result
        return $CommandExists

    }

} # End function Test-CommandExists


# ////////////////////////////////////////////////////////////////////////////
Function Get-AzStackHciEnvironmentCheckerModule {

    begin {
        # Write-Debug "Get-AzStackHciEnvironmentCheckerModule: Beginning Environment Checker module verification"
        # Check if the AzStackHci.EnvironmentChecker module is installed and running the latest version
        $Module = "AzStackHci.EnvironmentChecker"
    }

    process {

        # Check if the module is installed.
        # Force array cast so indexing and .Count behave consistently with 1 or many versions.
        # Sort descending so [0] is always the newest version.
        [Array]$InstalledVersions = @(Get-Module -Name $Module -ListAvailable -ErrorAction SilentlyContinue | Sort-Object -Property Version -Descending)

        # If only one version is installed, set the installed version
        if($InstalledVersions){
            if($InstalledVersions.Count -eq 1) {
                [version]$InstalledVersion = $InstalledVersions[0].Version
            } elseif($InstalledVersions.Count -gt 1) {
                # Multiple versions installed, use the latest version (sorted descending above)
                [version]$InstalledVersion = $InstalledVersions[0].Version
                Write-Warning "There are $($InstalledVersions.Count) versions of 'AzStackHci.EnvironmentChecker' module installed"
            }
            Write-HostAzS "'AzStackHci.EnvironmentChecker' module version $($InstalledVersion.ToString()) is installed" -ForegroundColor "Green"
            # Do nothing, continue with the script

        } elseif(-not($InstalledVersions)){
            # Module not found, ask user to install the module
            Write-HostAzS "Azure Stack HCI Environment Checker module is not installed" -ForegroundColor Red
            if ($script:SilentMode) {
                $InstallModulePrompt = "Y"
            } else {
                $InstallModulePrompt = Read-Host "Would you like to install the dependant module '$Module' now? (Y/N)"
            }
            if(([string]::IsNullOrWhiteSpace($InstallModulePrompt)) -or ($InstallModulePrompt -ne "Y")){
                Throw "Error: Null or not 'Y' response. Exiting script, please install the '$Module' module and re-run the function"

            } elseif($InstallModulePrompt -eq "Y"){
                Write-HostAzS "Installing module '$Module'...." -ForegroundColor "Green"
                try {
                    # Requires -AllowClobber as some functions are included in Az.StackHCI
                    Install-Module -Name $Module -Repository PSGallery -Force -ErrorVariable ModuleInstallError -AllowClobber -Scope AllUsers -Confirm:$false
                } catch {
                    Throw "Error installing module '$Module' - $($_.Exception.Message)"
                }
                if(-not($ModuleInstallError)){
                    Write-HostAzS "Module '$Module' installed successfully" -ForegroundColor "Green"
                } else {
                    Throw "Error installing module '$Module' - $ModuleInstallError"
                }
            } else {
                # All other responses
                Write-HostAzS "Invalid response, please enter 'Y' to install the module..." -ForegroundColor Red
                Throw "Exiting script, please install the '$Module' module and re-run the function"
            }
        }

        # Use -Global so EnvironmentChecker's exported functions land in the global session
        # state instead of being injected into our own module's scope. Without -Global, any
        # exported function from EnvironmentChecker that shares a name with one of OUR private
        # helpers (e.g. Get-SslCertificateChain in EnvironmentChecker 10.2509+) would shadow
        # the private helper at the call site inside our module, with confusing parameter
        # mismatch errors. (See also: rename of our internal helper to Get-AzSHciSslCertificateChain.)
        Import-Module -Name $Module -Force -Global
        # Load URLs from environment checker (Targets.json), check if multiple module version are installed, if so, use the latest version
        $Location = ((Get-Module -Name $Module -ListAvailable) | Sort-Object -Property Version -Descending | Select-Object -First 1).ModuleBase
        if(-not($Location)){
            Write-HostAzS "Azure Stack HCI Environment Checker module not found, please install the module" -ForegroundColor Red
            Write-HostAzS "Run: 'Install-Module -Name AzStackHci.EnvironmentChecker' and troubleshoot any installation issues" -ForegroundColor Green
            Exit
        }

    } # End of process block

    end {
        # Write-Debug "Get-AzStackHciEnvironmentCheckerModule: Environment Checker module verification completed"
        
        # Return the module location
        Return $Location

    }

} # End Function Get-AzStackHciEnvironmentCheckerModule


# ////////////////////////////////////////////////////////////////////////////
# Function to get the latest version of a module from PSGallery
# This function will check for the latest version of a module in the PowerShell Gallery
Function Get-LatestModuleVersion {

    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true, Position=0)]
        [ValidateNotNullOrEmpty()]
        [string]$ModuleName,

        # Optional out-parameter. When supplied, receives the ACTUAL latest version published
        # (listed) in PSGallery — which may be LOWER than the installed version for a
        # pre-release/dev build. Unlike the return value (clamped to never go below the
        # installed version), this is the true gallery state, so a caller can detect
        # "installed is newer than published". $null when PSGallery is unreachable.
        [Parameter(Mandatory=$false)]
        [ref]$ListedGalleryVersion,

        # Optional out-parameter. When supplied, receives $true if PSGallery was reachable and
        # the listed-version lookup completed, $false on timeout / network error.
        [Parameter(Mandatory=$false)]
        [ref]$GalleryReachable
    )

    begin {
        # Write-Debug "Get-LatestModuleVersion: Beginning latest module version check for '$ModuleName'"
        # ////////////////////////////////////////////
        # ///// Check for latest module version //////
        # ////////////////////////////////////////////
        [bool]$ModuleNotInstalled = $false
        # Initialise here so the end block's `if($LatestModuleVersion)` reference is always
        # valid. The process block only ASSIGNS this when the gallery has a NEWER version;
        # when the installed version is already latest, the assignment branch never runs and
        # an uninitialised reference would throw under Set-StrictMode -Version 1.0.
        [version]$LatestModuleVersion = $null
    }

    process {
        [version]$ExistingModuleVersion = Get-LoadedModuleVersion -Name $ModuleName
        if (-not $ExistingModuleVersion) {
            $ExistingModuleVersion = (Get-InstalledModule -Name $ModuleName -ErrorAction SilentlyContinue | Sort-Object Version -Descending | Select-Object -First 1).Version
        }

        if(-not $ExistingModuleVersion) {
            # Get-InstalledModule only finds modules registered by PowerShellGet (Install-Module).
            # A side-loaded / locally-packaged build — copied straight into
            # \Modules\<Name>\<Version>\ (e.g. Package-Module-Locally.ps1, offline sideload) — is
            # invisible to it. Fall back to Get-Module -ListAvailable so the gallery comparison
            # still runs. This is exactly the dev/test build scenario where "installed is newer
            # than published" is most likely to be true, so without this fallback the
            # newer-than-PSGallery notice could never fire.
            [version]$ExistingModuleVersion = (Get-Module -Name $ModuleName -ListAvailable | Sort-Object -Property Version -Descending | Select-Object -First 1).Version
        }

        if(-not $ExistingModuleVersion) {
            Write-Debug "Module '$ModuleName' is not installed (neither registered via PSGallery nor present on disk). Skipping update check."
            $ModuleNotInstalled = $true
            return
        }

        # ////////////////////////////////////////////////////////////////////////////
        # Version discovery strategy:
        #
        # Step 1 (Fast path): Use Find-Module without -RequiredVersion to check for
        # the latest *listed* version in PSGallery. This is a single network call
        # and works for any module that is publicly listed. If it returns a version
        # higher than the installed version, use it immediately.
        #
        # Step 2 (Fallback for unlisted modules): If Step 1 does not find a newer
        # version, fall back to probing exact version numbers with -RequiredVersion.
        # This is required because Find-Module without -RequiredVersion does NOT
        # return unlisted packages. The only way to discover unlisted versions is
        # by probing exact version numbers.
        # Originally written for a module where all versions were "Unlisted" in
        # the PowerShell Gallery, this fallback has been retained for portability.
        #
        # Fallback version increment strategy:
        # 1. First, increment the Build (z) digit: x.y.z -> x.y.(z+1)
        # 2. If incrementing build finds no match, try rolling over to the next
        # Minor version: x.y.z -> x.(y+1).0
        # 3. If that also finds no match, try rolling over to the next Major
        # version: x.y.z -> (x+1).0.0
        # 4. Only stop if all three probes miss, meaning no further version exists.
        # ////////////////////////////////////////////////////////////////////////////

        # --- Step 1: Fast path — single call for latest listed version ---
        # Note: Find-Module can return multiple results when multiple repositories
        # are registered (e.g. PSGallery + a local repo). Sort descending and pick
        # the highest version across all repositories.
        # Uses Start-Job/Wait-Job with timeout to prevent hangs if PSGallery is unreachable.
        Write-Debug "Checking PowerShell Gallery for latest listed version of '$ModuleName' (timeout: $($script:FindModuleTimeoutSeconds)s)..."
        [version]$ListedVersion = $null
        # NOTE: this local MUST NOT be named $galleryReachable — that would case-insensitively
        # alias the [ref]$GalleryReachable parameter and clobber the PSReference with a [bool],
        # making $GalleryReachable.Value below throw "property 'Value' cannot be found".
        [bool]$galleryProbeSucceeded = $false
        $job = $null
        try {
            $job = Start-Job -ScriptBlock { param($Name) (Find-Module -Name $Name -ErrorAction SilentlyContinue | Sort-Object -Property Version -Descending | Select-Object -First 1).Version } -ArgumentList $ModuleName
            $completed = Wait-Job -Job $job -Timeout $script:FindModuleTimeoutSeconds -ErrorAction SilentlyContinue
            if ($completed -and $completed.State -eq 'Completed') {
                $ListedVersion = Receive-Job -Job $job -ErrorAction SilentlyContinue
                $galleryProbeSucceeded = $true
            } else {
                Write-Debug "Version check timed out after $($script:FindModuleTimeoutSeconds) seconds — attempting to stop background job"
                if ($job) { Stop-Job -Job $job -ErrorAction SilentlyContinue }
            }
        } catch {
            Write-Debug "Version check failed: $($_.Exception.Message)"
        } finally {
            if ($job) {
                Remove-Job -Job $job -Force -ErrorAction SilentlyContinue
                # Verify job is actually gone — orphaned jobs can leak resources.
                $lingering = Get-Job -Id $job.Id -ErrorAction SilentlyContinue
                if ($lingering) {
                    Write-Warning "Find-Module background job (Id $($job.Id)) did not terminate cleanly and is still present."
                }
            }
        }

        # Surface the raw listed gallery version and reachability to the caller (if requested).
        # $ListedVersion is the ACTUAL latest version published in PSGallery — it may be LOWER
        # than the installed version for a pre-release/dev build. It is deliberately NOT clamped
        # here (the return value below is clamped to never drop below installed); these out-refs
        # expose the true gallery state so callers can detect "installed is newer than published".
        if ($PSBoundParameters.ContainsKey('ListedGalleryVersion')) { $ListedGalleryVersion.Value = $ListedVersion }
        if ($PSBoundParameters.ContainsKey('GalleryReachable'))     { $GalleryReachable.Value     = $galleryProbeSucceeded }

        if($ListedVersion -and $ListedVersion -gt $ExistingModuleVersion) {
            # Latest listed version is newer than installed — use it directly
            Write-Debug "Latest listed version v$($ListedVersion.ToString()) is newer than installed v$($ExistingModuleVersion.ToString())"
            [version]$LatestModuleVersion = $ListedVersion
        } elseif (-not $galleryProbeSucceeded) {
            # PSGallery was unreachable (timeout or error) — skip probing, continue with installed version
            Write-Debug "PSGallery unreachable; skipping unlisted version probing. Continuing with installed v$($ExistingModuleVersion.ToString())"
        } else {
            # --- Step 2: Disabled — unlisted version probing commented out ---
            # The module is now publicly listed on PSGallery, so probing for unlisted
            # versions by incrementing build/minor/major is no longer needed.
            # If Step 1 found no newer listed version, the installed version is current.
            if($ListedVersion) {
                Write-Debug "Listed version v$($ListedVersion.ToString()) is not newer than installed v$($ExistingModuleVersion.ToString()). No update needed."
            } else {
                Write-Debug "No listed version found in PSGallery. Continuing with installed v$($ExistingModuleVersion.ToString())."
            }

            <# --- Original Step 2: Fallback — incremental probing for unlisted versions ---
                Originally written for a module where all versions were "Unlisted" in PSGallery.
                Disabled because the module is now publicly listed and this probing adds unnecessary
                Find-Module -RequiredVersion calls that slow down the update check.
 
            [bool]$StopModuleVersion = $false
            [version]$ModuleVersion = $ExistingModuleVersion
 
            # Loop and check if a new unlisted version exists:
            Do {
                [int]$Major = $ModuleVersion.Major
                [int]$Minor = $ModuleVersion.Minor
                [int]$Build = $ModuleVersion.Build
 
                # --- Attempt 1: Increment Build (z) by 1 ---
                [version]$NewModuleVersion = "$Major.$Minor.$($Build + 1)"
                Write-Debug "Checking if module v$($NewModuleVersion) exists in PowerShell Gallery..."
                [version]$FoundVersion = (Find-Module -Name "$ModuleName" -RequiredVersion $NewModuleVersion -ErrorAction SilentlyContinue).Version
 
                if(-not $FoundVersion) {
                    # --- Attempt 2: Roll over to next Minor version (x.(y+1).0) ---
                    [version]$NewModuleVersion = "$Major.$($Minor + 1).0"
                    Write-Debug "Build increment miss. Checking minor rollover v$($NewModuleVersion)..."
                    [version]$FoundVersion = (Find-Module -Name "$ModuleName" -RequiredVersion $NewModuleVersion -ErrorAction SilentlyContinue).Version
                }
 
                if(-not $FoundVersion) {
                    # --- Attempt 3: Roll over to next Major version ((x+1).0.0) ---
                    [version]$NewModuleVersion = "$($Major + 1).0.0"
                    Write-Debug "Minor rollover miss. Checking major rollover v$($NewModuleVersion)..."
                    [version]$FoundVersion = (Find-Module -Name "$ModuleName" -RequiredVersion $NewModuleVersion -ErrorAction SilentlyContinue).Version
                }
 
                if($FoundVersion) {
                    Write-Debug "Higher module version found v$($FoundVersion.ToString())"
                    [version]$LatestModuleVersion = $FoundVersion
                    # Continue searching from the found version
                    [version]$ModuleVersion = $FoundVersion
                } else {
                    # All three probes missed — no further version exists in PSGallery
                    Write-Debug "No match for v$($Major).$($Minor).$($Build + 1), v$($Major).$($Minor + 1).0, or v$($Major + 1).0.0"
                    $StopModuleVersion = $true
                }
 
            } While (-not($StopModuleVersion))
            #>

        }

    } # End of process block

    end {
        # Write-Debug "Get-LatestModuleVersion: Latest module version check completed"

        # If module was not installed via PSGallery, return null (no version to report)
        if($ModuleNotInstalled) {
            return $null
        }
        
        # Return Function output
        if($LatestModuleVersion) {
            Return [version]$LatestModuleVersion
        } else {
            Return [version]$ExistingModuleVersion
        }

    }

} # End Function Get-LatestModuleVersion


# ////////////////////////////////////////////////////////////////////////////
# Auto Update Module Function
Function Update-ModuleVersion {
<#
    .SYNOPSIS
        Checks PSGallery for a newer version of a module. Notifies by default; installs only on opt-in.
 
    .DESCRIPTION
        By default this function is NON-DESTRUCTIVE: it checks PSGallery for a newer version and, if
        found, prints a notification telling the user how to update manually. It does NOT install,
        uninstall or modify anything on the machine.
 
        When -InstallUpdate is specified, the function installs the newer version side-by-side via
        Install-Module and imports it. Older versions are left in place — PowerShell supports
        multiple installed versions natively (each lives under \Modules\<Name>\<Version>\) and
        Import-Module without -RequiredVersion loads the highest installed version automatically,
        so stale copies are harmless. Users who want to tidy up can run
        'Uninstall-Module <Name> -AllVersions' themselves — following standard PowerShell convention
        (this is how Az, Microsoft.Graph, Pester etc. behave).
 
    .PARAMETER ModuleName
        Name of the module to check on PSGallery.
 
    .PARAMETER InstallUpdate
        Opt-in switch. When specified, if a newer version is available it will be installed
        side-by-side via Install-Module. Default is $false (notify-only).
 
    .OUTPUTS
        [bool] $true — a new version was INSTALLED in this call. Caller should re-run because the
                       newly-installed code is not the code currently loaded.
        [bool] $false — no update available, notify-only, install skipped by the caller, or an
                       error occurred. Caller should continue with the currently-loaded version.
#>

    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true, Position=0)]
        [ValidateNotNullOrEmpty()]
        [string]$ModuleName,

        [Parameter(Mandatory=$false)]
        [switch]$InstallUpdate
    )

    begin {
        # Write-Debug "Update-ModuleVersion: Beginning module update process for '$ModuleName' (InstallUpdate=$($InstallUpdate.IsPresent))"
        [bool]$ModuleUpdated = $false
    }

    process {
        [version]$InstalledModuleVersion = Get-LoadedModuleVersion -Name $ModuleName
        if (-not $InstalledModuleVersion) {
            $InstalledModuleVersion = (Get-Module -Name "$ModuleName" -ListAvailable | Sort-Object -Property Version -Descending | Select-Object -First 1).Version
        }

        # Module not installed at all — nothing to check against.
        if(-not $InstalledModuleVersion) {
            Write-HostAzS -ForegroundColor Red "`n`tError: " -NoNewLine
            Write-HostAzS "Module '$ModuleName' is not installed.`n" -ForegroundColor Yellow
            return
        }

        Write-HostAzS -ForegroundColor Green "`n`tChecking for updates..."

        # Query PSGallery. Get-LatestModuleVersion is already defensive: on timeout / network error
        # it returns the currently-installed version, so we safely treat "no newer version" as a
        # no-op below. This means an offline machine will never block the caller.
        # The two out-refs expose the TRUE gallery state (the real listed version, which may be
        # lower than installed for a dev build, and whether the gallery was reachable) so we can
        # distinguish "exactly up-to-date" from "running a build newer than what's published".
        $listedGalleryVersion = $null
        [bool]$galleryReachable = $false
        [version]$LatestModule = Get-LatestModuleVersion -ModuleName $ModuleName -ListedGalleryVersion ([ref]$listedGalleryVersion) -GalleryReachable ([ref]$galleryReachable)

        if(-not ($InstalledModuleVersion -lt $LatestModule)) {
            # Installed version is >= the (clamped) latest. Two sub-cases to distinguish:
            if ($galleryReachable -and $listedGalleryVersion -and ($InstalledModuleVersion -gt $listedGalleryVersion)) {
                # Local build is NEWER than the latest PUBLISHED PSGallery release. This only fires
                # when PSGallery was actually reachable AND returned a strictly-lower listed version
                # (offline runs fall back to installed==latest, so they take the else branch).
                Write-HostAzS -ForegroundColor Green "`n`tINFO: " -NoNewLine
                Write-HostAzS "Running $ModuleName v$($InstalledModuleVersion.ToString()), which is newer than the latest published PSGallery version (v$($listedGalleryVersion.ToString())) — likely a pre-release/dev build.`n"
            } else {
                # Exactly up-to-date, or PSGallery was unreachable and we fell back to installed version.
                Write-HostAzS -ForegroundColor Green "`n`tINFO: " -NoNewLine
                Write-HostAzS "$ModuleName module is up-to-date at v$($InstalledModuleVersion.ToString())`n"
            }
            return
        }

        # ////////////////////////////////////////////////////////////////////////////
        # A newer version IS available. Behaviour depends on -InstallUpdate.
        # ////////////////////////////////////////////////////////////////////////////

        $galleryUrl = "https://www.powershellgallery.com/packages/$ModuleName/$($LatestModule.ToString())"

        if(-not $InstallUpdate) {
            # ----- Notify-only path (default) -----
            # Print a friendly upgrade notice and RETURN WITHOUT MUTATING ANYTHING.
            # The caller continues its run with the currently-loaded version.
            Write-HostAzS ""
            Write-HostAzS -ForegroundColor Yellow "`tINFO: " -NoNewLine
            Write-HostAzS "A newer version of $ModuleName is available: " -NoNewLine
            Write-HostAzS -ForegroundColor Cyan "v$($InstalledModuleVersion.ToString()) -> v$($LatestModule.ToString())"
            Write-HostAzS -ForegroundColor Gray "`t To update, run: " -NoNewLine
            Write-HostAzS -ForegroundColor Cyan "Update-Module $ModuleName"
            Write-HostAzS -ForegroundColor Gray "`t Release notes: " -NoNewLine
            Write-HostAzS -ForegroundColor Cyan $galleryUrl
            Write-HostAzS -ForegroundColor Gray "`t To auto-install + re-run: " -NoNewLine
            Write-HostAzS -ForegroundColor Cyan "re-invoke with -AutoUpdate"
            Write-HostAzS -ForegroundColor Gray "`t To silence this check: " -NoNewLine
            Write-HostAzS -ForegroundColor Cyan "re-invoke with -NoAutoUpdate"
            Write-HostAzS ""
            # ModuleUpdated stays $false — caller continues.
            return
        }

        # ----- Install path (opt-in: -InstallUpdate) -----
        Write-HostAzS -ForegroundColor Yellow "`n`tINFO: " -NoNewLine
        Write-HostAzS "Updating $ModuleName from v$($InstalledModuleVersion.ToString()) to v$($LatestModule.ToString())...`n"

        $ModuleInstallError = $null
        try {
            Install-Module -Name $ModuleName -RequiredVersion $LatestModule -ErrorAction Continue -Force -ErrorVariable ModuleInstallError
        } catch {
            Write-Warning "Error installing latest version $($LatestModule.ToString()) of module $ModuleName. $($_.Exception.Message)"
        }

        if($ModuleInstallError) {
            Write-Warning "Error updating module $ModuleName. $ModuleInstallError"
            return   # $ModuleUpdated remains $false; caller should continue with existing version
        }

        # Unload the currently-loaded module from this session and import the freshly-installed version.
        Remove-Module -Name $ModuleName -ErrorAction SilentlyContinue
        try {
            Import-Module -Name $ModuleName -RequiredVersion $LatestModule -Force -ErrorAction Stop
            # Validate the imported module version matches what we installed. Get-Module may return
            # multiple entries when nested modules are loaded, so pick the highest version.
            $loadedVersion = (Get-Module -Name $ModuleName | Sort-Object -Property Version -Descending | Select-Object -First 1).Version
            if ($loadedVersion -ne $LatestModule) {
                $loadedVersionString = if ($loadedVersion) { $loadedVersion.ToString() } else { '<not loaded>' }
                Write-Warning "Installed v$($LatestModule.ToString()) but loaded v$loadedVersionString. Update may be incomplete."
            }
        } catch {
            Write-Warning "Error importing latest version $($LatestModule.ToString()) of module $ModuleName. $($_.Exception.Message)"
        }

        [bool]$ModuleUpdated = $true
        Write-HostAzS -ForegroundColor Green "`t`tModule updated successfully!`n"
        Write-HostAzS -ForegroundColor Green "`tPlease re-run the function so it executes with the freshly-installed code.`n`n"

        # Older versions are deliberately left in place. PowerShell supports side-by-side installs
        # and Import-Module loads the highest version by default, so stale copies are harmless.
        # Users can tidy up with 'Uninstall-Module <Name> -AllVersions' if they wish.

    } # End of process block

    end {
        # Write-Debug "Update-ModuleVersion: Module update process completed (ModuleUpdated=$ModuleUpdated)"
        # Return $true only when the module was actually reinstalled in this call, so the caller
        # knows to abort and re-run. Notify-only / no-update / error paths all return $false.
        Return $ModuleUpdated
    }
} # End Function Update-ModuleVersion


# ////////////////////////////////////////////////////////////////////////////
# Function to display an ASCII art banner
# This function displays an ASCII art banner in the console
# Font = Slant, credit web-site: https://patorjk.com/software/taag/
Function Show-ASCIIArtBanner {

    begin {
        # Write-Debug "Show-ASCIIArtBanner: Beginning ASCII art banner display"
    }

    process {
        # ASCI Art Banner variable
        [string]$banner=@'
////////////////////////////////////////////////////////////////////////////////////////
                 ___ __ __
                / |____ __ __________ / / ____ _________ _/ /
               / /| /_ / / / / / ___/ _ \ / / / __ \/ ___/ __ `/ /
              / ___ |/ /_/ /_/ / / / __/ / /___/ /_/ / /__/ /_/ / /
             /_/ |_/___/\__,_/_/ \___/ /_____/\____/\___/\__,_/_/
   ______ __ _ _ __ ______ __
  / ____/___ ____ ____ ___ _____/ /_(_) __(_) /___ __ /_ __/__ _____/ /______
 / / / __ \/ __ \/ __ \/ _ \/ ___/ __/ / | / / / __/ / / / / / / _ \/ ___/ __/ ___/
/ /___/ /_/ / / / / / / / __/ /__/ /_/ /| |/ / / /_/ /_/ / / / / __(__ ) /_(__ )
\____/\____/_/ /_/_/ /_/\___/\___/\__/_/ |___/_/\__/\__, / /_/ \___/____/\__/____/
                                                   /____/
////////////////////////////////////////////////////////////////////////////////////////
'@


        Write-HostAzS -ForegroundColor Green `n$banner`n
    }

    end {
        # Write-Debug "Show-ASCIIArtBanner: ASCII art banner display completed"
    }
} # End Function Show-ASCIIArtBanner

# SIG # Begin signature block
# MIInOgYJKoZIhvcNAQcCoIInKzCCJycCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAWNEJKJ+kfu+IN
# pYAWL8gdAwQ7Wt51ftSxAhMAANiMtKCCDMkwggYEMIID7KADAgECAhMzAAACHPrN
# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD
# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1
# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD
# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB
# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP
# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC
# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf
# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j
# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT
# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B
# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O
# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL
# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT
# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw
# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w
# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy
# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl
# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC
# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN
# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK
# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK
# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY
# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu
# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE
# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz
# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6
# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO
# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD
# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC
# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT
# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS
# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX
# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ
# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq
# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo
# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv
# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a
# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1
# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO
# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7
# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ
# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS
# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm
# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3
# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E
# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX
# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB
# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP
# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw
# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC
# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D
# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY
# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI
# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6
# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w
# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7
# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK
# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK
# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw
# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT
# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghnHMIIZwwIBATBu
# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc
# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG
# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIL7m87HHKgL7chbKakXaWwNpWIEj
# eSYt+SN5FzT1W5VLMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv
# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE
# ggEAVCEuE0FyIQA5IEy5wNjmjeAGe9FuSTTbvRfzMfkFgIXKmszrrny5qh3cmHHV
# nWTMmeoHcjBe0AFZ2pC+YnZnwfffiEaghL0a2k7oIvy9JyktTxNyxo+HekA+cwlV
# uM41Z4WDzd7Gl7sKnEyYDAU1H37BAHj2I6RzRlZ/1ZtCFS8euL381ENttuVVGUiA
# yNWYxmpN5qf+T/nFrOOxOuFExxkqcnsMmdRU9yU2eIFzVQj9EF0NDcXZbOH1+SZm
# rqpiDMG7r0ih4/OUbmraFONkZYtdLmiHqHBw+he4EMybW0yHQaKQY3q/UaHCF36G
# C4UsT9OIZraO6Slf/PDCY3nFAKGCF5cwgheTBgorBgEEAYI3AwMBMYIXgzCCF38G
# CSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG
# 9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC
# AQUABCARZKV+rYsldd8Iylt1cIRI/HqEqfYbEVwaf1RqyczUPwIGaqk3E7FmGBMy
# MDI2MDkyOTIwNDQ1MC44NjhaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmlj
# YSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046QTQwMC0wNUUw
# LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHt
# MIIHIDCCBQigAwIBAgITMwAAAijwpYfX88geQAABAAACKDANBgkqhkiG9w0BAQsF
# ADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTQwMDZa
# Fw0yNzA1MTcxOTQwMDZaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw
# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046QTQwMC0wNUUwLUQ5NDcxJTAjBgNVBAMT
# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQCujvbk/sqcCSReZaJfCuf1NwRcc7XknhE6wkLofkNj1mxE
# Ag35qy2xcFjgjartVvA09W8QHcpyMqVSXOTxNHJsmk0qP2CDLvUAulWg7aS5oBOR
# pEX1oz3n0R2nPqeH0IHK1zJxjxaHW21AbuZ0Z+wM3WYNzkBlcHmVe03ZG7rlk28h
# 72r5P5ME8FGpFmYW5Hl7psKbgLEfrYAitpttsb+sZsBUI+hMKl4uLJYotKyZv1ew
# OIinBfRU8QosivjofaBezUf9NdV+iGrWh321WnSsK3A/Jl6GLtbSWXcJWULgbxuq
# nobPK+YlB3174TMWTgX4YWjG7o0Otz/pjHNCKBbB788dynhLdGY6B08E9+4SGrRp
# sty4iJHOydHCA5M4i5yYRwsdut+gmvxIpT8yNXJcjJCg0vO8mv/nFY9Wytv2qmCt
# CFFivGUWqU20/sUeRooQZGiQOJQn095Cj3isIsvRP8KU7hN/EDI8HVsb/NPzMFLv
# RznrRnj0TOnDiOTUcnYwmk+XfoS1owskcCCCwHnbC00D58z83y7K5ZJB745hcn4C
# E2nR3e6RGsr42y5qtt6Mdz/s7MTnDS2UmVHWX1X/HZe3UlX8gj/t63L50xIPqkRC
# BEdM1ADNUaSfo9OQiKb/bj1diZCGTfEDUBBLop1mhkwIF82faplV2busZ+U4kQID
# AQABo4IBSTCCAUUwHQYDVR0OBBYEFKrJpYz48tzouvVkBVthASFpQ93DMB8GA1Ud
# IwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRp
# bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYI
# KwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMv
# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1Ud
# EwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeA
# MA0GCSqGSIb3DQEBCwUAA4ICAQCQ6NfLmrRahgVtgWg383GaS07fHyod6bhcUONt
# 2tet+6BaNuH0r7ABkVHheOpxBdrUrOEYVEaIii9dK3cuZLNmp1iUAx/VbmOZYl7x
# z+tNrjCWqrg1jQmq0oRB8iE4QJpwNhGP67oY5huYIU0D4lhDoahqfgKJn/0Bk+9U
# KDPw5XlUYmreFmJlj9YQzcPPep8MxBXxh/Y5I7vQeRaW5SjtiLQOLRk3ggvraDs5
# Sf49MJV6/BwxXC2rvUfEFX6SUDooqKIE9NgVIRq0RZu7Ot0i0Is+HvPP0hB6KwOx
# Mg1SWKOfTtFpWpdo8MJvgKCHkPpXEzgprP+pyIHuO7gVRlSTsbYBFLh2yId/itM4
# uYL0R+2SSBBTpSSRthrGuEmElI5BCHMxzMg/oqHSPwZAIAkM2C4xxi0St7qMuA+m
# +ZzFYkfoF41QoSJn+HjqhqWYQ0m/SO9/KnJRJJUwMd5TiMnjZ+E/DJiUry5udiWy
# Qpvfj2hQFI0djhahoAXDazeEciLF2uEnTur9UfjcwOun/oMY+ULftnOi2jKLMrre
# V097akzz/JxpnDgYJU/tgU7fQflg7IqiL9+0276+joQHo21mVeY5YD8Kh/kUaY6J
# m/OTM88G7evTz/qnRumxovTjMStvpbAHNRhmSTdIPTV32CyuxDKS/V5a5iwA+f9V
# iBo+wjCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcN
# AQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD
# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAw
# BgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEw
# MB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
# U3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk
# 4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9c
# T8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWG
# UNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6Gnsz
# rYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2
# LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLV
# wIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTd
# EonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0
# gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFph
# AXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJ
# YfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXb
# GjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJ
# KwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnP
# EP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMw
# UQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggr
# BgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYw
# DwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoY
# xDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtp
# L2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYB
# BQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20v
# cGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0B
# AQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U5
# 18JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgAD
# sAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo
# 32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZ
# iefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZK
# PmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RI
# LLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgk
# ujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9
# af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzba
# ukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/
# OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNQMIIC
# OAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0
# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh
# dGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUG
# A1UECxMeblNoaWVsZCBUU1MgRVNOOkE0MDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxN
# aWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQB1rbmF
# kzS7qAK1Oav08AUnhbNIUqCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI
# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv
# ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD
# QSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA7mYokDAiGA8yMDI2MDkyOTEyMDc0NFoY
# DzIwMjYwOTMwMTIwNzQ0WjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDuZiiQAgEA
# MAoCAQACAhUnAgH/MAcCAQACAhPTMAoCBQDuZ3oQAgEAMDYGCisGAQQBhFkKBAIx
# KDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZI
# hvcNAQELBQADggEBAH6qtM75bPSzW3rye49WiqQ/kj6jR8M8kk85RvQPRKA1i2kn
# mRcMRiSomC3e7BSzYSgjZT7F3MCt9CEjhARsLrbVV4aod3FXAGYnlA5hlPGQSdzE
# FeNcTItfkVtnSVLCKyEeDkY+hPrpldP+tMxCwd5Zr3Wa0W4AwYBRlQwvxoxvlDjP
# qSSrZjKX61WjJezmRR0QTGJcl/DcxhVhThS5ai+pqrk+XH4u1WzZAFOdHi72+d3S
# 7FV9fME0kRfeHQsiMhAqDLEtd6orlpznsYX2w6dVV9RIasVuF0Cht7CXYIIu4DDo
# 8v9DhNNKQjuQYU5p+kf7pgcBXL3hJi6P2iZct7AxggQNMIIECQIBATCBkzB8MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy
# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAijwpYfX88geQAABAAACKDAN
# BglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8G
# CSqGSIb3DQEJBDEiBCBTmX3Mx0fQjeMHY8ZGxCSrofSliKUWmfA3FP4cnkTa7TCB
# +gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIFWxikZRYGNf4oEVZK1eT45H+3GQ
# 3/qxV75VwuBt+iLXMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh
# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD
# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw
# MTACEzMAAAIo8KWH1/PIHkAAAQAAAigwIgQgeMPvh8dasz1mZA/nflfJqlmif3wS
# QHFZgBIw6FcZk78wDQYJKoZIhvcNAQELBQAEggIArKyGR1QMG0yylz3IDaqpBkwF
# dPl4p1DO97CBvyLZ9xHe0oiMrXp/xSm9uF3GGlqt7ZEDDcH+bpfGoBSKyd2pA5Bx
# Iu/K6RLwS9jDvNjXCJKQd8FDr/NS8n4sh7LG2TzdCqh0VfeC+tGhT6v/bEaTlVO7
# NAgHQeqd+bhoKT0aDgI68t3nxoYIdZGsIGhdB07U9BC1q6qu87d++c7gGi7qLSiq
# +vk+sFv9IfbGBNRCiNUcc2zNlEfjZ7GNshFtXan5NYDEZwE/rSnY0UFaA2Rnv7NA
# ZSglEQF050xmM9Ggp9cJbSzNXR38znWNDhIT5kP+9vtfZaejxQ0UgzIkax5tkIU/
# /vDzQgHCydceAZyorWHGXAmNHjK75Nz/AnA8TzI1Dc2mT4LFD4yG88HF2b4k1aLz
# BvGkbJg/Vc1X00zEBwQEWik+ZnL0ed/ipjhsU1MhyTWeK3CSWyMkK94MI2vbynsJ
# jq6GvuLxIC6gib6QGfQaklobf1TvL3xnc12aiapG83Yz9naOKk9zuIBLcmSYhwfz
# nKCAB6xgIsOpP3SQpnX/0jMCp+SPUUB5yYVm4+Dwfl4fYU010sK/yxIMKMbs0UBw
# U/gOhDwPw5yMRoLg3FcED19VYnTRynyTBhQ/yQi+Dw3vqcLXJXTHtExQEBeV3fNw
# ciLONbiIU4KaQEDC4h0=
# SIG # End signature block