Greyhound.psm1

<##############################################################
                    helper functions
##############################################################>



function Get-MySqlVersion {
    [CmdletBinding()]
    param (
        [String]$MySqlServiceName='MySql'
    )
    try {
        $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq $MySqlServiceName
        if ($MySqlService) {
            [string]$MySqldExePath = $MySqlService.PathName -replace '^"?(.*mysqld).*', '$1.exe'   
            if ($MySqldExePath) {
                $MySqldExe = Get-Item -Path $MySqldExePath -ErrorAction Stop
            } else {
                Throw "Der MySqld-Pfad konnte nicht ermittelt werden"
            }           
        }
        $MySqldExe.VersionInfo
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Ermittlung der MySQL-Version aufgetreten: $($_.Exception.Message)" 
    }
}



function Get-MySqlBasedir {
    [CmdletBinding()]
    param (
        [String]$MySqlServiceName='MySql'
    )
    try {
        $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq $MySqlServiceName
        if ($MySqlService) {
            [string]$MySqlBaseDir = $MySqlService.PathName -replace '^"?(.*)\\bin\\.*exe.*', "`$1"
        }
        $MySqlBaseDir
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Ermittlung des MySQL-Installationspfades aufgetreten: $($_.Exception.Message)" 
    }
}



function Get-MySqlMyIni {
    [CmdletBinding()]
    param (
        [String]$MySqlServiceName='MySql'
    )
    try {
        $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq $MySqlServiceName
        if ($MySqlService) {
            [string]$MySqlMyIni = $MySqlService.PathName -replace '.*--defaults-file=(.*\.ini).*', "`$1"
        }
        $MySqlMyIni
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Ermittlung des MySQL-Ini-Pfades aufgetreten: $($_.Exception.Message)" 
    }
}



function Get-MySqlDatadir {
    [CmdletBinding()]
    param (
        [String]$MySqlServiceName='MySql'
    )
    try {
        $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq $MySqlServiceName
        if ($MySqlService) {
            [string]$MySqlMyIni = $MySqlService.PathName -replace '.*--defaults-file=(.*\.ini).*', "`$1"
        }
        $Value = 'datadir'
        $MySqlDatadir = (((Get-Content $MySqlMyIni | Select-String -Pattern "$Value=") -replace '[\r\n]') -replace "$Value=") -replace "/", "\"
        $MySqlDatadir
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Ermittlung des MySQL-Data-Pfades aufgetreten: $($_.Exception.Message)"
    }
}



function Get-MySqlVariables {
    [CmdletBinding()]
    param (
        [string]$VariableName,
        [string]$MySqlServiceName='MySql',
        [string]$MySqlHostname='localhost',
        [string]$MySqlUser='root',
        [string]$MySqlPass=''
    )
    try {
        Clear-Variable MySqlVariables -ErrorAction SilentlyContinue
        $QueryResult = (Invoke-MySqlQuery -MySqlQuery "SHOW VARIABLES" -MySqlUser $MySqlUser -MySqlPass $MySqlPass) -replace '\t', '='
        if ($QueryResult) {
            $QueryResult | ForEach-Object {
                $MySqlVariables += ConvertFrom-StringData -StringData ($_ -replace '[\r\n]')
            }
        }
        
        if ($VariableName) {
            $MySqlVariables.$VariableName
        } else {
            $MySqlVariables
        }
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Abfrage der MySql-Variablen aufgetreten: $($_.Exception.Message)"
    }
}



function Get-GreyhoundInstallPath {
    try {
        1 / (1-1)
        $GreyhoundInstallPath = (Get-ItemProperty -Path 'HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Greyhound' -Name InstallLocation -ErrorAction SilentlyContinue).InstallLocation
        if (($GreyhoundInstallPath) -and (Test-Path $GreyhoundInstallPath)) {
            $GreyhoundInstallPath
        } else {
            return $null
        }
    }
    catch {
        Write-Error "Es ist ein Fehler bei der Ermittlung des GREYHOUND Installationspfades aufgetreten: $($_.Exception.Message)"
    }
}



<#
.SYNOPSIS
    Ermittelt die Version der GREYHOUND-Installation
.DESCRIPTION
    Ermittelt die Version der GREYHOUND-Installation
.EXAMPLE
    Example of how to use this cmdlet
#>

function Get-GreyhoundVersionInfo {
    try {
        $GreyhoundServerExe = (Get-GreyhoundInstallPath) + 'Server\GreyhoundServer.exe'
        if (Test-Path -Path $GreyhoundServerExe) {
            $Version = (Get-Item $GreyhoundServerExe).VersionInfo.ProductVersionRaw
            $Version
        } else {
            Write-Error "GREYHOUND ist nicht installiert." -Category ObjectNotFound
            Break
        }   
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Invoke-GreyhoundAdmin {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false)]
        [Switch]$Start,
        [Switch]$Stop
    )
   
    try {
        $GreyhoundAdmin = (Get-GreyhoundInstallPath) + 'Server\GreyhoundAdmin.exe'
        if (!(Test-Path $GreyhoundAdmin)) {
            Throw "Der GREYHOUND Admin wurde nicht gefunden."
        }

        if ($Start) {
            if ((Start-Process -FilePath "$GreyhoundAdmin" -ArgumentList "-Start -NoGui" -Wait -NoNewWindow -PassThru).Exitcode -gt 0) {
                Throw "Der GREYHOUND Admin hat einen ExitCode ausgegeben"
            }
        } elseif ($Stop) {
            if ((Start-Process -FilePath "$GreyhoundAdmin" -ArgumentList "-Stop -NoGui" -Wait -NoNewWindow -PassThru).Exitcode -gt 0) {
                Throw "Der GREYHOUND Admin hat einen ExitCode ausgegeben"
            }
        }

    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Restart-GreyhoundServer {
    try {
        Invoke-GreyhoundAdmin -Stop
        Invoke-GreyhoundAdmin -Start           
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Get-GreyhoundSystemPassword {
    try {
        $GreyhoundServerIni = (Get-GreyhoundInstallPath) + 'Server\GreyhoundServer.ini'
        if (Test-Path $GreyhoundServerIni) {
            $GreyhoundSystemPassword = (Get-Content $GreyhoundServerIni | Select-String -Pattern 'SystemPassword' -SimpleMatch | ConvertFrom-StringData).SystemPassword
            $GreyhoundSystemPassword
        } else {
            Write-Verbose "Die GREYHOUND Serverkonfiguration `"$GreyhoundServerIni`" wurde nicht gefunden."
        }           
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



<#
.SYNOPSIS
    Zeigt die Einstellungen des GREYHOUND-Servers an
.DESCRIPTION
    Ohne Parameter liefert dieses Cmdlet alle Werte der GreyhoundServer.ini. Wird nur ein bestimmter Wert benötigt, so kann dieser explizit ueber den Key angegeben werden.
#>

function Get-GreyhoundServerIniValue {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false)]
        [String]$Key,
        [Parameter(ParameterSetName='MySQL')]
        [String]$Compression,
        [ValidateSet('MySQL', 'Global', 'LogFile', 'HtmlInline', 'IndexServer', 'AppServer', 'QueueServer',
            'AntiSpam', 'OCR', 'AccessServer', 'DataExchangeServer', 'SyncServer', 'AddOnServer', 'ItemCount',
            'CommServer', 'AutoClassificationServer')][String]$Section
    )

    try {
        $GreyhoundServerIni = (Get-GreyhoundInstallPath) + 'Server\GreyhoundServer.ini'
        if (Test-Path $GreyhoundServerIni) {
            if (!$Key) {
                $Result = Get-Content $GreyhoundServerIni
            } else {
                $Result = (Get-Content $GreyhoundServerIni | Select-String "^$Key=" | ConvertFrom-StringData).$Key
            }
            $Result
        } else {
            Write-Verbose "Die GREYHOUND Serverkonfiguration `"$GreyhoundServerIni`" wurde nicht gefunden."
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Get-GreyhoundSetup {
    [CmdletBinding()]
    [Alias("Get-GreyhoundServerSetup", "Get-MariaDBSetup")]
    param (
        [string]$DownloadDir=$PWD.Path,
        [string]$BaseUrl = 'https://greyhound-software.com/files/greyhound',
        [ValidateSet('GreyhoundSetup', 'GreyhoundAspSetup', 'MariaDBSetup')]
        [string]$Type = 'GreyhoundSetup',
        [ValidateSet('Stable', 'Beta', 'Test')]
        [string]$Edition = 'Stable',
        # the following two switches are deprecated. Use "Edition" parameter instead.
        [switch]$Beta,
        [switch]$Test
    )

    if ($Beta) {
        $Edition = "Beta"
    } elseif ($Test) {
        $Edition = "Test"
    }

    try {
        switch -Wildcard ($Type) {
            'Greyhound*' {
                switch ($Edition) {
                    'Stable' {$SetupName = "${Type}.exe"}
                    'Beta' {$SetupName = "${Type}Beta.exe"}
                    'Test' {$SetupName = "${Type}Test.exe"}    
                }
            }
            'MariaDBSetup' {
                $SetupName = "${Type}.msi"
            }
        }
    
        $RemoteFile = "$BaseUrl/$SetupName"
        $LocalFile = $DownloadDir.TrimEnd('\') + '\' + $SetupName
    
        if (Test-Path $LocalFile) {
            [Int64]$RemoteFileSize = (Invoke-WebRequest -Uri $RemoteFile -Method Head -UseBasicParsing).Headers.'Content-Length'
            [Int64]$LocalFileSize = (Get-Item $LocalFile).Length

            Write-Verbose "LocalFileSize: $LocalFileSize RemoteFileSize: $RemoteFileSize"
   
            if ($RemoteFileSize -gt 0 -and $LocalFileSize -gt 0) {
                if ($RemoteFileSize -ne $LocalFileSize) {
                    Start-BitsTransfer -Source $RemoteFile -Destination $LocalFile -Description "Downloading $RemoteFile"
                } else {
                    Write-Verbose "Die Datei `"$SetupName`" mit einer Dateigroesse von $RemoteFileSize Bytes existiert bereits."
                }
            } else {
                Throw "Es ist ein Fehler beim Dateigroessenvergleich aufgetreten."
            }
        } else {
            Start-BitsTransfer -Source $RemoteFile -Destination $LocalFile -Description "Downloading $RemoteFile"
        }
    
        if (Test-Path $LocalFile) {
            $LocalFile
        } else {
            Throw "Es ist ein Fehler beim Herunterladen der Datei '$RemoteFile' aufgetreten."
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Get-WindowsServerFiles {
    [CmdletBinding()]
    param (
        [string]$DownloadDir=$env:TEMP,
        [string]$BaseUrl = 'https://greyhound-software.com/files/greyhound/tools',
        [string]$FileListUrl = "$BaseUrl/WindowsServerSetup.txt"
    )

    try {
        $DownloadDir = $DownloadDir.TrimEnd('\')
        if (!(Test-Path -Path $DownloadDir -PathType Container)) {
            Throw "Das Downloadverzeichnis `"$DownloadDir`" existiert nicht."
        }
        try {
            $WindowsSetupFiles = (Invoke-WebRequest -URI "$FileListUrl").Content -split "`r`n|`n" | ConvertFrom-String -Delimiter '=' -PropertyNames 'Type', 'Source'
            
            if (!($WindowsSetupFiles)) {
                Throw "Die Liste der herunterzuladenden Dateien existiert nicht oder ist leer."
            }

            Write-Verbose "Die Dateiliste wird erstellt..."
            for ($i=0; $i -le $WindowsSetupFiles.Length -1; $i++) {
                $FilenameWithoutPath = ''
                
                if ($WindowsSetupFiles[$i].Source.Length -gt 0 -and $WindowsSetupFiles[$i].Source.LastIndexOf('/') -gt 0) {
                    $FilenameWithoutPath = $WindowsSetupFiles[$i].Source.Substring($WindowsSetupFiles[$i].Source.LastIndexOf('/') + 1)
                } elseif ($WindowsSetupFiles[$i].Source.Length -gt 0 -and $WindowsSetupFiles[$i].Source.LastIndexOf('/') -eq 0) {
                    $FilenameWithoutPath = $WindowsSetupFiles[$i].Source
                }

                if ($FilenameWithoutPath) {
                    $WindowsSetupFiles[$i] | Add-Member -NotePropertyName 'Destination' -NotePropertyValue "$DownloadDir\$FilenameWithoutPath"
                    if (Test-Path $WindowsSetupFiles[$i].Destination) {
                        # file already exists, check filesize
                        [Int64]$RemoteFileSize = (Invoke-WebRequest -Uri $WindowsSetupFiles[$i].Source -Method Head -UseBasicParsing).Headers.'Content-Length'
                        [Int64]$LocalFileSize = (Get-Item "$DownloadDir\$FilenameWithoutPath").Length
            
                        Write-Verbose "LocalFileSize: $LocalFileSize RemoteFileSize: $RemoteFileSize"

                        if ($RemoteFileSize -gt 0 -and $LocalFileSize -gt 0) {
                            if ($RemoteFileSize -ne $LocalFileSize) {
                                $WindowsSetupFiles[$i] | Add-Member -NotePropertyName 'Download' -NotePropertyValue $true
                            } else {
                                Write-Verbose "Die Datei `"$DownloadDir\$FilenameWithoutPath`" mit einer Dateigroesse von $RemoteFileSize Bytes existiert bereits und wird aus der Downloadliste ausgenommen."
                            }
                        } else {
                            Throw "Es ist ein Fehler beim Dateigroessenvergleich aufgetreten."
                        }
                    } else {
                        # file doesn't exist, add to list
                        $WindowsSetupFiles[$i] | Add-Member -NotePropertyName 'Download' -NotePropertyValue $true
                    }
                }
            }

            if ($WindowsSetupFiles | Where-Object Download -eq $true) {
                Write-Verbose "Der Download der Dateien wird gestartet..."
                Start-BitsTransfer -Source ($WindowsSetupFiles | Where-Object Download -eq $true).Source -Destination ($WindowsSetupFiles | Where-Object Download -eq $true).Destination -Description "Downloading Files"
            }

            $WindowsSetupFiles | Select-Object Type, Source, Destination
        }
        catch {
            Write-Error "Es ist ein Fehler bei der Erstellung der Downloadliste aufgetreten: $($PSItem.ToString())"
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function New-GreyhoundVhdx (
    [PSCustomObject]$WindowsSetupFiles,
    [string]$VhdPath=$PWD.Path + '\GHSRV_C.vhdx',
    [string]$Edition=1,
    [string]$DiskLayout='UEFI',
    [switch]$DeleteSource,
    [Int64]$SizeBytes=128GB
    ) {

    Write-Host Debug $WindowsSetupFiles
    
    $VhdParams = @{
        SourcePath = ($WindowsSetupFiles | Where-Object Type -eq 'Iso').Destination
        UnattendPath = ($WindowsSetupFiles | Where-Object Type -eq 'Xml').Destination
        VhdPath = $VhdPath
        Edition = $Edition
        DiskLayout = $DiskLayout
    }

    try {
        if (Test-Path $VhdParams.VhdPath) {
            Throw "Die Datei `"$VhdParams`" exisitiert bereits."
        }

        Convert-WindowsImage -SourcePath $VhdParams.SourcePath -DiskLayout $VhdParams.DiskLayout -VhdPath $VhdParams.VhdPath -Edition $VhdParams.Edition -UnattendPath $VhdParams.UnattendPath | Out-Null
        if ($DeleteSource) {
            Remove-Item $SourcePath, $UnattendPath
        }

        if (Test-Path $VhdParams.VhdPath) {
            $VhdParams.VhdPath
        } else {
            Throw "Es ist ein Fehler bei der Konvertierung der ISO-Datei in VHDx-Datei aufgetreten."
        }
    }
    catch {
        Write-Error $($PSItem.ToString()) -Category ObjectNotFound
    }
}



<#
.SYNOPSIS
    Erstellt eine neue VM fuer die Einrichtung einer neuen GREYHOUND Installation
.DESCRIPTION
    Erstellt eine neue VM fuer die Einrichtung einer neuen GREYHOUND Installation. Dabei wird der erste verfügbare VMSwitch vom Typ "Extern" verwendet. Optional kann eine bereits bestehende VHD angegeben werden. Fehlt dieser Angabe, dann wird eine neue VHD erzeugt.
    Nach der Erstellung werden die Daten der VM in ein eigenes Verzeichnis unterhalb des Standard-Pfades des VMHost verschoben, sodass alle Dateien beisammen sind.
#>

function New-GreyhoundVM {
    [CmdletBinding()]
    Param (
        # Just some help
        [Parameter(Mandatory=$true)]
        [String]$VmName,
        [Parameter(Mandatory=$false, ValueFromPipeline=$true)]
        [String]$VhdPath,
        [String]$VmNotes,
        [String]$VmSwitchName=(Get-VMSwitch | Where-Object {$_.SwitchType -eq 'External' -and `
            (Get-NetAdapter -InterfaceDescription $_.NetAdapterInterfaceDescription | Where-Object Status -eq 'Up')}).Name,
        [Int64]$VmVHDSize=64GB,
        [String]$VmBasePath= (Get-VMHost).VirtualMachinePath + '\' + $VmName,
        [Int]$VmGeneration=2,
        [Int]$VMProcessorCount=4,
        [Int64]$VmMemoryStartupBytes=8GB,
        [Int64]$VmMemoryMinimumBytes=8GB,
        [Int64]$VMMemoryMaximumBytes=8GB,
        [string]$DiskLayout='UEFI',
        [ValidateSet('Windows Server 2019 Standard Core', 'Windows Server 2019 Standard Gui', 'Windows Server 2019 Datacenter Core', 'Windows Server 2019 Datacenter Gui')][String]$WindowsEdition='Windows Server 2019 Standard Core'
    )

    try {
        if (!($VmSwitchName)) {
            Throw "Es wurde kein aktiver, externer, virtueller Switch gefunden."
        }

        if (!($VhdPath)) {
            Write-Verbose "Eine neue VHD auf Basis von $WindowsEdition wird erstellt..."
            switch ($WindowsEdition) {
                'Windows Server 2019 Standard Core' {$Edition = '1'}   
                'Windows Server 2019 Standard Gui' {$Edition = '2'}
                'Windows Server 2019 Datacenter Core' {$Edition = '3'}
                'Windows Server 2019 Datacenter Gui' {$Edition = '4'}
            }
            $VhdPath = New-GreyhoundVhdx(Get-WindowsServerFiles) -Edition $Edition -SizeBytes $VmVHDSize -DiskLayout $DiskLayout
        }
        
        if (Test-Path $VHDPath) {
            Write-Verbose "Eine neue VM wird erstellt..."
            New-VM -Name $VmName -Generation $VmGeneration -SwitchName $VmSwitchName -VHDPath $VHDPath |
                Set-VM -ProcessorCount $VMProcessorCount -DynamicMemory -MemoryStartupBytes $VmMemoryStartupBytes -MemoryMinimumBytes $VmMemoryMinimumBytes -MemoryMaximumBytes $VMMemoryMaximumBytes -Notes $VmNotes -Passthru |
                Move-VMStorage -DestinationStoragePath $VmBasePath
            Get-VM -Name $VmName
        } else {
            Throw "Der Pfad zur VHD-Datei ist ungueltig."
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



<#
.SYNOPSIS
    Installiert MariaDB in einer Silent-Installation
.DESCRIPTION
    Installiert MariaDB in einer Silent-Installation. Die Setupdatei kann auch via Pipeline in Kombination mit Get-MariaDBSetup verwendet werden.
.EXAMPLE
    Get-MariaDBSetup | Install-MariaDBSetup -Password 'MyRootPassword'
#>

function Install-MariaDB {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true,
        ValueFromPipeline=$true)]
        [String]$SetupFile,
        [Parameter(Mandatory=$false)]
        [String]$ServiceName='MySql',
        [Switch]$AllowRemoteRootAccess,
        [Boolean]$SkipNetworking,
        [String]$Password,
        [Switch]$NoServiceInstall
    )

    $SetupFile = Resolve-Path($SetupFile)
    if (!(Test-Path -Path $SetupFile)) {
        Write-Error "Die Datei '$SetupFile' wurde nicht gefunden." -Category ObjectNotFound
        Break
    }

    $Command = (Get-Command 'msiexec').Path
    $Arguments = @(
        "/package",
        "`"$SetupFile`"",
        "/qn"
    )

    if ($Password) {
        $Arguments += @("PASSWORD=$Password")
    }

    if (!($NoServiceInstall)) {
        "SERVICENAME=$ServiceName"
    }

    if ($AllowRemoteRootAccess) {
        $Arguments += @("ALLOWREMOTEROOTACCESS=True")
    } else {
        $Arguments += @("ALLOWREMOTEROOTACCESS=False")
    }

    Write-Host "Die Datei $SetupFile wird mit den Argumenten $Arguments installiert..."

    try {
        $CommandBasename = $Command.Substring($Command.LastIndexOf('\') + 1, $Command.LastIndexOf('.') - $Command.LastIndexOf('\') - 1)
        $StdOutFile = "$env:TEMP\$CommandBasename.stdout"
        $StdErrFile = "$env:TEMP\$CommandBasename.stderr"

        if ((Start-Process -FilePath "$Command" -ArgumentList "$Arguments" -RedirectStandardOutput $StdOutFile -RedirectStandardError $StdErrFile -Wait -PassThru).ExitCode -eq 0) {
            Get-Content $StdOutFile
        } else {
            (Get-Content $StdErrFile)
            Throw "Es ist ein Fehler bei der Installation aufgetreten. StdOut: " + (Get-Content $StdErrFile)
        }
    } catch {
        Write-Error "Es ist ein Fehler bei der Ausführung des Befehls '$Command $Arguments' aufgetreten: $($PSItem.ToString())"
    }
    finally {
        Remove-Item $StdOutFile -Force -ErrorAction SilentlyContinue
        Remove-Item $StdErrFile -Force -ErrorAction SilentlyContinue 
    }
}



<#
.SYNOPSIS
    Installiert GREYHOUND in einer Silent-Installation
.DESCRIPTION
    Installiert GREYHOUND in einer Silent-Installation. Die Setupdatei kann auch via Pipeline in Kombination mit Get-GreyhoundServerSetup verwendet werden. Saemtliche Optionen des GUI-Setups können in diesem Cmdlet als Parameter übergeben werden.
    Für eine Serverinstallation sind die Angaben einer Vertragsnummer und einer Seriennummer obligatorisch.
.EXAMPLE
    GreyhoundServerSetup | Install-GreyhoundServer
#>

function Install-GreyhoundServer {
    [CmdletBinding()]
    [Alias("Update-GreyhoundServer")]
    param (
        [Parameter(Mandatory=$true,
        ValueFromPipeline=$true)]
        [String]$SetupFile,
        [Parameter(Mandatory=$false)]
        [String]$ContractNumber,
        [String]$SerialNumber,
        [ValidateSet('Complete', 'Server', 'Client')][String]$Kind='Server',
        [String]$TargetDir="${env:ProgramFiles(x86)}\GREYHOUND\",
        [Switch]$DesktopShortcut=$false,
        [Switch]$StartMenuShortcut=$false,
        [Switch]$QuicklaunchShortcut=$false,
        [Switch]$DefaultMailClient=$false,
        [Switch]$PrinterDriver=$false,
        [Switch]$NoStart=$false,
        [String]$DatabaseUser='root',
        [String]$DatabasePass,
        [int16]$DatabasePort=3306,
        [ValidateSet('Small', 'Medium', 'Large')][String]$DatabaseTemlate='Large',
        [String]$AdminPassword='admin',
        [Switch]$Force=$false
    )

    try {
        $SetupMode = ''

        $SetupFile = Resolve-Path($SetupFile)
        if (Test-Path -Path $SetupFile) {
            $SetupVersion = (Get-Item $SetupFile).VersionInfo.ProductVersionRaw
            $Command = $SetupFile
        } else {
            Write-Error "Die Datei '$SetupFile' wurde nicht gefunden." -Category ObjectNotFound
            Break
        }

        if (!($Force) -and (Get-GreyhoundInstallPath)) {
            $SetupMode = 'Update'
            try {
                $InstalledVersion = Get-GreyhoundVersionInfo
                
                if ($InstalledVersion -gt $SetupVersion) {
                    Write-Host "Die installierte GREYHOUND-Version $InstalledVersion ist neuer als die Installationsdatei $SetupVersion." 
                    if (!($Force)) {
                        Break
                    }
                } elseif ($InstalledVersion -eq $SetupVersion) {
                    Write-Host "GREYHOUND Version $InstalledVersion ist bereits installiert." 
                    if (!($Force)) {
                        Break
                    }
                } else {
                    Write-Verbose "Die Installationsdatei $SetupVersion hat eine neuere Version als die installierte GREYHOUND-Version $InstalledVersion."
                }
    
                [String]$ContractNumber = Get-GreyhoundServerIniValue -Key 'ContractNumber'
                [String]$SerialNumber = Get-GreyhoundServerIniValue -Key 'Serial'

                Write-Verbose "Aktuelle Vertragsnummer: $ContractNumber"
                Write-Verbose "Aktuelle Seriennummer: $SerialNumber"
    
                $Arguments = @(
                    "-silent",
                    "-contract", "`"$ContractNumber`"",
                    "-serial", "`"$SerialNumber`"",
                    "-kind", "$Kind"
                )                  
            }
            catch {
                Write-Error "Es ist ein Fehler bei der Versionsermittlung aufgetreten."
            }
        } else {
            $SetupMode = 'Install'

            $Arguments = @(
                "-silent",
                "-contract", "`"$ContractNumber`"",
                "-serial", "`"$SerialNumber`"",
                "-kind", "$Kind",
                "-targetdir", "`"$TargetDir`"",
                "-databaseuser", "$DatabaseUser",
                "-databaseport", "$DatabasePort"
                "-databasetemplate", "$DatabaseTemlate",
                "-adminpassword", "$AdminPassword"
            )

            if ($DatabasePass) {
                $Arguments += @("-databasepass", "$DatabasePass")
            }
        
            if ($NoStart) {
                $Arguments += @("-nostart")
            }

            if (!$DesktopShortcut) {
                $Arguments += @("-nodesktop")
            }

            if (!$StartMenuShortcut) {
                $Arguments += @("-nostartmenu")
            }

            if (!$QuicklaunchShortcut) {
                $Arguments += @("-noquicklaunch")
            }

            if (!$DefaultMailClient) {
                $Arguments += @("-nodefaultmail")
            }

            if (!$PrinterDriver) {
                $Arguments += @("-noprinterdriver")
            }
        }

        if ($ContractNumber -and $SerialNumber) {
            if ($SetupMode -eq 'Install') {
                Write-Host "GREYHOUND Version $SetupVersion wird installiert..."
                Write-Verbose "Zielverzeichnis: `"$TargetDir`""
            } else {
                $VersionInstalled = (Get-GreyhoundVersionInfo).ToString()
                Write-Host "Die GREYHOUND-Installation wird von Version $VersionInstalled auf Version $SetupVersion aktualisiert..."
            }
            if ((Start-Process -FilePath "$Command" -ArgumentList "$Arguments" -Wait -PassThru).ExitCode -eq 0) {
                Write-Host "Die GREYHOUND-Installation war erfolgreich."
            } else {
                Throw "Das GREYHOUND-Setup hat einen unbekannten Fehler gemeldet."
            }
        } else {
            Write-Error "Fuer eine Installation sind eine Vertrags- und eine Seriennummer notwendig." -Category NotSpecified
            Break
        }
    }
    catch {
        Write-Error "Es ist ein Fehler bei der GREYHOUND-Installation aufgetreten: $($_.Exception.Message)"
    }
}



function Uninstall-GreyhoundServer {
    try {
        $GreyhoundSetupExe = (Get-GreyhoundInstallPath) + 'GreyhoundSetup.exe'
        if (Test-Path -Path $GreyhoundSetupExe) {
            Write-Host "GREYHOUND wird deinstalliert..."
            if ((Start-Process -FilePath "$GreyhoundSetupExe" -ArgumentList '-uninstall -useregistry -silent' -Wait -NoNewWindow -PassThru).ExitCode -eq 0) {
                Write-Host "GREYHOUND wurde erfolgreich deinstalliert."
            } else {
                Throw "Das GREYHOUND-Setup hat einen unbekannten Fehler gemeldet."
            }
        } else {
            Write-Error "Die Datei `"$GreyhoundSetupExe`" ist nicht vorhanden." -Category ObjectNotFound
            Break
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



<#
.SYNOPSIS
    Erstellt einen Dump der GREYHOUND Datenbank
.DESCRIPTION
    Erstellt einen Dump der GREYHOUND Datenbank. Optional kann dieser direkt komprimiert werden.
#>

function New-GreyhoundDatabaseDump {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,
        ValueFromPipeline=$true)]
        [string]$MySqlUser='root',
        [string]$MySqlPassword,
        [string]$MySqlParameters='--default-character-set=latin1',
        [string]$MySqlDatabase='greyhound',
        [switch]$Compress,
        [string]$DestinationPath=$PWD.Path
    )

    $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq 'MySql'
    $MySqlDump = $MySqlService.PathName.Split('mysqld.exe')[0] + 'mysqldump.exe'

    $StdErr = $env:TEMP + '\mysql.stderr'
        
    if (!(Test-Path -Path $MySqlDump)) {
        Write-Warning 'Die Exe-Datei' $MySqlDump 'wurde nicht gefunden.'
        Break
    }

    $MySqlDumpArgs = @(
        "--user=$MySqlUser"
    )

    if ($MySqlPassword) {
        $MySqlDumpArgs += @(
            "--password=$MySqlPassword"
        )
    }
    
    $MySqlDumpArgs += @(
        "--default-character-set=latin1",
        "$MySqlDatabase"
    )

    try {
        [string]$SqlFile = $DestinationPath + '\' + $MySqlDatabase + '.sql'
        if ((Start-Process -FilePath $MySqlDump -ArgumentList $MySqlDumpArgs -RedirectStandardOutput $SqlFile -RedirectStandardError $StdErr -Wait -NoNewWindow -PassThru).Exitcode -gt 0) {
            if (Test-Path -Path $StdErr) {
                $ExceptionText = Get-Content $StdErr
                Remove-Item $StdErr
            }
            Throw $ExceptionText
        } else {
            Write-Host $SqlFile
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
    finally {
        Remove-Item $SqlFile -ErrorAction SilentlyContinue
    }

    if ($Compress) {
        if (Test-Path -Path $SqlFile) {
            $Zip = (Get-Item  $SqlFile).DirectoryName + '\' + (Get-Item  $SqlFile).BaseName + '.zip'
            if (Test-Path -Path $Zip) {
                Remove-Item $Zip
            }
            
            try {
                Write-Verbose "Der Datenbank-Dump wird komprimiert. Ziel: $Zip"
                Compress-Archive -Path $SqlFile -DestinationPath $Zip -CompressionLevel Optimal
            }
            catch {
                Write-Error "Es ist ein Fehler beim Komprimieren des Datenbank-Dumps aufgetreten."
            }
            finally {
                Write-Verbose "Die Datei $SqlFile wird gelöscht."
                Remove-Item $SqlFile 
            }

        } else {
            Write-Warning "Die Datenbank-Datei $SqlFile konnte nicht komprimiert werden, weil sie nicht vorhanden ist."
        }
    }
}



<#
.SYNOPSIS
    Fuert beliebige Sql-Abfragen aus.
.DESCRIPTION
    Dieses Cmdlet ist ein Wrapper für mysql.exe einer bestehenden MySQL- oder MariaDB-Installation. Die gewuenschte Abfrage kann als Parameter eingeschlossen in doppelten Anführungszeichen übergeben werden. Die Ausgabe von mysql.exe wird in der Konsole ausgegeben.
#>

function Invoke-MySqlQuery {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true)]
        [string]$MySqlQuery,
        [Parameter(Mandatory=$false)]
        [string]$MySqlServiceName='MySql',
        [string]$MySqlHostname='localhost',
        [string]$MySqlUser='root',
        [string]$MySqlPass
    )

    try {
        $MySqlService = Get-WmiObject win32_service | Where-Object Name -eq $MySqlServiceName

        if (!($MySqlService)) {
            Throw "Der Dienst $MySqlServiceName existiert nicht."
        } elseif ($MySqlService.State -ne 'Running') {
            Throw "Der Dienst $MySqlServiceName ist nicht gestartet."
        }

        $MySqlExe = $MySqlService.PathName -replace '^"?(.*\\).*exe.*', "`$1mysql.exe"
        if (!(Test-Path -Path $MySqlExe)) {
            Throw "Die Datei $MySqlExe wurde nicht gefunden."
        }

        $Arguments = @(
            "--host=$MySqlHostname"
            "--user=$MySqlUser"
            '--execute="' + $MySqlQuery + '"'
        )

        if ($MySqlPass) {
            $Arguments += @(
                "--password=$MySqlPass"
            )
        }
    
        $StdOut = "$($env:TEMP)\MySql.stdout"
        $StdErr = "$($env:TEMP)\MySql.stderr"

        Remove-Item $StdOut, $StdErr -Force -ErrorAction SilentlyContinue
    
        Start-Process -FilePath "$MySqlExe" -ArgumentList "$Arguments" -NoNewWindow -Wait -RedirectStandardOutput $StdOut -RedirectStandardError $StdErr
        if (Test-Path -Path $StdOut) {
            Get-Content $StdOut
            Remove-Item $StdOut -Force -ErrorAction SilentlyContinue
        }
        if (Test-Path -Path $StdErr) {
            $StdErrContent = Get-Content $StdErr
            Remove-Item $StdErr -Force -ErrorAction SilentlyContinue
            Throw $StdErrContent
        }           
    } catch {
        Write-Error "Die MySql-Abfrage konnte nicht ausgefuehrt werden: $($_.Exception.Message)"
    }
}



<#
.SYNOPSIS
    Zeigt das letzte Logfile einer GREYHOUND Serverinstalltion an.
.DESCRIPTION
    Zeigt das letzte Logfile einer GREYHOUND Serverinstalltion an.
#>

function Get-GreyhoundLog {
    try {
        $Logfile = Get-ChildItem((Get-GreyhoundInstallPath) + '\Server\Logs\') | Select-Object -Last 1
        Get-Content $Logfile.FullName
    }
    catch {
        Write-Error $_.Exception.Message
    }    
}



<#
.SYNOPSIS
    Loescht die aktuelle GREYHOUND Datenbank
.DESCRIPTION
    Loescht die aktuelle GREYHOUND Datenbank, sodass eine neue, leere Datenbank beim naechsten GREYHOUND Serverstart erstellt wird. Die Dateien im GREYHOUND Data-Verzeichnis werden dabei nicht gelöscht
#>

function Reset-GreyhoundDatabase {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,
        ValueFromPipeline=$true)]
        [string]$MySqlHostname='localhost',
        [string]$MySqlUser='root',
        [string]$MySqlPass
    )
    try {
        $PrevGreyhoundServerStatus = ((Get-Service GreyhoundService).Status)

        Stop-Service GreyhoundService -ErrorAction Stop
        if (((Get-Service GreyhoundService).Status) -eq 'Stopped') {
            Write-Verbose "Die GREYHOUND Datenbank wird gelöscht..."
            $MySqlQuery = 'DROP DATABASE greyhound;'
            Invoke-MySqlQuery -MySqlQuery $MySqlQuery -MySqlHostname $MySqlHostname -MySqlUser $MySqlUser -MySqlPass $MySqlPass

            Write-Verbose "Die GREYHOUND Dateien werden gelöscht..."
            $ItemsToDelete = Get-ChildItem((Get-GreyhoundInstallPath) + '\Server\') |
                Where-Object Name -In 'AntiSpam', 'Data', 'AutoClassification', 'FulltextIndex', 'GoogleSync', 'ItemCount', 'Logs', 'Share', 'Thumbnails'
            $ItemsToDelete | Remove-Item -Recurse -Force | Out-Null
        } else {
            Throw "Der GREYHOUND-Dienst konnte nicht gestoppt werden."
        }

        if ($PrevGreyhoundServerStatus -eq 'Running') {
            Start-Service GreyhoundService -ErrorAction Stop
            if (((Get-Service GreyhoundService).Status) -ne 'Running') {
                Throw "Der GREYHOUND-Dienst konnte nicht gestartet werden."
            }
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



<#
.SYNOPSIS
    Konfiguriert perfekte Windows-Defender-Ausnahmen fuer den GREYHOUND-Serverbetrieb
.DESCRIPTION
    Konfiguriert perfekte Windows-Defender-Ausnahmen fuer den GREYHOUND-Serverbetrieb. Vorhandene Einstellungen werden dabei nicht gelöscht.
#>

function Add-GreyhoundDefenderPreference {
    try {
        $GreyhoundInstallPath = (Get-GreyhoundInstallPath).TrimEnd('\')
        $MySqlInstallPath = ((Get-ChildItem "${env:ProgramFiles}\Maria*" -Directory).FullName).TrimEnd('\')

        if ($GreyhoundInstallPath) {
            if ($MySqlInstallPath) {
                Add-MpPreference `
                -ExclusionProcess ("$GreyhoundInstallPath\Server\*", "$GreyhoundInstallPath\Server\Plugins\*", "$MySqlInstallPath\*") `
                -ExclusionPath ("$GreyhoundInstallPath\Server", "$MySqlInstallPath\data")
            } else {
                Throw Der MariaDB-Installationspfad wurde nicht gefunden.
            }
        } else {
            Throw Der GREYHOUND-Installationspfad wurde nicht gefunden.
        }
    } catch {
        Write-Error $_.Exception.Message
    }
}



<#
.SYNOPSIS
    Entfernt eine vorhandene MySql-Tabellenpartitionierung einer GREYHOUND 5-Installation
.DESCRIPTION
    Entfernt eine vorhandene MySql-Tabellenpartitionierung einer GREYHOUND 5-Installation und stellt die notwendigen Indizes wieder her. Dieses Cmdlet macht die Aenderungen von New-GreyhoundDatabasePartitioning wieder rueckgaengig.
#>

function Remove-GreyhoundDatabasePartitioning {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,
        ValueFromPipeline=$true)]
        [string]$MySqlHostname='localhost',
        [string]$MySqlUser='root',
        [string]$MySqlPass
    )
    try {
        # Auf Partitionierung prüfen
        $Path = (Get-MySqlDatadir) + '\greyhound'
        Write-Verbose "GREYHOUND Datenbank-Pfad: $Path"

        if (($Path) -and (Test-Path $Path) -and (Get-ChildItem -Path $Path -Filter 'items#*')) {
            Write-Verbose "GREYHOUND Dienst wird gestoppt..."
            $PrevGreyhoundServerStatus = ((Get-Service GreyhoundService).Status)

            Stop-Service GreyhoundService -ErrorAction Stop
            if (((Get-Service GreyhoundService).Status) -eq 'Stopped') {
                $MySqlQuery =  @'
USE greyhound;
ALTER TABLE `items` REMOVE PARTITIONING;
ALTER TABLE `items` CHANGE `e_state` `e_state` enum('open','new','question','answer','done','forward','draft','rejected') DEFAULT 'open' NOT NULL;
ALTER TABLE `items` CHANGE `e_kind` `e_kind` enum('email','fax','letter','shortmessage','call','appointment','task','note','contact','file') DEFAULT 'email' NOT NULL;
ALTER TABLE `items` ADD INDEX `e_kind` (`e_kind`);
ALTER TABLE `items` ADD INDEX `e_state` (`e_state`);
ALTER TABLE `items` DROP INDEX `PRIMARY`, ADD PRIMARY KEY(`i_id`);
'@

                Write-Verbose "Die MySQL-Abfrage wird ausgefuehrt: $MySqlQuery"
                Invoke-MySqlQuery -MySqlQuery $MySqlQuery -MySqlHostname $MySqlHostname -MySqlUser $MySqlUser -MySqlPass $MySqlPass -Verbose
            } else {
                Throw "Der GREYHOUND-Dienst konnte nicht gestoppt werden."
            }

            if ($PrevGreyhoundServerStatus -eq 'Running') {
                Write-Verbose "GREYHOUND Dienst wird gestartet..."
                Start-Service GreyhoundService -ErrorAction Stop
                if (((Get-Service GreyhoundService).Status) -ne 'Running') {
                    Throw "Der GREYHOUND-Dienst konnte nicht gestartet werden."
                }
            }
        } else {
            Write-Host "Die GREYHOUND-Datenbank ist nicht partitioniert. Keine Aktion erforderlich."
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function New-GreyhoundDatabasePartitioning {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,
        ValueFromPipeline=$true)]
        [string]$MySqlHostname='localhost',
        [string]$MySqlUser='root',
        [string]$MySqlPass
    )
    try {
        # Auf Partitionierung prüfen
        $Path = (Get-MySqlDatadir) + '\greyhound'
        Write-Verbose "GREYHOUND Datenbank-Pfad: $Path" -ErrorAction SilentlyContinue

        if (($Path) -and (Test-Path $Path) -and (!(Get-ChildItem -Path $Path -Filter 'items#*'))) {
            Write-Verbose "GREYHOUND Dienst wird gestoppt..."
            $PrevGreyhoundServerStatus = ((Get-Service GreyhoundService).Status)

            Stop-Service GreyhoundService -ErrorAction Stop
            if (((Get-Service GreyhoundService).Status) -eq 'Stopped') {
                $MySqlQuery =  @'
USE greyhound;
ALTER TABLE items DROP INDEX e_kind, DROP INDEX e_state;
ALTER TABLE items CHANGE e_state e_state TINYINT(1) DEFAULT '1' NOT NULL;
ALTER TABLE items CHANGE e_kind e_kind TINYINT(2) DEFAULT '1' NOT NULL;
ALTER TABLE items DROP PRIMARY KEY, ADD PRIMARY KEY (i_id, e_state, e_kind);
ALTER TABLE items
PARTITION BY LIST(e_state)
SUBPARTITION BY HASH(e_kind)
SUBPARTITIONS 10 (PARTITION isOpen VALUES IN (1), PARTITION isNew VALUES IN (2), PARTITION isQuestion VALUES IN (3), PARTITION isAnswer VALUES IN (4), PARTITION isDone VALUES IN (5), PARTITION isForward VALUES IN (6), PARTITION isDraft VALUES IN (7), PARTITION isRejected VALUES IN (8)
);
'@

                Write-Verbose "Die MySQL-Abfrage wird ausgefuehrt: $MySqlQuery"
                Invoke-MySqlQuery -MySqlQuery $MySqlQuery -MySqlHostname $MySqlHostname -MySqlUser $MySqlUser -MySqlPass $MySqlPass -Verbose
            } else {
                Throw "Der GREYHOUND-Dienst konnte nicht gestoppt werden."
            }

            if ($PrevGreyhoundServerStatus -eq 'Running') {
                Write-Verbose "GREYHOUND Dienst wird gestartet..."
                Start-Service GreyhoundService -ErrorAction Stop
                if (((Get-Service GreyhoundService).Status) -ne 'Running') {
                    Throw "Der GREYHOUND-Dienst konnte nicht gestartet werden."
                }
            }
        } else {
            Write-Host "Die GREYHOUND-Datenbank ist bereits partitioniert. Keine Aktion erforderlich."
        }
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Get-ApplianceData {
    [CmdletBinding()]
    param (
        [Parameter(
            Mandatory=$true,
            ValueFromPipeline=$true)]
        [string[]]$Serials,
        [Parameter(
            Mandatory=$false)]
        [string]$ApplianceKey
    )

    try {
        $GccUri         = 'https://greyhound-software.com/gcc/jsonrpc/'
        $ContentType    = 'application/json'
    
        $Serials = "`"" + ($Serials -join "`",`"") + "`""
    
        $Body = @"
{
    "jsonrpc": "2.0",
    "method": "GetApplianceData",
    "params": [
        [$Serials],
        "$ApplianceKey"
    ],
    "id": 1
}
"@

        $GccResult = Invoke-WebRequest -Uri $GccUri -Method Post -Body $Body -ContentType $ContentType | ConvertFrom-Json
    
        if ($GccResult.Error) {
            Write-Error $GccResult.Error.Message
        } else {
            $GccResult.Result
        }            
    }
    catch {
        Write-Error $_.Exception.Message
    }
}



function Get-GreyhoundInitialServerData {
    [CmdletBinding()]
    param (
        [Parameter(
            Mandatory=$true,
            ValueFromPipeline=$true)]
        [string]$InstallKey
    )

    try {
        $GccUri         = 'https://greyhound-software.com/gcc/jsonrpc/'
        $ContentType    = 'application/json'
    
        $Body = @"
{
    "jsonrpc": "2.0",
    "method": "GetInitialServerData",
    "params": [
        "$InstallKey"
    ],
    "id": 1
}
"@

        $GccResult = Invoke-WebRequest -Uri $GccUri -Method Post -Body $Body -ContentType $ContentType | ConvertFrom-Json
    
        if ($GccResult.Error) {
            Write-Error $GccResult.Error.Message
        } else {
            $GccResult.Result
        }
            
    }
    catch {
        Write-Error $_.Exception.Message
    }
}