Private/initFunctions.ps1
|
function Write-SEPPMAILText { <# .SYNOPSIS Writes text using SEPPMAIL foreground and background colors. .PARAMETER Colorset Selects Main (#CFDE00 on #034049), Secondary (#F8FBCC on #CACAB7), or Action (#A879E1 on #13D38E). Defaults to Main. .PARAMETER FgHex Overrides the selected color set's foreground color. .PARAMETER BgHex Overrides the selected color set's background color. .EXAMPLE Write-SEPPMAILText -Colorset Main -Text 'SomeText' #> param( [string]$Text, [string]$FgHex, [string]$BgHex, [switch]$NoNewline, [ValidateSet('Main', 'Secondary', 'Action')] [string]$Colorset = 'Main' ) $palette = switch ($Colorset) { 'Main' { @{ Foreground = '#CFDE00'; Background = '#034049' } } 'Secondary' { @{ Foreground = '#F8FBCC'; Background = '#CACAB7' } } 'Action' { @{ Foreground = '#A879E1'; Background = '#13D38E' } } } if (!$PSBoundParameters.ContainsKey('FgHex')) { $FgHex = $palette.Foreground } if (!$PSBoundParameters.ContainsKey('BgHex')) { $BgHex = $palette.Background } $esc = [char]27 $fg = $FgHex.TrimStart('#') $bg = $BgHex.TrimStart('#') $formattedText = "$esc[38;2;$([Convert]::ToInt32($fg.Substring(0,2),16));$([Convert]::ToInt32($fg.Substring(2,2),16));$([Convert]::ToInt32($fg.Substring(4,2),16));48;2;$([Convert]::ToInt32($bg.Substring(0,2),16));$([Convert]::ToInt32($bg.Substring(2,2),16));$([Convert]::ToInt32($bg.Substring(4,2),16))m$Text$esc[0m" Write-Host $formattedText -NoNewline:$NoNewline } Write-Verbose "Create Helper function for Version checking" <# .SYNOPSIS Parses a semantic version string and converts it into a structured object. .DESCRIPTION The `ConvertTo-SemanticVersion` function takes a version string that conforms to the Semantic Versioning (SemVer) standard and parses it into its components: Major, Minor, Patch, PreRelease, and BuildMetadata. If the input string is not a valid semantic version, the function throws an error. The SemVer format includes: - A version core: `MAJOR.MINOR.PATCH` - Optional pre-release information: `-<pre-release>` - Optional build metadata: `+<build-metadata>` .EXAMPLE ConvertTo-SemanticVersion -VersionString "1.2.3-alpha+build123" Returns: @{ Major = 1 Minor = 2 Patch = 3 PreRelease = "alpha" BuildMetadata = "build123" } .EXAMPLE ConvertTo-SemanticVersion -VersionString "4.5.6" Returns: @{ Major = 4 Minor = 5 Patch = 6 PreRelease = $null BuildMetadata = $null } .INPUTS [string] You must provide a semantic version string as input. The string must conform to the SemVer format. .OUTPUTS [hashtable] The function returns a hashtable with the following keys: - `Major` ([int]): The major version number. - `Minor` ([int]): The minor version number. - `Patch` ([int]): The patch version number. - `PreRelease` ([string]): The pre-release label, or `$null` if not specified. - `BuildMetadata` ([string]): The build metadata, or `$null` if not specified. .NOTES - The function validates the format of the input string using a regular expression. - If the input does not conform to the SemVer format, an exception is thrown. .LINK Semantic Versioning Specification: https://semver.org/ #> function ConvertTo-SemanticVersion { param ( [string]$VersionString ) if ($VersionString -match '^(\d+)\.(\d+)\.(\d+)(?:-([\w\-\.]+))?(?:\+([\w\-\.]+))?$') { return @{ Major = [int]$matches[1] Minor = [int]$matches[2] Patch = [int]$matches[3] PreRelease = $matches[4] BuildMetadata = $matches[5] } } else { throw "Invalid semantic version format: $VersionString" } } function Invoke-RepoInstall { param ( [string]$artefact, [string]$artefactVersion ) if (!(Get-Command -Name 'Install-PSResource' -ErrorAction SilentlyContinue)) { #$RepoInstallMethod = 'Module' $InstCommandString = "Install-Module $artefact -requiredVersion $artefactVersion -force -WarningAction SilentlyContinue" } else { $InstCommandString = "Install-PSResource $artefact -Version $artefactVersion -Reinstall -WarningAction SilentlyContinue" } Invoke-Expression $InstCommandString } # SIG # Begin signature block # MIIQVQYJKoZIhvcNAQcCoIIQRjCCEEICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB2jBvF4k0u7SLJ # ZC0T+zhnhcZdvoHMuIuii71CvzqooKCCDJEwggYaMIIEAqADAgECAhBiHW0MUgGe # O5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYDVQQK # Ew9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENvZGUg # U2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5NTla # MFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNV # BAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0GCSqG # SIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjIztNs # fvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NVDgFi # gOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/36F09 # fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05ZwmRmT # nAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm+qxp # 4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUedyz8 # rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz44MPZ # 1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBMdlyh # 2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaA # FDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritUpimq # F6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNVHSUE # DDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsGA1Ud # HwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1Ymxp # Y0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsGAQUF # BzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2ln # bmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdv # LmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURhw1aV # cdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0ZdOaWT # syNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajjcw5+ # w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNcWbWD # RF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalOhOfC # ipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJszkye # iaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z76mKn # zAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5JKdGv # spbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHHj95E # jza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2Bev6 # SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/L9Uo # 2bC5a4CH2RwwggZvMIIE16ADAgECAhBIqMP3CCLHOHtOKuaWNyeFMA0GCSqGSIb3 # DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQx # KzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwHhcN # MjYwNDE1MDAwMDAwWhcNMjcwNzE0MjM1OTU5WjBmMQswCQYDVQQGEwJERTEPMA0G # A1UECAwGQmF5ZXJuMSIwIAYDVQQKDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJI # MSIwIAYDVQQDDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJIMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAvAFzE8MbJpvQt+IdIh1M+bKYsJBFDk4b9ySe # 25IrCi00B9o5XmQtIw42MqyIKbUq1tDARtp9KTQedEP9W+rflAF2l+0Z046Jkiqu # mU9/enbqWLDyln1aS/p7HOgwZFMhnsR9zH0MfFckiklUmkzJO+vmzYAK7ZmDxajN # LJs0gkGRU2/BecAx/TSvLXMaKONsKZCyMKQCnwo1mCY/tFl5EgUz7YQFrPORBQGf # Qke/hkdBfQDqNRsi/J6+KhJWc6LvgQihdRg/INQbQsTxlow18NWvyFsjjueH7kG6 # HR4YKfbv07xgrsIh8xvq9ZJ1SBhLXmkg4SdoQGASjqR6o3keAX+bDRFf+hmlWWJp # /FqVHR5QomF3vbK2/bbz4jAclYSPx/sPasNJ0YnKFkgmowZ7Ysa0KA0/egBgtI4g # J+8V7zrqIVEG3rMQh9KCdMnJqP2aM9o4gUzQvE1M4x606liX9EWwdLLS+fe79o+F # zo5oH4wBE/En6hQQkzseHHu+TXCDd6zUUZ/PlTK0gTaDIRXt6UzPNqJ4RiRCW2pN # FcPt078qqVTuwKUXoE4ufxGgXKFrZlCYST/9eG1TnW2oq19nz8A333GCsL3gpoNI # KvfmDyGMMNzvx2aeqn2v6e75z8kH19iGSNZ51xT+WgS9F1aIvjz08/T7XAv7iDPF # 1/gPIp8CAwEAAaOCAakwggGlMB8GA1UdIwQYMBaAFA8qyyCHKLjsb0iuK1SmKaoX # pM0MMB0GA1UdDgQWBBS30/Tq+alF3j2BY5up8n5zpAU23DAOBgNVHQ8BAf8EBAMC # B4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBKBgNVHSAEQzBB # MDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28u # Y29tL0NQUzAIBgZngQwBBAEwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5z # ZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIzNi5jcmwweQYI # KwYBBQUHAQEEbTBrMEQGCCsGAQUFBzAChjhodHRwOi8vY3J0LnNlY3RpZ28uY29t # L1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNydDAjBggrBgEFBQcwAYYX # aHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETc3VwcG9ydEBzZXBw # bWFpbC5jaDANBgkqhkiG9w0BAQwFAAOCAYEAi7fmb5UYoemWG3CC4K2UZWVrR6GO # fi8gbJKgjPbKO4zrCrU/x6cOdyp6scKZfUEGFDf8KH6pP4pAQv1Hsbi49gU2kxoU # WLlCiipn05qJY663DHx9hlStej/ZdEatou0wyCDiG5xD7kmG+1t6iLyyCBgEB88t # JpzTjI61qXmBTS/FGEOAsB4SDEW1ngA7bc5FOv4IUKA43hp8M+N3GeYFzDqwJELY # EfVVYheBW3o7q4VrCdfFEuaQihOtvfDfYpP6ANgekNn8HdsMT8rx9D1I50Rli/qQ # Fo2BOuPyb2SIQPzJvCs5wgi5qgp1nHiN6igumu2Cz7BmGjOazGUgCSUY5QwyE8+F # +R2tVM+2O15rfX01+e56ZfojBEiEjMwfPHs3fa3V3gokWWNwUMkton/v0R/nl2zj # mOr2okohOINZEDh9frg21zUCN5ZD8Y4zQWuiJLCvvvBZs0JR4c9xl2k2wtw/QLPh # GU69zM3smGpRoLE8M6zvUvSU7jXjvefazUniMYIDGjCCAxYCAQEwaDBUMQswCQYD # VQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJTZWN0 # aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2AhBIqMP3CCLHOHtOKuaWNyeF # MA0GCWCGSAFlAwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJ # KoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQB # gjcCARUwLwYJKoZIhvcNAQkEMSIEIAGO7gAP3bWa6io4BVNkICw9tIcrap8gjWrb # 48ouzYLnMA0GCSqGSIb3DQEBAQUABIICAHd/3TcUl/IcSLLxZbK7R6Rp1uPpcy7x # HGKYZTb8XBJADUV3HLdiyzgezOv/9hiu3Pt6nCkav9+S/rdUybXldvyfqazmyDzi # uvTwXZ6+kC7hEyw4i6AMGtxDh7uhc+v8ZgLnjErjgNQ9sOBZsSLfrGFVM7XIESu/ # uygGhf/aVSYvyiaqRTBVOwLElcxWmCkQPUvATSZoiYP1DyDoxXOM1Q22NsUS7+A2 # rBoOQCIuUr9dndTBLXdFrYGbDwJ26qAY4BZkEzLRdBVBGJUmIeKOnvC/JGUMWhQb # s/CWZOcEJ1L/jpYsvFaN3Joz2jRo/Y3Vsepl10/T1n9RcgPjEbRX0qL7dakcNrW3 # 4d82X7DWOA3uKTQD44+Cp/Xw/TNfhyvIq2iw4kLsCiaqyiMg1R/fKhp/VF6w3kRJ # pxkkYejh0v+WXqybY8ZC8lgL80k6fJfdb6IMob1veOYHNHBdRfqj62IZ+3N+jZe4 # pObTP41vTHqLV3/u39sZougWhHJ2eB5pANLDfhvCZUDrc+TIFkuz7+uDmiHYawC+ # /bmf9X8UHYTsTyVIPHUb090Aj5sah90ON1TYFpRfhs1GlzJ66XqO9pfrAR+TQmEd # 44GGvwJl7tgamKFc5OC8LojPlxKN/UlTWFk8gir+iLiF4Pzn9RXdjvRuCLP0HaG8 # Jja4PbgVRk7z # SIG # End signature block |