Scripts/InitScript.ps1
|
[CmdLetBinding()] # Detect installed module version $ModuleRootPath = Split-Path -Path $PSScriptRoot -Parent $ManiFestFile = Import-PowerShellDataFile -Path $ModuleRootPath/SEPPMAILConnect.psd1 $Global:ModuleVersion = $ManiFestFile.ModuleVersion.ToString() [string]$requiredPSVersion = '7.6.6' $requiredModules = @{ 'ExchangeOnlineManagement' = '3.10.1' 'DnsClient-PS' = '1.2.1' 'PSWriteHTML' = '1.41.0' 'Microsoft.Graph.Authentication' = '2.41.2' 'Microsoft.Graph.Applications' = '2.41.2' 'Microsoft.Graph.Groups' = '2.41.2' 'Microsoft.Graph.Identity.DirectoryManagement' = '2.41.2' } . $ModuleRootPath\Private\initFunctions.ps1 # Set Default Values for Releasetext and Colorset $releaseText = 'You are running a STABLE release of the module' $releaseColorset = 'Main' if ($ManiFestFile.PrivateData.PSData.Prerelease) { $releaseText = "*** You are running the PRE-RELEASE version $($ManiFestFile.PrivateData.PSData.Prerelease) of the module ***" $releaseColorset = 'Action' } $bannerLines = @( '' "Welcome to the SEPPMAILConnect PowerShell module version $ModuleVersion" $releaseText '' 'Please read the documentation if you are unfamiliar' 'with the module and its CmdLets before continuing !' '' 'Documentation' 'https://docs.seppmail.com/en/connect/index.html' 'Press <CTRL><Click> to open the Link' '' ) $contentWidth = ($bannerLines | Measure-Object -Property Length -Maximum).Maximum $border = '─' * ($contentWidth + 2) Write-SEPPMAILText -Colorset Main -Text ("┌{0}┐" -f $border) for ($i = 0; $i -lt $bannerLines.Count; $i++) { $colorset = if ($i -eq 2) { $releaseColorset } else { 'Main' } $framedText = "│ {0} │" -f $bannerLines[$i].PadRight($contentWidth) Write-SEPPMAILText -Colorset $colorset -Text $framedText } Write-SEPPMAILText -Colorset Main -Text ("└{0}┘" -f $border) Write-Verbose "Running InitScript.ps1 and doing requirement-checks" if ($scSkipTests -ne $true) { Write-Verbose 'Check if PSGallery is registered' if (!(Get-PSResourceRepository -Name PSGallery -ea 0)) { Register-PSResourceRepository -PSGallery -Trusted } Write-Verbose 'Check if PSGGallery is trusted' if ((Get-PSResourceRepository -Name PSGallery).Trusted -ne $true) { Write-Warning "You do not Trust the PowerShellGallery as a module installation source." Set-PSResourceRepository -Name PSGallery -Trusted } Write-verbose "Check PowerShell Version" [String]$instPSVersion = ((($PSVersionTable.PSVersion.ToString())) -Split '\.')[0..2] -join '.' if ($PSVersionTable.PSEdition -eq "Desktop") { $lines = @( '!!! Wrong PowerShell EDITION !!!' 'The module does not support' 'Windows PowerShell 5.1 Desktop and earlier' "PLEASE install PowerShell CORE $requiredPSVersion+" ) $contentWidth = 56 $innerWidth = $contentWidth + 2 # je ein Leerzeichen Innenabstand $frameColor = 'Secondary' $contentColor = 'Action' # Oberer Rahmen Write-SEPPMAILText -Colorset $frameColor -Text (' ' * ($innerWidth + 2)) foreach ($line in $lines) { $inside = ' ' + $line.PadRight($contentWidth) + ' ' Write-SEPPMAILText -Colorset $frameColor -Text ' ' -NoNewline Write-SEPPMAILText -Colorset $contentColor -Text $inside -NoNewline Write-SEPPMAILText -Colorset $frameColor -Text ' ' } # Unterer Rahmen Write-SEPPMAILText -Colorset $frameColor -Text (' ' * ($innerWidth + 2)) } else { $minPSVersion = [System.Management.Automation.SemanticVersion]::Parse($requiredPSVersion) $instPSVersion = [System.Management.Automation.SemanticVersion]::Parse($InstPSVersion) if ($minPSVersion -gt $instPSVersion) { $lines = @( "!!! Wrong PowerShell Version $instPSVersion found !!!" "PLEASE install PowerShell CORE $minPSVersion+" ) $contentWidth = ($lines | Measure-Object -Property Length -Maximum).Maximum $innerWidth = $contentWidth + 2 $frameColor = 'Secondary' $contentColor = 'Main' Write-SEPPMAILText -Colorset $frameColor -Text (' ' * ($innerWidth + 2)) foreach ($line in $lines) { $inside = ' ' + $line.PadRight($contentWidth) + ' ' Write-SEPPMAILText -Colorset $frameColor -Text ' ' -NoNewline Write-SEPPMAILText -Colorset $contentColor -Text $inside -NoNewline Write-SEPPMAILText -Colorset $frameColor -Text ' ' } Write-SEPPMAILText -Colorset $frameColor -Text (' ' * ($innerWidth + 2)) Break } } Write-Verbose "PowerShell version is $instPSVersion and equal or newer than required version $requiredPSVersion" Write-Verbose "Create Helper function for module installation" <# .SYNOPSIS Installs a PowerShell module or resource from a repository using the appropriate installation command. .DESCRIPTION The `Invoke-RepoInstall` function checks if the `Install-PSResource` command is available. If available, it uses it to install or reinstall the specified artifact. If not, it defaults to using `Install-Module` for installation. This function ensures compatibility with both older and newer versions of PowerShell's module management tools. .PARAMETER artefact The name of the module or resource to be installed from the repository. .EXAMPLE Invoke-RepoInstall -artefact 'ExchangeOnlineManagement' This command installs or reinstalls the `ExchangeOnlineManagement` module. .EXAMPLE Invoke-RepoInstall -artefact 'PSWriteHTML' This command installs or reinstalls the `PSWriteHTML` module. .NOTES - This function simplifies module installation by abstracting the differences between `Install-Module` and `Install-PSResource`. - Requires the appropriate repository (e.g., PSGallery) to be registered and accessible. .OUTPUTS None. .INPUTS [string] Accepts the name of the module or resource as a string. #> Write-Verbose "Check required Module availability" foreach ($module in $requiredModules.Keys) { #Reset of variables for loop $localInstVersion = $null $semanticLocalInstVersion = $null $semanticRequiredVersion = $null $version = $requiredModules[$module] Write-Verbose "Checking version $version for module $module" $availableModules = Get-Module $module -ListAvailable | Sort-Object Version -Descending if ($availableModules.count -gt 0) { $localInstVersion = $availableModules[0].Version } if ($localInstVersion) { $semanticLocalInstVersion = [System.Management.Automation.SemanticVersion]::Parse($localInstVersion.ToString()) Write-Verbose "Installed version of module $module is $localInstVersion" $semanticRequiredVersion = [System.Management.Automation.SemanticVersion]::Parse($Version) Write-Verbose "Required version of module $module is $version" } if ((!($localInstVersion)) -or ($semanticLocalInstVersion -lt $semanticRequiredVersion )) { try { Write-Verbose "Installing required module $module" -InformationAction Continue Write-Output "Installing/Updating Module $module with required version $version " Invoke-RepoInstall -artefact $module -artefactVersion $version } catch { Write-Error "Could not install required Module $module with version $version. Please install manually from the PowerShell Gallery" } Write-Verbose "Import module $module" Import-Module $module -Force } else { Write-Verbose "Installed version of module $module has the required version $localInstVersion" } } } Write-Verbose 'Initialize argument completer scriptBlocks' $script:paramDomSB = { # Read Accepted Domains for domain selection param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters) $tenantAcceptedDomains.Domain | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { "'$_'" } } # SIG # Begin signature block # MIIQVQYJKoZIhvcNAQcCoIIQRjCCEEICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAtX90h2X2xSWjv # fZ6Xwkk3mmDCRLQKkXr/XnljSc4d3KCCDJEwggYaMIIEAqADAgECAhBiHW0MUgGe # 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 # gjcCARUwLwYJKoZIhvcNAQkEMSIEILUvyFtcSCpPyQCYeprCPxOqpdIG02Bu0oFA # lDOorTWHMA0GCSqGSIb3DQEBAQUABIICAFGGDu3MFLaJz+Ofb6j+wvMg/xImS/D6 # F7+w/jyo2X+5NTZTqEQSIDW/VQyK3fDwuvzZgTl2jkgqNK8NlrKnf8yOkN4LbQPy # fA1QNun87WjM9dWFWI/kwUjSLw3d+jpzQzEs8P6jYL5jdekEtXrf1fftkJfU4VrY # Ysg335y72T9P79He7JEt2cYElOYyj+aaXTj0U3B4ef661hA0Aw3n/58a6jFixOYj # /LIkXY5+oAkifB54xyvvkzEfM/hdNnIORJ3rZcSv5viFJREcAkE1kKHbuAaeRGy1 # xxIHulKRXkEh2k2bPYqByEURFjx0M2nIhaTBR5TDufZylECnsgnI0ohXB2FUqExR # Wvh+yTrRnfb8fzfrTQ0ohm2d0+4wEuyDho1j0DiJgZrvVl7umVTH9ZcOsHwZ45Qr # whqaSo+r1MTHXQf/STrUgvddyCeuxJRFRLiy98ab30aFMUZ55JZkfpE0kA4dvex7 # YJOTa9JF/+HF4Cbcag/GA4O3LBMaEEUlxzDKmyGiel9t7XBvGtooc2Q6JssefY+W # HHuDhSv7TGDwNOYYVXOVVCjgYKOHPtHv7pvgRMOjgOyu2n9kw80/TU44CZEXD88t # VqY00PusMmM3/wl2wsbh3ptezgUaQ1URgBp/oREHBIM8hKvCYbZj3pd3n7AMt6xU # JwroXUKHmHxI # SIG # End signature block |