SEPPmailAPI

1.0.5

Public/SEPPmailAPI-Info.ps1

                                <#

.SYNOPSIS

    Gets Information about encryption possibilities of a domain od a user

.DESCRIPTION

    This CmdLet emits information about what encryption options an recipient address may have. There are 3 parameter sets 

    on how you can use the CmdLet. 

.EXAMPLE

    PS C:\> Get-SMAEncInfo

    With this CmdLet you get information about the encryption options you have for all users.

    Be careful, as this returns all options for all users

.EXAMPLE

    PS C:\> Get-SMAEncInfo -email 'john.doe@domain.com'

    This provides te same information as without parameters, just filters to one specific user

.EXAMPLE

    PS C:\> Get-SMAEncInfo -email 'john.doe@domain.com' -Mode smime

    Filter to a specific user and a specific encryption mode    

.EXAMPLE

    PS C:\> Get-SMAEncInfo -email 'john.doe@domain.com' -Range domain -Mode smime

    Filter to a specific user for domain encryption and and a specific encryption mode (smime)

.EXAMPLE

    PS C:\> Get-SMAEncInfo -Mode hin

    Filter to a hin encryption only

.EXAMPLE

    PS C:\> Get-SMAEncInfo -Mode pgp -Range domain

    Filter to a pgp encryption only and focis on domains

#>

function Get-SMAEncInfo

{

    [CmdletBinding()]

    param (

        #region email param for all 3 Parametersets

        [Parameter(

            ParameterSetName = 'Plain',

                   Mandatory = $false,

                 HelpMessage = 'Filter to a specific e-mail address'

        )]

        [Parameter(

            ParameterSetName = 'Mode',

                   Mandatory = $false,

                 HelpMessage = 'Filter to a specific e-mail address'

        )]

        [Parameter(

            ParameterSetName = 'Range',

                   Mandatory = $false,

                 HelpMessage = 'Filter to a specific e-mail address'

        )]

        [Alias('eMailAddress')]

        [String]$eMail,

        #region Mode parameter for 2 parameter sets

        [Parameter(

            ParameterSetName = 'Mode',

            Mandatory = $true,

                 HelpMessage = 'Filter to a specific encryption mode'

        )]

        [Parameter(

            ParameterSetName = 'Range',

                   Mandatory = $true,

                 HelpMessage = 'Filter to a specific encryption range'

        )]

        [ValidateSet('smime','pgp', 'hin', 'tls','webmail')]

        [Alias('encMode','encryptionMode')]

        [String]$Mode,

        #endregion

        #region ParamSet Range

        [Parameter(

            ParameterSetName = 'Range',

                   Mandatory = $true,

                 HelpMessage = 'Filter to a specific encryption range'

        )]

        [ValidateSet('domain','personal')]

        [Alias('encRange','encryptionRange')]

        [String]$Range,

        #endregion

        #region Config parameters block

        [Parameter(Mandatory = $false)]

        [String]$host = $Script:activeCfg.SMAHost,

        [Parameter(Mandatory = $false)]

        [int]$port = $Script:activeCfg.SMAPort,

        [Parameter(Mandatory = $false)]

        [String]$version = $Script:activeCfg.SMAPIVersion,

        [Parameter(

            Mandatory=$false

            )]

            [System.Management.Automation.PSCredential]$cred=$Script:activeCfg.SMACred,

            [Parameter(

                Mandatory=$false

                )]

            [switch]$SkipCertCheck=$Script:activeCfg.SMAskipCertCheck

        #endregion

    )

    begin {

        if (! (verifyVars -VarList $Script:requiredVarList))

        {

            Throw($missingVarsMessage);

        }; # end if

        try {

            if ($psCmdlet.ParameterSetName -eq 'Plain') {

                Write-Verbose "Creating URL path"

                $uriPath = "{0}/{1}" -f 'info', 'encryption'

            }

            if ($psCmdlet.ParameterSetName -eq 'Mode') {

                Write-Verbose "Creating URL path"

                $uriPath = "{0}/{1}/{2}" -f 'info', 'encryption', $Mode

            }

            if ($psCmdlet.ParameterSetName -eq 'Range') {

                Write-Verbose "Creating URL path"

                $uriPath = "{0}/{1}/{2}/{3}" -f 'info', 'encryption', $Mode, $Range

            }

        }

        catch {

            Write-Error "Error$.categoryInfo happened setting REST-Path variables "

        }

    }

    process {

        try {

            Write-Verbose "Building full request uri"

            $smaParams=@{

                Host=$Host

                Port=$Port

                Version=$Version

            } # end smaParams

            $uri = $null

            if ($email) {

                $boundParam = @{

                    email = $email

                }

                $uri = New-SMAQueryString -uriPath $uriPath -qParam $boundParam @smaParams

            }

            else {

                $uri = New-SMAQueryString -uriPath $uriPath @smaParams

            }

            Write-verbose "Crafting Invokeparam for Invoke-SMARestMethod"

            $invokeParam = @{

                Uri         = $uri 

                Method      = 'GET'

                Cred        =  $cred

                SkipCertCheck = $SkipCertCheck

            }

            Write-Verbose "Replace wrong '%40' value with '@'"

            $invokeparam.Uri = ($invokeParam.Uri).Replace('%40','@')

            Write-Verbose "Call Invoke-SMARestMethod $uri" 

            $encInfo = Invoke-SMARestMethod @invokeParam

            #Write-Verbose 'Converting Umlauts from ISO-8859-1'

            #Encinfo = ConvertFrom-SMAPIFormat -inputObject $encInfoRaw

            # Userobject

            if ($encInfo) {

                return $encInfo

            }

            else {

                Write-Information 'Nothing to return'

            }

        }

        catch {

            Write-Error "An error occured, see $error"

        }

    }

    end {

    }

}

# SIG # Begin signature block

# MIIL1wYJKoZIhvcNAQcCoIILyDCCC8QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUaMg1RSW+/Win2W7ZqIDprEfC

# bQmggglAMIIEmTCCA4GgAwIBAgIQcaC3NpXdsa/COyuaGO5UyzANBgkqhkiG9w0B

# AQsFADCBqTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYG

# A1UECxMfQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMv

# KGMpIDIwMDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkx

# HzAdBgNVBAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwHhcNMTMxMjEwMDAwMDAw

# WhcNMjMxMjA5MjM1OTU5WjBMMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMdGhhd3Rl

# LCBJbmMuMSYwJAYDVQQDEx10aGF3dGUgU0hBMjU2IENvZGUgU2lnbmluZyBDQTCC

# ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJtVAkwXBenQZsP8KK3TwP7v

# 4Ol+1B72qhuRRv31Fu2YB1P6uocbfZ4fASerudJnyrcQJVP0476bkLjtI1xC72Ql

# WOWIIhq+9ceu9b6KsRERkxoiqXRpwXS2aIengzD5ZPGx4zg+9NbB/BL+c1cXNVeK

# 3VCNA/hmzcp2gxPI1w5xHeRjyboX+NG55IjSLCjIISANQbcL4i/CgOaIe1Nsw0Rj

# gX9oR4wrKs9b9IxJYbpphf1rAHgFJmkTMIA4TvFaVcnFUNaqOIlHQ1z+TXOlScWT

# af53lpqv84wOV7oz2Q7GQtMDd8S7Oa2R+fP3llw6ZKbtJ1fB6EDzU/K+KTT+X/kC

# AwEAAaOCARcwggETMC8GCCsGAQUFBwEBBCMwITAfBggrBgEFBQcwAYYTaHR0cDov

# L3QyLnN5bWNiLmNvbTASBgNVHRMBAf8ECDAGAQH/AgEAMDIGA1UdHwQrMCkwJ6Al

# oCOGIWh0dHA6Ly90MS5zeW1jYi5jb20vVGhhd3RlUENBLmNybDAdBgNVHSUEFjAU

# BggrBgEFBQcDAgYIKwYBBQUHAwMwDgYDVR0PAQH/BAQDAgEGMCkGA1UdEQQiMCCk

# HjAcMRowGAYDVQQDExFTeW1hbnRlY1BLSS0xLTU2ODAdBgNVHQ4EFgQUV4abVLi+

# pimK5PbC4hMYiYXN3LcwHwYDVR0jBBgwFoAUe1tFz6/Oy3r9MZIaarbzRutXSFAw

# DQYJKoZIhvcNAQELBQADggEBACQ79degNhPHQ/7wCYdo0ZgxbhLkPx4flntrTB6H

# novFbKOxDHtQktWBnLGPLCm37vmRBbmOQfEs9tBZLZjgueqAAUdAlbg9nQO9ebs1

# tq2cTCf2Z0UQycW8h05Ve9KHu93cMO/G1GzMmTVtHOBg081ojylZS4mWCEbJjvx1

# T8XcCcxOJ4tEzQe8rATgtTOlh5/03XMMkeoSgW/jdfAetZNsRBfVPpfJvQcsVncf

# hd1G6L/eLIGUo/flt6fBN591ylV3TV42KcqF2EVBcld1wHlb+jQQBm1kIEK3Osgf

# HUZkAl/GR77wxDooVNr2Hk+aohlDpG9J+PxeQiAohItHIG4wggSfMIIDh6ADAgEC

# AhBdMTrn+ZR0fTH9F/xerQI2MA0GCSqGSIb3DQEBCwUAMEwxCzAJBgNVBAYTAlVT

# MRUwEwYDVQQKEwx0aGF3dGUsIEluYy4xJjAkBgNVBAMTHXRoYXd0ZSBTSEEyNTYg

# Q29kZSBTaWduaW5nIENBMB4XDTIwMDMxNjAwMDAwMFoXDTIzMDMxNjIzNTk1OVow

# XTELMAkGA1UEBhMCQ0gxDzANBgNVBAgMBkFhcmdhdTERMA8GA1UEBwwITmV1ZW5o

# b2YxFDASBgNVBAoMC1NFUFBtYWlsIEFHMRQwEgYDVQQDDAtTRVBQbWFpbCBBRzCC

# ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKE54Nn5Vr8YcEcTv5k0vFyW

# 26kzBt9Pe2UcawfjnyqvYpWeCuOXxy9XXif24RNuBROEc3eqV4EHbA9v+cOrE1me

# 4HTct7byRM0AQCzobeFAyei3eyeDbvb963pUD+XrluCQS+L80n8yCmcOwB+weX+Y

# j2CY7s3HZfbArzTxBHo5AKEDp9XxyoCc/tUQOq6vy+wdbOOfLhrNMkDDCsBWSLqi

# jx3t1E+frAYF7tXaO5/FEGTeb/OjXqOpoooNL38FmCJh0CKby090sBJP5wSienn1

# NdhmBOKRL+0K3bomozoYmQscpT5AfWo4pFQm+8bG4QdNaT8AV4AHPb4zf23bxWUC

# AwEAAaOCAWowggFmMAkGA1UdEwQCMAAwHwYDVR0jBBgwFoAUV4abVLi+pimK5PbC

# 4hMYiYXN3LcwHQYDVR0OBBYEFPKf1Ta/8vAMTng2ZeBzXX5uhp8jMCsGA1UdHwQk

# MCIwIKAeoByGGmh0dHA6Ly90bC5zeW1jYi5jb20vdGwuY3JsMA4GA1UdDwEB/wQE

# AwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzBuBgNVHSAEZzBlMGMGBmeBDAEEATBZ

# MCYGCCsGAQUFBwIBFhpodHRwczovL3d3dy50aGF3dGUuY29tL2NwczAvBggrBgEF

# BQcCAjAjDCFodHRwczovL3d3dy50aGF3dGUuY29tL3JlcG9zaXRvcnkwVwYIKwYB

# BQUHAQEESzBJMB8GCCsGAQUFBzABhhNodHRwOi8vdGwuc3ltY2QuY29tMCYGCCsG

# AQUFBzAChhpodHRwOi8vdGwuc3ltY2IuY29tL3RsLmNydDANBgkqhkiG9w0BAQsF

# AAOCAQEAdszNU8RMB6w9ylqyXG3EjWnvii7aigN0/8BNwZIeqLP9aVrHhDEIqz0R

# u+KJG729SgrtLgc7OenqubaDLiLp7YICAsZBUae3a+MS7ifgVLuDKBSdsMEH+oRu

# N1iGMfnAhykg0P5ltdRlNfDvQlIFiqGCcRaaGVC3fqo/pbPttbW37osyIxTgmB4h

# EWs1jo8uDEHxw5qyBw/3CGkBhf5GNc9mUOHeEBMnzOesmlq7h9R2Q5FaPH74G9FX

# xAG2z/rCA7Cwcww1Qgb1k+3d+FGvUmVGxJE45d2rVj1+alNc+ZcB9Ya9+8jhMssM

# LjhJ1BfzUWeWdZqRGNsfFj+aZskwxjGCAgEwggH9AgEBMGAwTDELMAkGA1UEBhMC

# VVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEmMCQGA1UEAxMddGhhd3RlIFNIQTI1

# NiBDb2RlIFNpZ25pbmcgQ0ECEF0xOuf5lHR9Mf0X/F6tAjYwCQYFKw4DAhoFAKB4

# MBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQB

# gjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkE

# MRYEFANgd3xsEAarbDEAf3xw5tEs2XC6MA0GCSqGSIb3DQEBAQUABIIBACsFa2lU

# 80TtllBO1dmGS+FKuaul23itsQTGTdu/qvzPFhQHz4hOhIPxcST0qxfsluj9WS9B

# u+CW5lCrFQMszRN2ak9jvepO1vciNkNLvdEZvPOTUNKOxAWx64k2B8ULXFNmRRR6

# lHjUfdAPHpJ/JExulCjL8EzEeXas21+eDq7fZWeirP9aMcqY0p2PxnVH6G94EcwL

# N00Q+HdyDwx6kBW0mbsvZzkM5JB0jlaT5pjRgIj0GYq81ivR9Psk20fAB0/7mMIa

# yTlFh34t2aI+Asbv7DciJYzPm8SAZ6Cfp64GW9Bjq9msU90trdSant0+YBl3HaD+

# QdrsB0+7sW0xNqQ=

# SIG # End signature block