Files
syno-scripts/Stagging/Modules/Unattended.psm1
T

235 lines
17 KiB
PowerShell

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','Virtualisierer')) { 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 }
}
$sheetKey=$sheet.GetAttribute('name')
if ($sheetKey -eq 'Virtualisierer') { $sheetKey='Server' }
if ($sheets.ContainsKey($sheetKey)) { throw 'Workbook darf nicht gleichzeitig Server und Virtualisierer enthalten.' }
$sheets[$sheetKey] = @{ Cells=$cells; Formulas=$formulas }
}
if (-not $sheets.ContainsKey('Staging') -or -not $sheets.ContainsKey('Server')) { throw 'KIS-Workbook mit Staging und Virtualisierer erforderlich (altes Blatt Server wird ebenfalls gelesen).' }
$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 "Virtualisierer!${col}6: Erwartet '$($expected[$i])'. KIS-Spaltenstruktur 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 "Virtualisierer!${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 "Virtualisierer!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