Set-StrictMode -Version Latest $ErrorActionPreference = 'Stop' function Read-ZipXml($Zip, [string]$Name, [switch]$Optional) { $entry = $Zip.GetEntry($Name) if (-not $entry) { if ($Optional) { return $null }; throw "XLSX-Bestandteil fehlt: $Name" } if ($entry.Length -gt 16MB) { throw "XLSX-Bestandteil zu gross: $Name" } $stream = $entry.Open() $settings = New-Object System.Xml.XmlReaderSettings $settings.DtdProcessing = [System.Xml.DtdProcessing]::Prohibit $settings.XmlResolver = $null $reader = [System.Xml.XmlReader]::Create($stream, $settings) try { $doc = New-Object System.Xml.XmlDocument; $doc.XmlResolver = $null; $doc.Load($reader); return ,$doc } finally { $reader.Dispose(); $stream.Dispose() } } function Read-KisWorkbook([string]$Path) { Add-Type -AssemblyName System.IO.Compression.FileSystem $zip = [System.IO.Compression.ZipFile]::OpenRead((Resolve-Path -LiteralPath $Path).Path) try { $book = Read-ZipXml $zip 'xl/workbook.xml' $rels = Read-ZipXml $zip 'xl/_rels/workbook.xml.rels' $shared = Read-ZipXml $zip 'xl/sharedStrings.xml' -Optional $strings = @() if ($shared) { $strings = @($shared.SelectNodes('//*[local-name()="si"]') | ForEach-Object { ($_.SelectNodes('.//*[local-name()="t"]') | ForEach-Object { $_.InnerText }) -join '' }) } $sheets = @{} foreach ($sheet in $book.SelectNodes('//*[local-name()="sheet"]')) { if ($sheet.GetAttribute('name') -notin @('Staging','Server')) { continue } $rid = $sheet.GetAttribute('id','http://schemas.openxmlformats.org/officeDocument/2006/relationships') $rel = @($rels.SelectNodes('//*[local-name()="Relationship"]') | Where-Object { $_.GetAttribute('Id') -eq $rid }) if ($rel.Count -ne 1) { throw 'Ungueltige XLSX-Beziehung' } $target = $rel[0].GetAttribute('Target') if ($target -match '(^/xl/|^xl/)') { $target = $target.TrimStart('/') } else { $target = 'xl/' + $target } $xml = Read-ZipXml $zip $target $cells = @{}; $formulas = @{} foreach ($cell in $xml.SelectNodes('//*[local-name()="sheetData"]/*/*[local-name()="c"]')) { $address = $cell.GetAttribute('r') $valueNode = $cell.SelectSingleNode('./*[local-name()="v"]') $value = if ($valueNode) { $valueNode.InnerText } else { '' } switch ($cell.GetAttribute('t')) { 's' { $value = $strings[[int]$value] } 'inlineStr' { $value = ($cell.SelectNodes('.//*[local-name()="t"]') | ForEach-Object { $_.InnerText }) -join '' } 'e' { $value = '' } } $cells[$address] = [string]$value if ($cell.SelectSingleNode('./*[local-name()="f"]')) { $formulas[$address] = $true } } $sheets[$sheet.GetAttribute('name')] = @{ Cells=$cells; Formulas=$formulas } } if (-not $sheets.ContainsKey('Staging') -or -not $sheets.ContainsKey('Server')) { throw 'KIS-Workbook mit Staging und Server erforderlich.' } $settings = @{} foreach ($key in $sheets.Staging.Cells.Keys) { if ($key -notmatch '^A(\d+)$') { continue } $row = $Matches[1]; $name = $sheets.Staging.Cells[$key] # Retain the internal keys for older KIS workbooks and scripts. if ($name -eq 'ISO-Name Proxmox') { $name='Proxmox-Medium' } if ($name -eq 'ISO-Name ESXi') { $name='ESXi-Medium' } if ($name -notin @('Projektname','Windows-Server-Version','Netzwerkkarte','GETAC-IP','Netzpräfix','DHCP von','DHCP bis','Medienordner','Proxmox-Medium','ESXi-Medium','ISO-Ablage','Admin-E-Mail','DNS-Zone','GETAC-Name')) { continue } if ($sheets.Staging.Formulas.ContainsKey("B$row")) { throw "Staging!B${row}: Eingabeformeln sind nicht erlaubt." } if ($settings.ContainsKey($name)) { throw "Doppelte Staging-Einstellung: $name" } $settings[$name] = [string]$sheets.Staging.Cells["B$row"] } $expected = @('Installieren','Servername','PXE-MAC-Adresse','System','Version','Installationsdatenträger','Ziel-IP','Präfix','Gateway','DNS-Server','Benutzername','Hinweis') for ($i=0; $i -lt $expected.Count; $i++) { $col = [string][char](65+$i) if ($sheets.Server.Cells["${col}6"] -cne $expected[$i]) { throw "Server!${col}6: Erwartet '$($expected[$i])'. KIS Schema 0.2 erforderlich." } } foreach ($key in $sheets.Server.Cells.Keys) { if ($key -match '^A(\d+)$' -and [int]$Matches[1] -gt 26 -and $sheets.Server.Cells[$key] -eq 'JA') { throw 'Server ausserhalb der 20 vorbereiteten Zeilen. Bereich zuerst erweitern.' } } $servers = @() for ($r=7; $r -le 26; $r++) { $values = @{} for ($i=0; $i -lt $expected.Count; $i++) { $cell = "$([char](65+$i))$r" if ($sheets.Server.Formulas.ContainsKey($cell)) { throw "Server!${cell}: Eingabeformeln sind nicht erlaubt." } $values[$expected[$i]] = ([string]$sheets.Server.Cells[$cell]).Trim() } if ($sheets.Server.Cells['N6'] -eq 'PXE-IP') { if ($sheets.Server.Formulas.ContainsKey("N$r")) { throw "Server!N${r}: Eingabeformeln sind nicht erlaubt." } $values['PXE-IP']=([string]$sheets.Server.Cells["N$r"]).Trim() } if ($values.Installieren -notin @('','JA','NEIN')) { throw "Server Zeile ${r}: Installieren muss JA oder NEIN sein." } if ($values.Installieren -eq 'JA') { $values.Row = $r; $servers += $values } } return @{ Settings=$settings; Servers=$servers } } finally { $zip.Dispose() } } function Get-IPv4Number([string]$Value) { if ($Value -notmatch '^(0|[1-9][0-9]{0,2})(\.(0|[1-9][0-9]{0,2})){3}$') { throw "Ungueltige IPv4-Adresse: $Value" } [uint64]$n=0 foreach ($octet in $Value.Split('.')) { if ([int]$octet -gt 255) { throw "Ungueltige IPv4-Adresse: $Value" }; $n=$n*256+[int]$octet } return $n } function Get-Netmask([int]$Prefix) { $parts = for ($i=0; $i -lt 4; $i++) { $bits=[Math]::Min(8,[Math]::Max(0,$Prefix-8*$i)); [int](256-[Math]::Pow(2,8-$bits)) } return ($parts -join '.') } function Assert-Text([string]$Value,[string]$Pattern,[string]$Label) { if ([string]::IsNullOrWhiteSpace($Value) -or $Value -notmatch $Pattern) { throw "${Label}: fehlt oder ungueltiges Format." } } function Get-IsoPath($Settings,[string]$FileName) { # An explicitly blank new field must never silently choose another source. $folder=if ($Settings.ContainsKey('ISO-Ablage')) { [string]$Settings['ISO-Ablage'] } else { [string]$Settings.Medienordner } $folder=$folder.Trim() if (-not $folder) { throw 'ISO-Ablage fehlt. Vor Schritt 03 lokalen Ordner oder UNC-Freigabe eintragen.' } Assert-Text $FileName '^[^\\/:*?"<>|\x00-\x1f]+\.iso$' 'ISO-Name (nur Dateiname)' if ($folder -match '^[a-zA-Z]:\\' -or $folder.StartsWith('\\')) { if ($folder -match '^[a-zA-Z]:\\') { $tail=$folder.Substring(3) } else { if ($folder -notmatch '^\\\\[^\\/:*?"<>|\x00-\x1f]+\\[^\\/:*?"<>|\x00-\x1f]+(?:\\.*)?$' -or $folder.StartsWith('\\?\') -or $folder.StartsWith('\\.\')) { throw 'ISO-Ablage: UNC-Pfad muss Server und Freigabe enthalten, z.B. \\fileserver\ISOs.' } $tail=$folder.Substring(2) } if ($tail -match '[/<>:"|?*\x00-\x1f]' -or $tail -match '(?:^|\\)\.{1,2}(?:\\|$)' -or $tail -match '[. ](?:\\|$)') { throw 'ISO-Ablage enthaelt ungueltige Pfadbestandteile.' } return $folder.TrimEnd('\')+'\'+$FileName } # Permit native absolute paths for the existing macOS/Linux validation tests. if ([Environment]::OSVersion.Platform -ne [PlatformID]::Win32NT -and $folder.StartsWith('/') -and $folder -notmatch '(?:^|/)\.{1,2}(?:/|$)') { return Join-Path $folder $FileName } throw 'ISO-Ablage: absoluten lokalen Windows-Pfad oder UNC-Freigabe verwenden, keine URL oder relativen Pfade.' } function Get-InstallPlan($Config, [switch]$CheckMedia) { $s=$Config.Settings; $hosts=@($Config.Servers) if ($hosts.Count -eq 0) { return @() } foreach ($key in @('Windows-Server-Version','Netzwerkkarte','GETAC-IP','Netzpräfix','DHCP von','DHCP bis','Medienordner')) { if ([string]::IsNullOrWhiteSpace($s[$key])) { throw "Staging: '$key' fehlt." } } Assert-Text $s['Netzpräfix'] '^(?:[1-9]|[12][0-9]|30)$' 'Staging Netzpraefix' $prefix=[int]$s['Netzpräfix']; [uint64]$block=[Math]::Pow(2,32-$prefix) $getac=Get-IPv4Number $s['GETAC-IP']; $network=[uint64]([Math]::Floor($getac/$block)*$block); $broadcast=$network+$block-1 $from=Get-IPv4Number $s['DHCP von']; $to=Get-IPv4Number $s['DHCP bis'] if ($from -le $network -or $to -ge $broadcast -or $from -gt $to -or ($getac -ge $from -and $getac -le $to) -or $getac -eq $network -or $getac -eq $broadcast) { throw 'Staging: DHCP-Bereich und feste GETAC-IP muessen im selben Netz liegen und sich ausschliessen.' } $seenMac=@{}; $seenIp=@{}; $seenName=@{}; $versions=@{}; $result=@() foreach ($h in $hosts) { $label="Server Zeile $($h.Row)" Assert-Text $h.Servername '^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$' "$label Servername (FQDN)" Assert-Text $h['PXE-MAC-Adresse'] '^(?:[0-9a-fA-F]{2}:){5}[0-9a-fA-F]{2}$' "$label MAC" $mac=$h['PXE-MAC-Adresse'].ToLowerInvariant() if (([Convert]::ToInt32($mac.Substring(0,2),16) -band 1) -ne 0 -or $mac -eq '00:00:00:00:00:00') { throw "$label MAC ist keine Unicast-Geraeteadresse." } if ($seenMac.ContainsKey($mac) -or $seenName.ContainsKey($h.Servername)) { throw "$label Name oder MAC doppelt." } $seenMac[$mac]=$true; $seenName[$h.Servername]=$true Assert-Text $h['Präfix'] '^(?:[1-9]|[12][0-9]|30)$' "$label Praefix" $ip=Get-IPv4Number $h['Ziel-IP'] if ($seenIp.ContainsKey($h['Ziel-IP'])) { throw "$label IP doppelt." }; $seenIp[$h['Ziel-IP']]=$true if ([int]$h['Präfix'] -ne $prefix -or $ip -le $network -or $ip -ge $broadcast -or $ip -eq $getac -or ($ip -ge $from -and $ip -le $to)) { throw "$label Ziel-IP muss im GETAC-Netz, ausserhalb DHCP und ungleich GETAC-IP liegen (KIS)." } $gateway=Get-IPv4Number $h.Gateway if ($gateway -le $network -or $gateway -ge $broadcast -or $gateway -eq $ip -or ($gateway -ge $from -and $gateway -le $to)) { throw "$label Gateway ungueltig." } if (-not $h['DNS-Server']) { throw "$label DNS-Server fehlt. Fuer statische Installer-Konfiguration erforderlich." } $dns=@($h['DNS-Server'].Split(';') | ForEach-Object { $_.Trim(); }) foreach ($d in $dns) { $null=Get-IPv4Number $d } if ($h.Benutzername -cne 'root') { throw "$label Installation setzt das root-Konto; andere Konten spaeter anlegen." } $platform=$h.System; $version=$h.Version Assert-Text $version '^[0-9]+\.[0-9]+[a-zA-Z0-9._-]*$' "$label Version" if ($versions.ContainsKey($platform) -and $versions[$platform] -cne $version) { throw 'KIS: Ein Versionssatz je Plattform und Durchlauf.' }; $versions[$platform]=$version switch ($platform) { 'Proxmox VE' { if ($version -notmatch '^(?:8\.[4-9]|9\.[0-9]+)(?:[._-].*)?$') { throw "$label PVE-Version '$version': Generatorprofil derzeit fuer 8.4 und 9.x vorbereitet. Kein stiller Versionsersatz." } if ($dns.Count -ne 1) { throw "$label PVE-Profil erwartet genau einen DNS-Server." } Assert-Text $h.Installationsdatenträger '^(?:sd[a-z]+|nvme[0-9]+n[0-9]+|vd[a-z]+|ID_SERIAL=[a-zA-Z0-9_.:+-]+)$' "$label PVE-Disk (Geraetename oder ID_SERIAL=...)" $mediaName=$s['Proxmox-Medium']; $file='answer.toml' } 'VMware ESXi' { if ($version -notmatch '^[78]\.[0-9]+[a-zA-Z0-9._-]*$') { throw "$label ESXi-Version '$version': Generatorprofil derzeit fuer 7.x/8.x vorbereitet." } Assert-Text $h.Installationsdatenträger '^(?:naa|eui|t10|mpx)\.[a-zA-Z0-9_.:-]+$' "$label ESXi-Disk (naa./eui./t10./mpx.)" $mediaName=$s['ESXi-Medium']; $file='ks.cfg' } default { throw "$label System muss Proxmox VE oder VMware ESXi sein." } } $media=Get-IsoPath $s $mediaName if ($CheckMedia -and -not (Test-Path -LiteralPath $media -PathType Leaf)) { throw "ISO fehlt oder ist mit dem aktuellen Windows-Konto nicht erreichbar: $media" } $result += [pscustomobject]@{ Name=$h.Servername; Mac=$mac; Platform=$platform; Version=$version; Disk=$h.Installationsdatenträger; IP=$h['Ziel-IP']; Prefix=[int]$h['Präfix']; Gateway=$h.Gateway; DNS=$dns; Media=$media; FileName=$file } } foreach ($h in $result) { if ($seenIp.ContainsKey($h.Gateway)) { throw 'Gateway darf keine ausgewaehlte Zielserver-IP sein.' } } return $result } function New-RootHash([Security.SecureString]$Password) { if (-not ('Staging.Sha512Crypt' -as [type])) { Add-Type -Path (Join-Path $PSScriptRoot 'Sha512Crypt.cs') } $pointer=[Runtime.InteropServices.Marshal]::SecureStringToBSTR($Password) try { $plain=[Runtime.InteropServices.Marshal]::PtrToStringBSTR($pointer) # Conservative shared profile; do not weaken the ESXi password policy. if ($plain.Length -lt 12 -or $plain.Length -gt 64 -or $plain -notmatch '^[\x21-\x7e]+$' -or $plain -notmatch '[A-Z]' -or $plain -notmatch '[a-z]' -or $plain -notmatch '[0-9]' -or $plain -notmatch '[^a-zA-Z0-9]') { throw 'Passwort: 12-64 druckbare ASCII-Zeichen, Gross-/Kleinbuchstaben, Zahl und Sonderzeichen, keine Leerzeichen.' } return [Staging.Sha512Crypt]::Compute($plain,[Staging.Sha512Crypt]::NewSalt(),100000) } finally { $plain=$null; [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($pointer) } } function ConvertTo-AnswerText($Server, [string]$Hash, [string]$AdminEmail) { if ($Hash -notmatch '^\$6\$(?:rounds=[0-9]+\$)?[./a-zA-Z0-9]{1,16}\$[./a-zA-Z0-9]{86}$') { throw 'Ungueltiger SHA-512-crypt-Hash.' } if ($Server.Platform -eq 'Proxmox VE') { Assert-Text $AdminEmail '^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$' 'PVE Admin-E-Mail' $disk=if ($Server.Disk.StartsWith('ID_SERIAL=')) { 'filter.ID_SERIAL = "' + $Server.Disk.Substring(10) + '"' } else { 'disk-list = ["' + $Server.Disk + '"]' } return (@( '# Generated from KIS workbook. Destructive installation on the specified disk.', "# Target version: $($Server.Version)", '[global]', 'keyboard = "de"', 'country = "de"', ('fqdn = "' + $Server.Name + '"'), ('mailto = "' + $AdminEmail + '"'), 'timezone = "Europe/Berlin"', ('root-password-hashed = "' + $Hash + '"'), '', '[network]', 'source = "from-answer"', ('cidr = "' + $Server.IP + '/' + $Server.Prefix + '"'), ('gateway = "' + $Server.Gateway + '"'), ('dns = "' + $Server.DNS[0] + '"'), ('filter.ID_NET_NAME_MAC = "*' + $Server.Mac.Replace(':','') + '"'), '', '[disk-setup]', 'filesystem = "ext4"', $disk, '' ) -join "`n") } return (@( '# Generated from KIS workbook. EULA acceptance and disk erase must be approved before use.', "# Target version: $($Server.Version)", 'vmaccepteula', ('rootpw --iscrypted ' + $Hash), ('install --disk=' + $Server.Disk + ' --overwritevmfs'), ('network --bootproto=static --device=' + $Server.Mac + ' --ip=' + $Server.IP + ' --netmask=' + (Get-Netmask $Server.Prefix) + ' --gateway=' + $Server.Gateway + ' --nameserver=' + ($Server.DNS -join ',') + ' --hostname=' + $Server.Name), 'reboot', '' ) -join "`n") } function New-PrivateRunDirectory([string]$Parent) { $name='run-' + [DateTime]::UtcNow.ToString('yyyyMMdd-HHmmss') + '-' + [Guid]::NewGuid().ToString('N').Substring(0,8) $path=Join-Path $Parent $name $null=New-Item -ItemType Directory -Path $path -Force if ([Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT) { $acl=New-Object Security.AccessControl.DirectorySecurity $acl.SetAccessRuleProtection($true,$false) $sid=[Security.Principal.WindowsIdentity]::GetCurrent().User $acl.SetOwner($sid) $rule=New-Object Security.AccessControl.FileSystemAccessRule($sid,'FullControl','ContainerInherit,ObjectInherit','None','Allow') $acl.AddAccessRule($rule) Set-Acl -LiteralPath $path -AclObject $acl } else { & chmod 700 $path; if ($LASTEXITCODE -ne 0) { throw 'Ausgabeordner konnte nicht geschuetzt werden.' } } return $path } Export-ModuleMember -Function Read-KisWorkbook,Get-InstallPlan,Get-Netmask,New-RootHash,ConvertTo-AnswerText,New-PrivateRunDirectory