packages/AzStackHci.DiagnosticSettings.0.6.9/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 {
        # Get Existing Most Recent Module Version:
        [version]$ExistingModuleVersion = (Get-InstalledModule -Name $ModuleName -ErrorAction SilentlyContinue).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 {
        # Pick the highest currently-installed version of the module (a single module can have
        # multiple side-by-side installs under \Modules\<Name>\<Version>\).
        [version]$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
# MIInUQYJKoZIhvcNAQcCoIInQjCCJz4CAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAhfDXBiJh81zOe
# PUP1IBDeyU5q10Ur8J+MdRfaVSDweqCCDMkwggYEMIID7KADAgECAhMzAAACHPrN
# 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/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghneMIIZ2gIBATBu
# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc
# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG
# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIEc7R18vOMwuOZUJlSmuTpvpw7dx
# KFDaS89xvFuj6wFXMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv
# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE
# ggEAxhj27hH154CUO7Pogzz9/D2EctcD2sxaBcmQXvWX4j51WkkKhKIWMmq8BKxF
# dlmTOUMgUHgsnU+E7RePpPCiBRVGa5R7annhzal+M8gCBSyQD6V3VkkSkt4wNdD5
# bBHvYL7mF65UrAZlHeVJ8et2LEVcrOf21xs5qMa+1ST6CzuPgetPZIMBZexJWxDQ
# KWUxS9JM9mvYX3zGCwEC3PjEf+O/y/mTapGWfBmA8pxIEgRgEO/erVXbJKIHi5R/
# NJpR9RtaMpQ0Hkn80YOzZ7Ugoec141HVG5UwlH+hqfPT4dfuDLBzzsFgAaisZ9c/
# 4BIaEj49m9I47KZv4sA4dkEdDaGCF64wgheqBgorBgEEAYI3AwMBMYIXmjCCF5YG
# CSqGSIb3DQEHAqCCF4cwgheDAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG
# 9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC
# AQUABCB+pbejhN5LBlCBfqApGwZU3d0gf7yydNijo2se8znnTgIGaokIEvNvGBMy
# MDI2MDkwMjE1MjY0MC40ODdaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu
# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0
# MzFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaCCEfwwggcoMIIFEKADAgECAhMzAAACHUvAkoc4hX45AAEAAAIdMA0GCSqG
# SIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgx
# NDE4NDgzM1oXDTI2MTExMzE4NDgzM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQI
# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv
# ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh
# dGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjQzMUEtMDVF
# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC
# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAorSgaAA8oOl4ph574zw29egU
# N8DDepRHLX8FM1zHNJmXG6KrSqUKwzcKafopuYdPTETTCvb9aJfESuAU0iGNUFI/
# D6R0kvdfpe2oPX+E3sbTQvGi4JPH5qdIYUaJ45V/4bqe8eNvbWzpC+ZKjH193Dei
# I1XAI918JoQmBhlEXo/Ton1721luZJgincsf5LjMY3jX84WyXUSX3dsS7h/7xVI+
# w1yjg7pa+0y3o/me2Tsv6UJUdSTQap5ORGSfCnclnP1z3IiiWIWr3Vo7aIPWsgJz
# q3m5GxpxUHCQk8qzUhk50y/uB+LGE3WIK2C77iy9iFsSfSLUnyMEzGRDW9mXHT4P
# H7Ozz6CHqQEiNvwcHqlvlCh1pHQh1NXQSAqOoVBs5mi6easf6yxWTfe5DrR79503
# r8pU6VqC2Y9XMRU4wH9QbYXYsIUZ33Jmndy22W1LBDAbxBPQHCBlncGDU3BgdhVU
# VLe80mggFO98FdkWho67w4kPdCTRkvdvkY8PrQYE/nQjHXCa0g7LcMttZb6ejMHf
# Q+tUWXv6+nZ4Ynkr2OkaxclFCw4RIYNMWD26AWbQj/WEdzga18fKtw66L5gzXPza
# 6jFBfPJeKE3H8QAuwpirmH4ms+5nUjNNQOmNgqJn0U1+3Yn7ClswD79YN0r3fdbY
# BMDApBZJpNlK7q7HXRsCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBSEWfBxNEamZtXm
# 8gl92Yq80jfxXTAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV
# HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny
# bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI
# KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy
# MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI
# MA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAkdweB4yxvLspLKq0
# D+miyD4Q0EcxVFpNZuJxiR54gWRkeTDDuymNeB03JhlsBpbwSYJ5uZSgDBCvwHED
# 2VL8lJpFlOprJzxsXWC2NTfA+O+PO5Fk5jw6LHh6jeBADDEdQAx3Hqi7Zm0JwvQ9
# 3z5f6dtxkm29WqOcHYXRXfAQwy1hSrLXyfeblqR66jpP/9n0fCkWU4ggsUjQpQ2N
# gj1DV09J4Y3y7p9Nd81+Xs6qYo++7RKm8qiB/5NDeigOLjlAeFgiEXIRUJW+mJyq
# pQw+OORlaqcFjR8Hu0G+/7bMdek68YX+kPpDBk7Ue+I/xgiYJ1xcDRBn/vczLtN7
# 2+RIlD4UgXYLuBSCk//pDEPX5z39Cr+rkc6E4Y28FPk4BhloAyvp628P4xfElQY8
# TcxraUbZShypocE6ny95D1K1BkltZmrHVKCxmglnuOlM15NKIrXFlXCzdqpCtIwQ
# 417wNAVF/QDPvzzbumPdTi6fb0tLbScYobV6zvbBsMsKEME4Tj1b9oIXC8dybJq4
# nbboEXYpRwi1QAbpSNrn+PxGW9uf1q63FnMJu4gm3Oh63njW/iVf723quzyHrSij
# WMgY0HiRiHQi0Jyu0h8MdhRUp7mxbmLQckPiOFwAlIaUN/k725y/aLWpkRU6fqmL
# lEOyH5WpyLd23AYy9r8v+Qoba6swggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZ
# AAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0
# ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVa
# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT
# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEF
# AAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1
# V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9
# alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmv
# Haus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928
# jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3t
# pK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEe
# HT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26o
# ElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4C
# vEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ug
# poMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXps
# xREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0C
# AwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE
# FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtT
# NRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNo
# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5o
# dG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBD
# AEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZW
# y4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5t
# aWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAt
# MDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0y
# My5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pc
# FLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT
# Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0j
# VOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3
# +SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmR
# sqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSw
# ethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5b
# RAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmx
# aQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsX
# HRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0
# W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0
# HVUzWLOhcGbyoYIDVzCCAj8CAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu
# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0
# MzFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaIjCgEBMAcGBSsOAwIaAxUAuoO+BKbfXzqyfi9GLEdWHkCLeT+ggYMwgYCk
# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIF
# AO5CrqUwIhgPMjAyNjA5MDIxNDE4MTNaGA8yMDI2MDkwMzE0MTgxM1owdTA7Bgor
# BgEEAYRZCgQBMS0wKzAKAgUA7kKupQIBADAIAgEAAgMAiOswBwIBAAICElcwCgIF
# AO5EACUCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQAC
# AwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAHRAxP2j9xijZSqkU
# HmXErWjYHmMJGq2AYSJOfm7M91PqTMQRDrD3TIS8jfC87MzzEMmw1bFOZPb2uKL8
# m7gUdRw1N2472F6QNJAtQrncOvMtSL5oJFepShQJKIQ8ZkcT1rMeTD6X/5rgxbAT
# 2k0wbZ5tSlYCfO4+1L9bhTcSoT5gaKGETT3EdfdqQS4Zd84niMxZa/bicY8uBvKL
# QR0tjsEtKuLYH1N7viw053rnAHqllNkuaGKW+vOdntQ8sIuk5N8OOoj3uHyRtljY
# 2OsNvS1zwprN7tsHepgVKUGTn2xmJstWsmzFBPGzZCkWiB4vEKYnHodPJ+jUY3b2
# FWSHPjGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo
# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y
# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw
# AhMzAAACHUvAkoc4hX45AAEAAAIdMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG
# 9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIOWBGbrRZrAENt9u
# 6ao3tWZ0gD/fkMoPubGw4kspAUaSMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCB
# vQQgsbaVzFxIiyc66jO+3qeK0zcKzDo+oKVjfYWb6Y+UBVEwgZgwgYCkfjB8MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy
# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAh1LwJKHOIV+OQABAAACHTAi
# BCBtH8O4WSTnMhtnQau5irGWNTBdLPGa9rDQRYVgHukn6zANBgkqhkiG9w0BAQsF
# AASCAgCTLOQ4DuYkw+NlZFCqiTq+xFsEihrG+wYj4N3NLGqikqz5IDFo9WJxUbIN
# 9SvaBaUW4n+aSGJkpONjYzXuYPmA5UBRQNEAOPzKSsMdeflNvze6tuuOpQzgcojO
# IdkpjqKfeew63l1av8LN1aoXSAjOSstK++2Czz5Ooa/MmKGepcbTca+kfAmmKTrq
# sw8lgElypU+2hrxCikTXopssnQPXePuGuSFR4pOGynhMX/bCKNJqnCULN6dznsHO
# fetyD/KJXd7Pt2swAPKJZyRcUfZj7iT+8UauBoO64mMQ+BNuzHGSIf9Fr7K9gfpb
# FPSlDMH8tz5bPyQ8eGTIe6bdURFys+rA7WNgOvYAgX1g7ZbgJaKksExhIBGeSvia
# 5xASbzhoZKOUfU/rbAucyUJ43SwyEc1GyCyFrfJK2YrufZpq00GLawxKY01eQzJG
# QdZsKth38xtiSddQeSAh0AtZaQZ5vGYNrAcZTSFY3ypGmYGXkb2GXkOcLE+7xnaa
# vePFghwFy/PdH6QYRCrp4rKB3Kgm7iBDpIfcivZ9pfYN6xuxYEWEznWFODCAg0kr
# OXokbpAnjO60tMLRsXL/B/5QRKBDR5B3frFSF/n0sjC/lFsY6lQiyDYLDSuwOBko
# N4z737FKRlQEuBAaMUhfGif4CUuoaIFu94VCea8VtsuqgLWzeA==
# SIG # End signature block