<# --------------------------------------------------------------------------- Module......: Bootstrap.psm1 Projekt.....: Veeam Enterprise Installer Version.....: 2.0.1 Autor.......: ChatGPT & Benutzer PowerShell..: 5.1 --------------------------------------------------------------------------- Beschreibung Initialisiert das komplette Installationsprojekt. Dieses Modul • bestimmt alle Projektpfade • erstellt die Arbeitsverzeichnisse • initialisiert globale Variablen • legt Standardwerte fest • erkennt das Betriebssystem • stellt Informationen allen Modulen bereit Dieses Modul MUSS zuerst geladen werden. #> Set-StrictMode -Version Latest #region Script Variablen $Script:ProjectName = "Veeam Enterprise Installer" $Script:ProjectVersion = "2.0.1" $Script:RootPath = $null $Script:ModulePath = $null $Script:ConfigPath = $null $Script:ResourcePath = $null $Script:ReportPath = $null $Script:LogPath = $null $Script:TempPath = $null $Script:LogFile = $null $Script:TranscriptFile = $null $Script:Configuration = $null #endregion ############################################################ # Get-ProjectRoot ############################################################ function Get-ProjectRoot { <# .SYNOPSIS Ermittelt den Projektordner. #> $ModulesPath = Split-Path -Path $PSScriptRoot -Parent Split-Path -Path $ModulesPath -Parent } ############################################################ # Initialize-Paths ############################################################ function Initialize-Paths { <# .SYNOPSIS Initialisiert sämtliche Projektpfade. #> $Script:RootPath = Get-ProjectRoot $Script:ModulePath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Modules" $Script:ConfigPath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Config" $Script:ResourcePath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Resources" $Script:ReportPath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Reports" $Script:LogPath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Logs" $Script:TempPath = Join-Path ` -Path $Script:RootPath ` -ChildPath "Temp" $Script:LogFile = Join-Path ` -Path $Script:LogPath ` -ChildPath "Install.log" $Script:TranscriptFile = Join-Path ` -Path $Script:LogPath ` -ChildPath "Transcript.log" } ############################################################ # New-ProjectDirectory ############################################################ function New-ProjectDirectory { param( [Parameter(Mandatory)] [string]$Path ) if(Test-Path $Path) { return } New-Item ` -Path $Path ` -ItemType Directory ` -Force | Out-Null } ############################################################ # Initialize-Directories ############################################################ function Initialize-Directories { <# .SYNOPSIS Erstellt alle Projektverzeichnisse. #> $Folders = @( $Script:ModulePath $Script:ConfigPath $Script:ResourcePath $Script:ReportPath $Script:LogPath $Script:TempPath ) foreach($Folder in $Folders) { New-ProjectDirectory ` -Path $Folder } } #Beginn PART 2 ############################################################ # Get-OperatingSystem ############################################################ function Get-OperatingSystem { <# .SYNOPSIS Liefert Informationen zum Betriebssystem. #> try { Get-CimInstance ` Win32_OperatingSystem } catch { throw "Betriebssystem konnte nicht ermittelt werden." } } ############################################################ # Get-BuildNumber ############################################################ function Get-BuildNumber { <# .SYNOPSIS Liefert die Windows Buildnummer. #> (Get-OperatingSystem).BuildNumber } ############################################################ # Get-PowerShellVersion ############################################################ function Get-PowerShellVersion { <# .SYNOPSIS Liefert die installierte PowerShell Version. #> $PSVersionTable.PSVersion } ############################################################ # Test-Administrator ############################################################ function Test-Administrator { <# .SYNOPSIS Prüft Administratorrechte. #> $Identity = [Security.Principal.WindowsIdentity]::GetCurrent() $Principal = New-Object Security.Principal.WindowsPrincipal($Identity) return $Principal.IsInRole( [Security.Principal.WindowsBuiltInRole]::Administrator ) } ############################################################ # Test-SupportedOperatingSystem ############################################################ function Test-SupportedOperatingSystem { <# .SYNOPSIS Unterstützt Windows Server 2022 und 2025. #> $OS = Get-OperatingSystem $Caption = $OS.Caption if( $Caption -match "Windows Server 2022" -or $Caption -match "Windows Server 2025" ) { return $true } return $false } ############################################################ # Get-ComputerInformation ############################################################ function Get-ComputerInformation { <# .SYNOPSIS Erstellt ein Objekt mit Basisinformationen. #> $OS = Get-OperatingSystem [PSCustomObject]@{ ComputerName = $env:COMPUTERNAME Domain = $env:USERDOMAIN User = $env:USERNAME OperatingSystem = $OS.Caption Version = $OS.Version Build = $OS.BuildNumber Architecture = $OS.OSArchitecture PowerShellVersion = Get-PowerShellVersion InstallDate = $OS.InstallDate LastBoot = $OS.LastBootUpTime } } ############################################################ # Test-Bootstrap ############################################################ function Test-Bootstrap { <# .SYNOPSIS Führt Grundprüfungen aus. #> if(!(Test-Administrator)) { throw "Das Skript muss als Administrator ausgeführt werden." } if(!(Test-SupportedOperatingSystem)) { throw "Nur Windows Server 2022 und 2025 werden unterstützt." } $MinimumPowerShellVersion = [version]"5.1" if((Get-PowerShellVersion) -lt $MinimumPowerShellVersion) { throw "PowerShell 5.1 oder neuer wird benötigt." } } #Beginn PART 3 ############################################################ # Get-ProjectInformation ############################################################ function Get-ProjectInformation { <# .SYNOPSIS Liefert Projektinformationen. #> [PSCustomObject]@{ ProjectName = $Script:ProjectName Version = $Script:ProjectVersion RootPath = $Script:RootPath ModulePath = $Script:ModulePath ConfigPath = $Script:ConfigPath ResourcePath = $Script:ResourcePath ReportPath = $Script:ReportPath LogPath = $Script:LogPath TempPath = $Script:TempPath LogFile = $Script:LogFile TranscriptFile = $Script:TranscriptFile } } ############################################################ # Show-BootstrapBanner ############################################################ function Show-BootstrapBanner { Write-Host "" Write-Host "=========================================================" Write-Host " Veeam Enterprise Installer" Write-Host "=========================================================" Write-Host "Version : $Script:ProjectVersion" Write-Host "Computer : $env:COMPUTERNAME" Write-Host "Benutzer : $env:USERNAME" Write-Host "Projektpfad : $Script:RootPath" Write-Host "=========================================================" Write-Host "" } ############################################################ # Initialize-Bootstrap ############################################################ function Initialize-Bootstrap { <# .SYNOPSIS Initialisiert das komplette Framework. #> Test-Bootstrap Initialize-Paths Initialize-Directories $Info = Get-ProjectInformation Write-Host "" Write-Host "Projekt initialisiert" Write-Host "Root : $($Info.RootPath)" Write-Host "Config : $($Info.ConfigPath)" Write-Host "Logs : $($Info.LogPath)" Write-Host "Reports : $($Info.ReportPath)" Write-Host "Temp : $($Info.TempPath)" Show-BootstrapBanner } ############################################################ # Get-EnvironmentSummary ############################################################ function Get-EnvironmentSummary { $Computer = Get-ComputerInformation [PSCustomObject]@{ ProjectVersion = $Script:ProjectVersion ComputerName = $Computer.ComputerName Domain = $Computer.Domain User = $Computer.User OperatingSystem = $Computer.OperatingSystem Build = $Computer.Build Architecture = $Computer.Architecture PowerShell = $Computer.PowerShellVersion RootPath = $Script:RootPath LogPath = $Script:LogPath ReportPath = $Script:ReportPath TempPath = $Script:TempPath } } ############################################################ # Reset-Bootstrap ############################################################ function Reset-Bootstrap { $Script:Configuration = $null } #Beginn PART 4 ############################################################ # Get-ProjectPaths ############################################################ function Get-ProjectPaths { <# .SYNOPSIS Gibt alle Projektpfade zurück. #> return [PSCustomObject]@{ Root = $Script:RootPath Modules = $Script:ModulePath Config = $Script:ConfigPath Resources = $Script:ResourcePath Reports = $Script:ReportPath Logs = $Script:LogPath Temp = $Script:TempPath LogFile = $Script:LogFile Transcript = $Script:TranscriptFile } } ############################################################ # Set-ProjectConfiguration ############################################################ function Set-ProjectConfiguration { param( [Parameter(Mandatory)] [psobject]$Configuration ) $Script:Configuration = $Configuration } ############################################################ # Get-ProjectConfiguration ############################################################ function Get-ProjectConfiguration { return $Script:Configuration } ############################################################ # Test-ProjectInitialized ############################################################ function Test-ProjectInitialized { if([string]::IsNullOrWhiteSpace($Script:RootPath)) { return $false } if(!(Test-Path $Script:RootPath)) { return $false } return $true } ############################################################ # Initialize beim Import NICHT automatisch ausführen ############################################################ # Die Initialisierung erfolgt ausschließlich # über Initialize-Bootstrap() im Hauptskript. ############################################################ # Exportierte Funktionen ############################################################ Export-ModuleMember ` -Function ` Initialize-Bootstrap, Test-Bootstrap, Test-Administrator, Test-SupportedOperatingSystem, Get-OperatingSystem, Get-BuildNumber, Get-PowerShellVersion, Get-ComputerInformation, Get-ProjectInformation, Get-ProjectPaths, Get-EnvironmentSummary, Set-ProjectConfiguration, Get-ProjectConfiguration, Test-ProjectInitialized, Reset-Bootstrap ############################################################ # Ende Bootstrap.psm1 ############################################################