SEPPmailAPI.psm1

[CmdLetBinding()]
$ModulePath = $PSScriptroot
. $ModulePath\Private\SEPPmailAPIPrivate_Cfg.ps1;

. $ModulePath\Public\SEPPmailAPI-Customer.ps1
. $ModulePath\Public\SEPPmailAPI-Cluster.ps1
. $ModulePath\Public\SEPPmailAPI-Crypto.ps1
. $ModulePath\Public\SEPPmailAPI-Disclaimer.ps1
. $ModulePath\Public\SEPPmailAPI-Info.ps1
. $ModulePath\Public\SEPPmailAPI-Group.ps1
#. $ModulePath\Public\SEPPmailAPI-ManagedDomain.ps1
. $ModulePath\Public\SEPPmailAPI-Mailprocessing.ps1
. $ModulePath\Public\SEPPmailAPI-MailSystem.ps1
. $ModulePath\Public\SEPPmailAPI-ModuleCfg.ps1
. $ModulePath\Public\SEPPmailAPI-Statistics.ps1
. $ModulePath\Public\SEPPmailAPI-System.ps1
. $ModulePath\Public\SEPPmailAPI-Template.ps1
. $ModulePath\Public\SEPPmailAPI-User.ps1
. $ModulePath\Public\SEPPmailAPI-UserCrypto.ps1
. $ModulePath\Public\SEPPmailAPI-WebMail.ps1
. $ModulePath\Public\SEPPmailAPI-Report.ps1
. $ModulePath\Public\SEPPmailAPI-SSL.ps1

$script:requiredVarList=@(
    'SMAHost',
    'SMAPort',
    'SMAVersion',
    'SMACred',
    'SMASkipCertCheck'
);
$Script:missingVarsMessage='Missing variables';
#>

#region Module environment
#$ModuleRootPath = Split-Path -Path $PSScriptRoot -Parent
$ManiFestFile = Import-PowerShellDataFile -Path $ModulePath/SEPPmailapi.psd1
if ($($ManiFestFile.PrivateData.PSData.Prerelease)) {
    $Global:ModuleVersion = "$($ManiFestFile.ModuleVersion.ToString())" + '-' + "$($ManiFestFile.PrivateData.PSData.Prerelease)"
} else {
    $Global:ModuleVersion = "$($ManiFestFile.ModuleVersion.ToString())"   
}
#endregion

# We add a property to parameters to filter them out later. Required to properly do type-reformatting of string/boolean parameter value types.
if (-not ([System.Management.Automation.PSTypeName]'SMAParamFilterAttribute').Type) {
    Add-Type -TypeDefinition @"
        using System;
        [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
        public class SMAParamFilterAttribute : Attribute {
            public string Filter { get; set; }
            public SMAParamFilterAttribute(string filter) {
                this.Filter = filter;
            }
        }
"@

}

# We add a property to parameters to filter them out later. Required to properly do type-reformatting of string/boolean parameter value types.
if (-not ([System.Management.Automation.PSTypeName]'SMAPRestTypeAttribute').Type) {
    Add-Type -TypeDefinition @"
        using System;
        [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
        public class SMARestTypeAttribute : Attribute {
            public string RestType { get; set; }
            public SMARestTypeAttribute(string restType) {
                this.RestType = restType;
            }
        }
"@

}

# get module name and version
$mfp=($MyInvocation.MyCommand.path)
$Script:ModuleName=(([System.IO.Path]::GetFileNameWithoutExtension(($mfp))).ToUpper())
$mList=(Get-Module -Name $Script:ModuleName -ListAvailable); # get list of names of the module (more then one if diffrent versions)
$refPath=[System.IO.Path]::ChangeExtension($mfp,'psd1'); # get path of the module file
New-Variable -Name 'ModuleCfgVer' -Value 1 -Scope Script -Option Constant;
New-Variable -Name 'SMAPIPrefix' -Value 'SEPPmail' -Scope Script -Option Constant; # prefix for entries in vault
New-Variable -Name 'VaultName' -Value ($script:SMAPIPrefix) -Scope Script -Option Constant; # name of the vault the module using (it will be created if not exist)
New-Variable -Name 'SecureVaultModuleName' -Value 'Microsoft.PowerShell.SecretStore' -Scope Script -Option Constant; # name of the microsoft vault
New-Variable -Name 'SMAModuleCfgName' -Value ($script:SMAPIPrefix+'_ModuleCfg') -Scope Script -Option Constant;
New-Variable -Name 'ShowMsgIfNoCfgLoaded' -Value $true -Scope Script -Option Constant;
New-Variable -Name 'SMADefaultPort' -Value 8445 -Scope Script -Option Constant; # default port SeppMail appliance
New-Variable -Name 'cfgNamePrefix' -Value ($script:SMAPIPrefix+'Cfg_') -Scope Script -Option Constant; # prefix for config enties in vault
New-Variable -Name 'LoadCfgIfOnlyOneExist' -Value $true -Scope Script -Option Constant; # if only one config exist, and not default, load it on module start
New-Variable -Name 'DefaultAPIVer' -Value 'v1' -Scope Script -Option Constant; # version of the SeppMail appliance API
New-Variable -Name 'ShowIntConversionWarning' -Value $false -Scope Script -Option Constant; # set it only for development to TRUE
New-Variable -Name 'SuppressNativeTestError' -Value $false -Scope Script -Option Constant; # if set to TRUE the native error, in cmdlet Test-SMAConfiguration, from Get-SMAUser, will be suppressed

$script:activeCfg=@{
    SMACfgName='';
    SMACred=[System.Management.Automation.PSCredential]::empty;
    SMAHost='';
    SMAPort=$null;
    SMAPIVersion='';
    SMASkipCertCheck=$false;
}; # end activeCfg

foreach ($entry in $mList)
{
    if ($entry.path -eq $refPath)
    {
        $Script:ModuleVersion=($entry.version)
        break;
    }; # end if
}; # end foreach

#$vStr=(($Script:ModuleVersion).ToString()).Replace('.','_');
$vName='__' + $Script:ModuleName +'_ModuleData'; 
New-Variable -Name $vName -Value ([GetModuleData]::new()); # export object, needed for argument completer
Export-ModuleMember -Variable $vName;

#As some CmdLets get pretty long, we add aliases here.
Export-ModuleMember -Alias * -Function *

initEnumerator;
initModule;
# SIG # Begin signature block
# MIIVyAYJKoZIhvcNAQcCoIIVuTCCFbUCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC/ZoWJ1m8fWA6g
# 9Z3UoLWrvkNt2yF8DdoayNazuhcFHaCCEgQwggVvMIIEV6ADAgECAhBI/JO0YFWU
# jTanyYqJ1pQWMA0GCSqGSIb3DQEBDAUAMHsxCzAJBgNVBAYTAkdCMRswGQYDVQQI
# DBJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcMB1NhbGZvcmQxGjAYBgNVBAoM
# EUNvbW9kbyBDQSBMaW1pdGVkMSEwHwYDVQQDDBhBQUEgQ2VydGlmaWNhdGUgU2Vy
# dmljZXMwHhcNMjEwNTI1MDAwMDAwWhcNMjgxMjMxMjM1OTU5WjBWMQswCQYDVQQG
# EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMS0wKwYDVQQDEyRTZWN0aWdv
# IFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQCN55QSIgQkdC7/FiMCkoq2rjaFrEfUI5ErPtx94jGgUW+s
# hJHjUoq14pbe0IdjJImK/+8Skzt9u7aKvb0Ffyeba2XTpQxpsbxJOZrxbW6q5KCD
# J9qaDStQ6Utbs7hkNqR+Sj2pcaths3OzPAsM79szV+W+NDfjlxtd/R8SPYIDdub7
# P2bSlDFp+m2zNKzBenjcklDyZMeqLQSrw2rq4C+np9xu1+j/2iGrQL+57g2extme
# me/G3h+pDHazJyCh1rr9gOcB0u/rgimVcI3/uxXP/tEPNqIuTzKQdEZrRzUTdwUz
# T2MuuC3hv2WnBGsY2HH6zAjybYmZELGt2z4s5KoYsMYHAXVn3m3pY2MeNn9pib6q
# RT5uWl+PoVvLnTCGMOgDs0DGDQ84zWeoU4j6uDBl+m/H5x2xg3RpPqzEaDux5mcz
# mrYI4IAFSEDu9oJkRqj1c7AGlfJsZZ+/VVscnFcax3hGfHCqlBuCF6yH6bbJDoEc
# QNYWFyn8XJwYK+pF9e+91WdPKF4F7pBMeufG9ND8+s0+MkYTIDaKBOq3qgdGnA2T
# OglmmVhcKaO5DKYwODzQRjY1fJy67sPV+Qp2+n4FG0DKkjXp1XrRtX8ArqmQqsV/
# AZwQsRb8zG4Y3G9i/qZQp7h7uJ0VP/4gDHXIIloTlRmQAOka1cKG8eOO7F/05QID
# AQABo4IBEjCCAQ4wHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYD
# VR0OBBYEFDLrkpr/NZZILyhAQnAgNpFcF4XmMA4GA1UdDwEB/wQEAwIBhjAPBgNV
# HRMBAf8EBTADAQH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMBsGA1UdIAQUMBIwBgYE
# VR0gADAIBgZngQwBBAEwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybC5jb21v
# ZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNAYIKwYBBQUHAQEE
# KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21vZG9jYS5jb20wDQYJKoZI
# hvcNAQEMBQADggEBABK/oe+LdJqYRLhpRrWrJAoMpIpnuDqBv0WKfVIHqI0fTiGF
# OaNrXi0ghr8QuK55O1PNtPvYRL4G2VxjZ9RAFodEhnIq1jIV9RKDwvnhXRFAZ/ZC
# J3LFI+ICOBpMIOLbAffNRk8monxmwFE2tokCVMf8WPtsAO7+mKYulaEMUykfb9gZ
# pk+e96wJ6l2CxouvgKe9gUhShDHaMuwV5KZMPWw5c9QLhTkg4IUaaOGnSDip0TYl
# d8GNGRbFiExmfS9jzpjoad+sPKhdnckcW67Y8y90z7h+9teDnRGWYpquRRPaf9xH
# +9/DUp/mBlXpnYzyOmJRvOwkDynUWICE5EV7WtgwggYaMIIEAqADAgECAhBiHW0M
# UgGeO5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYD
# VQQKEw9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENv
# ZGUgU2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5
# NTlaMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzAp
# BgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0G
# CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjI
# ztNsfvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NV
# DgFigOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/3
# 6F09fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05Zw
# mRmTnAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm
# +qxp4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUe
# dyz8rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz4
# 4MPZ1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBM
# dlyh2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQY
# MBaAFDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritU
# pimqF6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNV
# HSUEDDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsG
# A1UdHwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1
# YmxpY0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsG
# AQUFBzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2Rl
# U2lnbmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0
# aWdvLmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURh
# w1aVcdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0Zd
# OaWTsyNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajj
# cw5+w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNc
# WbWDRF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalO
# hOfCipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJs
# zkyeiaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z7
# 6mKnzAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5J
# KdGvspbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHH
# j95Ejza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2
# Bev6SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/
# L9Uo2bC5a4CH2RwwggZvMIIE16ADAgECAhBIqMP3CCLHOHtOKuaWNyeFMA0GCSqG
# SIb3DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0
# ZWQxKzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYw
# HhcNMjYwNDE1MDAwMDAwWhcNMjcwNzE0MjM1OTU5WjBmMQswCQYDVQQGEwJERTEP
# MA0GA1UECAwGQmF5ZXJuMSIwIAYDVQQKDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBH
# bWJIMSIwIAYDVQQDDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJIMIICIjANBgkq
# hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAvAFzE8MbJpvQt+IdIh1M+bKYsJBFDk4b
# 9ySe25IrCi00B9o5XmQtIw42MqyIKbUq1tDARtp9KTQedEP9W+rflAF2l+0Z046J
# kiqumU9/enbqWLDyln1aS/p7HOgwZFMhnsR9zH0MfFckiklUmkzJO+vmzYAK7ZmD
# xajNLJs0gkGRU2/BecAx/TSvLXMaKONsKZCyMKQCnwo1mCY/tFl5EgUz7YQFrPOR
# BQGfQke/hkdBfQDqNRsi/J6+KhJWc6LvgQihdRg/INQbQsTxlow18NWvyFsjjueH
# 7kG6HR4YKfbv07xgrsIh8xvq9ZJ1SBhLXmkg4SdoQGASjqR6o3keAX+bDRFf+hml
# WWJp/FqVHR5QomF3vbK2/bbz4jAclYSPx/sPasNJ0YnKFkgmowZ7Ysa0KA0/egBg
# tI4gJ+8V7zrqIVEG3rMQh9KCdMnJqP2aM9o4gUzQvE1M4x606liX9EWwdLLS+fe7
# 9o+Fzo5oH4wBE/En6hQQkzseHHu+TXCDd6zUUZ/PlTK0gTaDIRXt6UzPNqJ4RiRC
# W2pNFcPt078qqVTuwKUXoE4ufxGgXKFrZlCYST/9eG1TnW2oq19nz8A333GCsL3g
# poNIKvfmDyGMMNzvx2aeqn2v6e75z8kH19iGSNZ51xT+WgS9F1aIvjz08/T7XAv7
# iDPF1/gPIp8CAwEAAaOCAakwggGlMB8GA1UdIwQYMBaAFA8qyyCHKLjsb0iuK1Sm
# KaoXpM0MMB0GA1UdDgQWBBS30/Tq+alF3j2BY5up8n5zpAU23DAOBgNVHQ8BAf8E
# BAMCB4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBKBgNVHSAE
# QzBBMDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3Rp
# Z28uY29tL0NQUzAIBgZngQwBBAEwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2Ny
# bC5zZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIzNi5jcmww
# eQYIKwYBBQUHAQEEbTBrMEQGCCsGAQUFBzAChjhodHRwOi8vY3J0LnNlY3RpZ28u
# Y29tL1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNydDAjBggrBgEFBQcw
# AYYXaHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETc3VwcG9ydEBz
# ZXBwbWFpbC5jaDANBgkqhkiG9w0BAQwFAAOCAYEAi7fmb5UYoemWG3CC4K2UZWVr
# R6GOfi8gbJKgjPbKO4zrCrU/x6cOdyp6scKZfUEGFDf8KH6pP4pAQv1Hsbi49gU2
# kxoUWLlCiipn05qJY663DHx9hlStej/ZdEatou0wyCDiG5xD7kmG+1t6iLyyCBgE
# B88tJpzTjI61qXmBTS/FGEOAsB4SDEW1ngA7bc5FOv4IUKA43hp8M+N3GeYFzDqw
# JELYEfVVYheBW3o7q4VrCdfFEuaQihOtvfDfYpP6ANgekNn8HdsMT8rx9D1I50Rl
# i/qQFo2BOuPyb2SIQPzJvCs5wgi5qgp1nHiN6igumu2Cz7BmGjOazGUgCSUY5Qwy
# E8+F+R2tVM+2O15rfX01+e56ZfojBEiEjMwfPHs3fa3V3gokWWNwUMkton/v0R/n
# l2zjmOr2okohOINZEDh9frg21zUCN5ZD8Y4zQWuiJLCvvvBZs0JR4c9xl2k2wtw/
# QLPhGU69zM3smGpRoLE8M6zvUvSU7jXjvefazUniMYIDGjCCAxYCAQEwaDBUMQsw
# CQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJT
# ZWN0aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2AhBIqMP3CCLHOHtOKuaW
# NyeFMA0GCWCGSAFlAwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAw
# GQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisG
# AQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIOw7EbiDl4pyO/mm3/OHSeW8Mv2H/yvv
# Qym4QvNiZ6FBMA0GCSqGSIb3DQEBAQUABIICAJjmTsj14SnzI4QXMk7nztYtfKvD
# Ny6LiglqGaZxDj+N+WssT2zNSHOwooMtpFiI+mWMEWZgTeCZPNKrPUrKf3FeHQ9Q
# cTcmQj/DY2Zf/yit3mmuEEmtkKtR7PrUzZcwQSGY2qZhuy3/rllbsk1XyrlwxRuN
# dkIoJ6FAf9Buy0s6y9P5WjYTMYRKfU/U8siPzNhmRWWqhpn0u5N+gs4IWXBQQLmT
# VSbewecKc4DQMAZiWmwYJXcRmq1UakMLA1Vg0rVKmq1r/R/nerxhUBYMwyiYqWXe
# B+BYNtxDJQRg14hwEkLqM9VZQA/cmxbrJe88GXGX+Z77PTUGPxLjZm9AxBcT8xCt
# Tzmjh0hpNpoJDbyP6Sd+0wtzz+dpKWyfVo66ZD81nQKZhx2RpLsP8rP9knHFeqzN
# w3mM+kCYcdOzCvQVBTWrl6jVC/X+YNJVmkmseivfduQQi6ONUMBdjUuCu2JRRx3m
# 5iE2Mu6tvtH+IU3Df66xiIVZmSfg8zvYiDTTleYGXsFTRG6feCuw80kOTGLe48Do
# 8wYnd7IwmW3weJXPZO7WchwfhNzjCkz8VKFMZeDKhtSGWLhGaRD0sWEDmIJRjDLI
# L7OlYjtAX+uzHdacpJP+Ea45nkn472rhul1fGP5FJ7nnej8kmka9/cavjCkVGHXs
# E4kSWutN5KlQt49/
# SIG # End signature block