Benutzeroberfläche

Die WinForms-GUI gliedert sich in acht konfigurierbare Gruppen. Alle Combobox-Inhalte werden beim Start aus der INI geladen. Domänen-Standardwerte werden automatisch vorausgewählt und im Formular hervorgehoben.

Abb. 1: SQL Server Setup Tool – Hauptfenster (Beispiel: Domäne CONTOSO, Instanz INST01)

Projektstruktur

Das SQL Server Setup Tool automatisiert die standardisierte Installation von Microsoft SQL Server in Unternehmensumgebungen. Eine WinForms-GUI führt den Administrator durch alle Konfigurationsschritte; Installation und Nachkonfiguration erfolgen vollständig per PowerShell und dbaTools.

INI-Konfiguration (settings.ini)

Alle Combobox-Inhalte, Standardwerte, Pfade und Seriennummern werden beim Start aus der INI-Datei in Config\settings.ini gelesen. Änderungen erfordern keinen Neustart des Skripts – die Datei wird bei jedem Start neu eingelesen.

[General]

[Versions] und [Editions]

[Collations]

Die vollständige Auswahlliste wird seit April 2025 aus Config\collations.txt gelesen – siehe Abschnitt 2a. In der INI verbleiben nur noch die Standard-Collation und domänenspezifische Vorgaben.

[Collations] 
# Globale Standardsortierung – Fallback wenn collations.txt fehlt 
Standard=SQL_Latin1_General_CP1_CI_AS 
 
# Domänenspezifische Vorgabe – erscheint an erster Stelle der Combobox 
# Format: Domain_<NETBIOSNAME> = <Collation> 
Domain_CONTOSO=Latin1_General_CI_AS 
 
# List= entfällt – vollständige Liste in Config\collations.txt

[Paths] – Konfigurierbare SQL-Pfade

Die Unterverzeichnis-Teile werden mit dem Laufwerksbuchstaben aus [DiskLayout_*] und dem Instanz-Suffix kombiniert. Der Suffix lautet MSSQLSERVER für die Standardinstanz, sonst MSSQL$<Instanzname>.

[DiskLayout_Standard] und domänenspezifische Layouts

Laufwerksbuchstaben je Pfadtyp. Für jede Domäne kann eine eigene Sektion [DiskLayout_<NETBIOSNAME>] angelegt werden, die automatisch greift wenn der Server Mitglied dieser Domäne ist.

[DiskLayout_Standard] 
DataDrive=D 
LogDrive=E 
TempDrive=T 
BackupDrive=B 
InstallDrive=C 
 
# Überschreibt Standard für CONTOSO-Domäne 
[DiskLayout_CONTOSO] 
DataDrive=F 
LogDrive=G 
TempDrive=H 
BackupDrive=I 
InstallDrive=C

[SerialNumbers]

Schlüsselformat: SQL<Version>_<Edition>. Developer-Editionen bleiben leer – kein Produktkey erforderlich.

Collation-Auswahlliste (Config\collations.txt)

Die vollständige Liste der zur Auswahl stehenden Sortierungen wurde aus der settings.ini ausgelagert. Sie liegt als einfache Textdatei im selben Verzeichnis wie die INI und kann ohne Kenntnisse des INI-Formats gepflegt werden.

Datei-Eigenschaften

Verhalten und Priorität

# SQL Server-Sortierungen (Latin / CI) 
SQL_Latin1_General_CP1_CI_AS 
SQL_Latin1_General_CP1_CI_AI 
SQL_Latin1_General_CP1_CS_AS 
 
# Windows-Sortierungen (Deutsch / Mitteleuropa) 
Latin1_General_CI_AS 
Latin1_General_CS_AS 
German_PhoneBook_CI_AS 
 
# Weitere europäische Sprachen 
Finnish_Swedish_CI_AS 
French_CI_AS 
Polish_CI_AS 
 
# BIN 
Latin1_General_BIN 
Latin1_General_BIN2

Auflösungsreihenfolge in Get-CollationList

# 1. collations.txt lesen 
$list = Get-Content "$ConfigDir\collations.txt" | 
Where-Object { $_ -match '\S' -and $_ -notmatch '^#' } | 
ForEach-Object { $_.Trim() } 
 
# 2. Datei nicht vorhanden oder leer → Fallback auf Standard-Collation 
if ($list.Count -eq 0) { return @($DefaultCollation) } 
 
# 3. Domänen-Vorgabe an erste Position, Duplikat entfernen 
if ($DomainCollation) { 
$list = @($DomainCollation) + ($list | Where-Object { $_ -ne $DomainCollation }) 
} 
 
return $list # → Combobox-Inhalt

Neue Sortierung hinzufügen

Einfach eine neue Zeile mit dem exakten SQL-Server-Collationnamen in collations.txt eintragen. Das Tool liest die Datei beim nächsten Start automatisch neu ein. Kein Eingriff in settings.ini erforderlich.

dbaTools-Share-Konfiguration ([dbaTools])

Der bisherige Schlüssel SharePath wurde durch ShareBasePath ersetzt. Der Code leitet daraus automatisch die beiden benötigten Unterverzeichnisse ab – manuelles Pflegen zweier Pfade entfällt.

Share-Struktur

settings.ini – [dbaTools]

[dbaTools] 
# Basisverzeichnis auf dem Share. 
# Darunter werden automatisch erwartet: 
# <ShareBasePath>\dbatools – Hauptmodul 
# <ShareBasePath>\dbatools.library – Bibliothek (dbaTools >= 2.x) 
ShareBasePath = W:\75084-Datenbanken\MSSQL\CCM\_MSSQL_GUI\01_PreInstall 
ModuleName = dbatools 
 
# SharePath= (alte Variante) entfällt

Ladereihenfolge (DbaToolsSetup.psm1)

# 1. Bereits im Runspace geladen? 
if (Get-Module -Name dbatools) { return } 
 
# 2. Lokal installiert (Get-Module -ListAvailable)? 
if (Get-Module -ListAvailable -Name dbatools) { 
Import-Module dbatools; return 
} 
 
# 3. Share: ManifestPath erreichbar? 
# <ShareBasePath>\dbatools\dbatools.psd1 
if (Test-Path $DbaToolsConfig.ManifestPath) { 
 
# dbatools.library-Parent temporär in PSModulePath eintragen 
$env:PSModulePath = $libParent + ';' + $env:PSModulePath 
 
# Beide Ordner nach C:\Program Files\WindowsPowerShell\Modules\ kopieren 
foreach ($folder in @('dbatools', 'dbatools.library')) { 
if (-not (Test-Path $dst)) { 
Copy-Item -Path $src -Destination $dst -Recurse -Force 
} 
} 
Import-Module $DbaToolsConfig.ManifestPath; return 
} 
 
# 4. Fallback: PowerShell Gallery 
Install-Module dbatools -Scope AllUsers -Force

Abgeleitete Pfade im Konfigurationsobjekt

Ablauf & Verfahren

Startsequenz (Main.ps1)

Beim Aufruf durchläuft Main.ps1 folgende Schritte in dieser Reihenfolge, bevor die GUI erscheint:

1. Adminrechte prüfen (WindowsPrincipal) – Abbruch mit Dialog bei Fehlschlag
2. Alle sieben Module laden (Import-Module -Force)
3. INI-Konfiguration lesen, Konfigurationsobjekt aufbauen, Domäne ermitteln
4. Collation-Liste aus Config\collations.txt einlesen
5. dbaTools sicherstellen – mit Splash-Fenster und Marquee-ProgressBar
6. Relative PostInstall-Skriptpfade in absolute Pfade auflösen
7. GUI starten (Show-SetupForm)

Domänenerkennung und domänenspezifische Konfiguration

Get-CurrentDomain liest den NetBIOS-Domänennamen via Win32_ComputerSystem. Der Name wird großgeschrieben und als Suchschlüssel für folgende INI-Elemente verwendet:

• [Collations] Domain_<n> – Sortierungsvorgabe, wird an erste Combobox-Position gesetzt
• [DiskLayout_<n>] – Eigene Sektion mit Laufwerksbuchstaben
• [Monitoring] Domain_<n> – Vorauswahl Monitoring-Typ

AD-Validierung (Validation.psm1)

# Stufe 1: UPN normalisieren 
# user@domain.com -> DOMAIN\user 
$normalized = ConvertTo-DomainAccountFormat -AccountName $account 
 
# Stufe 2: Passwort validieren (genau 1 DC-Bind-Versuch) 
$ctx.ValidateCredentials($samName, $password) 
# Bei Fehler: Lockout-Zähler um 1 erhöht

GUI-Threading (Runspace-Konzept)

Lange Operationen (Robocopy, SQL-Installation, PostInstall) laufen in einem separaten PowerShell-Runspace damit die WinForms-GUI nicht einfriert.

$logCallback = [ScriptBlock]{ 
param([string]$msg) 
$line = "$(Get-Date -Format 'HH:mm:ss') $msg" 
$txtLog.Invoke([System.Windows.Forms.MethodInvoker]{ 
$txtLog.AppendText("$line`r`n") 
$txtLog.ScrollToCaret() 
}) 
}

PostInstall-Nachkonfiguration

Nach erfolgreicher SQL-Server Installation ruft der Worker-Thread automatisch Invoke-PostInstall auf. Alle Aktionen werden im Log-Fenster protokolliert.

param([string]$InstanceName, [ScriptBlock]$LogAction) 
 
$sqlInst = if ($InstanceName -eq 'MSSQLSERVER') { 
$env:COMPUTERNAME 
} else { "$($env:COMPUTERNAME)\$InstanceName" } 
 
# Backup-Kompression aktivieren 
Set-DbaSpConfigure -SqlInstance $sqlInst -Name 'DefaultBackupCompression' -Value 1 
 
# Operator anlegen 
New-DbaAgentOperator -SqlInstance $sqlInst -Name 'DBA-Team' -EmailAddress Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein.'

Erweiterung & Systemvoraussetzungen

Neue SQL-Version hinzufügen

• [Versions] Available= in settings.ini erweitern
• [Editions] ggf. neue Sektion für versionsspezifische Editionen
• [SerialNumbers] neue Schlüssel SQL<Version>_<Edition>
• Installationsmedien auf Share unter <SourceShare>\SQL<Version>\ bereitstellen

Neue Domäne konfigurieren

• [DiskLayout_<NETBIOSNAME>] Sektion in settings.ini anlegen
• [Collations] Domain_<NETBIOSNAME>=<Collation> eintragen
• [Monitoring] Domain_<NETBIOSNAME>=<Typ> eintragen (optional)

Collation-Liste anpassen

• Config\collations.txt öffnen
• Neue Zeile mit exaktem SQL-Server-Collationnamen eintragen
• #-Kommentarzeilen zur Strukturierung verwenden
• Tool neu starten – die Datei wird beim Start neu eingelesen
• Kein Eingriff in settings.ini erforderlich

dbaTools-Share umziehen oder aktualisieren

• [dbaTools] ShareBasePath= auf neues Basisverzeichnis setzen
• Sicherstellen dass beide Unterordner vorhanden sind: \dbatools und \dbatools.library
• Lokale Kopien in C:\Program Files\WindowsPowerShell\Modules\ löschen wenn ein Update eingespielt wird – das Tool kopiert beim nächsten Start automatisch neu

Systemvoraussetzungen