diff --git a/NDTrack/ANLEITUNG-Geprueft.md b/NDTrack/ANLEITUNG-Geprueft.md index 2a8cf6c..3e37465 100644 --- a/NDTrack/ANLEITUNG-Geprueft.md +++ b/NDTrack/ANLEITUNG-Geprueft.md @@ -24,7 +24,7 @@ In `Initialize-Configuration` konfiguriert: - `SourcePath`: `C:\SCAN\NDTRACK` mit dem vollständigen Windows-NDTrack-Paket. - `LinuxSourcePath`: `C:\SCAN\NDTRACK` mit dem vollständigen Linux-Paket. Die Startdatei muss eine gültige Shebang und Unix-Zeilenenden besitzen. Benötigte Binärdateien müssen für das Zielsystem passen und ausführbar sein. - `TestServers`: zunächst eigene Windows-Testserver eintragen. Leer verwendet die Windows-Option die Serverauswahl aus dem AD. Linux-Ziele kommen separat aus einer Textdatei mit einem DNS-Namen oder einer IPv4-Adresse pro Zeile; Leerzeilen und Zeilen mit führendem # werden ignoriert. -- `DestinationPath`: standardmäßig leer. Jeder Windows-Server verwendet sein eigenes Systemlaufwerk, z.B. D:\ndtrack oder E:\ndtrack. Optional einen festen lokalen Pfad eintragen. Verteilung und Einsammeln erfolgen über WinRM mit Copy-Item -ToSession/-FromSession; C$ oder andere administrative Freigaben sind nicht erforderlich. Die Löschfunktion akzeptiert nur einen dedizierten Ordner mit dem Namen ndtrack. +- `DestinationPath`: standardmäßig leer; Systemlaufwerk automatisch per WMI/DCOM. `ServerDestinationPaths` ist nur für optionale Ausnahmen. Option 1 kopiert wie im Original über administrative Freigaben. Die übrigen Windows-Aktionen verwenden weiterhin WinRM. Die Löschfunktion akzeptiert nur einen dedizierten Ordner mit dem Namen ndtrack. - Die alten RDS-Hilfsfunktionen werden von keinem Menüpunkt aufgerufen. Option 8 ist ausschließlich das Aufräumen auf Linux. Die CMD-/SH-Startdateien wurden nicht mitgeliefert. Sie müssen synchron bis zum Scan-Ende laufen, einen sinnvollen Exitcode zurückgeben und ihre Inventare unter dem jeweiligen ndtrack/inventory ablegen. Eine Startdatei, die einen Prozess nur im Hintergrund startet oder Fehler verschluckt, kann das übergeordnete Skript nicht zuverlässig bewerten. @@ -48,7 +48,7 @@ Set-Location 'C:\SCAN\SCRIPT' 8. Linux: NDTrack-Ordner entfernen, sofern keine Scan-Sperre oder erkannter laufender ndtrack-Prozess besteht. 0. Beenden. -Ergebnisse liegen unter `C:\SCAN\RESULTS`, Protokolle unter `C:\SCAN\SCRIPT\Logs` auf dem ausführenden Rechner. Das Task-Konto ist davon unabhängig. Auf den entfernten Windows-Servern bleibt der Zielpfad `\ndtrack`, damit auch Server ohne C: unterstützt werden. Jede Sammlung erzeugt einen separaten Ordner und überschreibt keine vorherigen Sammlungen. Das Alter der gesammelten Inventardateien wird ausdrücklich nicht bewertet. +Ergebnisse liegen unter `C:\SCAN\RESULTS`, Protokolle unter `C:\SCAN\SCRIPT\Logs` auf dem ausführenden Rechner. Das Task-Konto ist davon unabhängig. Auf den entfernten Windows-Servern wird standardmäßig `\ndtrack` automatisch per WMI/DCOM ermittelt. Jede Sammlung erzeugt einen separaten Ordner und überschreibt keine vorherigen Sammlungen. Das Alter der gesammelten Inventardateien wird ausdrücklich nicht bewertet. Eine `.ndtrack-running`-Sperre wird für direkte Scans angelegt und normalerweise entfernt. Nach einem Verbindungs-/Systemabbruch kann sie zurückbleiben. Erst den tatsächlichen Prozesszustand prüfen und dann eine verwaiste Sperre manuell entfernen. Extern gestartete Scans oder gleichzeitig gestartete Skriptinstanzen können nicht vollständig ausgeschlossen werden; das Skript bietet keine transaktionale Sperre über Verteilung, Task und Sammlung hinweg. @@ -76,32 +76,31 @@ AD-Abfrage und WinRM verwenden das aktuelle Windows-Konto. Das bei Option 2 eing Sieben isolierte Tests der Domänenauswahl bestanden; echte domänenübergreifende AD-/WinRM-Verbindungen wurden nicht getestet. Test: `pwsh -NoProfile -File ./NDTrack/tests/Test-DomainSelection.ps1`. -## Zielserver ohne Laufwerk C: — Beispiel SQL-Server +## Dynamischer Zielpfad ohne WinRM beim Kopieren -Die festen Pfade `C:\SCAN\...` gelten ausschließlich für den ausführenden Windows-Verwaltungsrechner. Dieser benötigt für die aktuelle Konfiguration ein Laufwerk C: und Schreibrechte in diesen Ordnern. Auf den entfernten Windows-Servern ist kein Laufwerk C: erforderlich. +`$script:DestinationPath = ''` ist die Standardeinstellung. Das Systemlaufwerk wird pro Windows-Zielserver aus `Win32_OperatingSystem.SystemDrive` über eine ausdrücklich auf DCOM eingestellte CIM-Verbindung ermittelt. Option 1 verwendet anschließend SMB für die Dateiübertragung: -Mit der Standardeinstellung `$script:DestinationPath = ''` ermittelt das Hauptskript bei jedem Zielserver dessen `$env:SystemDrive`. Es verwendet das Windows-Systemlaufwerk, nicht automatisch das Laufwerk mit SQL-Datenbanken oder das Laufwerk mit dem meisten freien Platz. +| Systemlaufwerk des Servers | Lokaler Zielordner | Kopierfreigabe | +|---|---|---| +| C: | `C:\ndtrack` | `\\SERVER\C$\ndtrack` | +| D: | `D:\ndtrack` | `\\SERVER\D$\ndtrack` | +| E: | `E:\ndtrack` | `\\SERVER\E$\ndtrack` | -Beispiel: Auf `SQL01` läuft Windows unter D:, ein Laufwerk C: existiert nicht: +Für einen SQL-Server ohne C: mit Windows auf D: wird damit automatisch D:\ndtrack verwendet. Maßgeblich ist das Windows-Systemlaufwerk, nicht das SQL-Datenlaufwerk. Es muss keine Serverliste mit Laufwerkszuordnungen gepflegt werden. `ServerDestinationPaths` bleibt standardmäßig leer und dient ausschließlich optionalen Ausnahmen; ein expliziter DestinationPath überschreibt die automatische Ermittlung. -| Menüoption | Verhalten auf SQL01 | -|---|---| -| 1 – Kopieren | Legt `D:\ndtrack` bei Bedarf an und kopiert die Quelldateien vom Verwaltungsrechner dorthin. | -| 2 – Task starten | Erstellt den Task `NDTRACK`, der `D:\ndtrack\RunNdTrackWindows_Local.cmd` mit Arbeitsverzeichnis `D:\ndtrack` startet. | -| 3 – Ergebnisse holen | Kopiert vorhandene Dateien aus `D:\ndtrack\inventory` in einen neuen Sammelordner unter `C:\SCAN\RESULTS\Windows-\SQL01` auf dem Verwaltungsrechner. | -| 7 – Aufräumen | Stoppt und entfernt den Task `NDTRACK` und entfernt anschließend den Ordner `D:\ndtrack`, sofern die Sicherheitsprüfungen keine laufende Nutzung feststellen. | +Voraussetzungen für Option 1: WMI/DCOM-Zugriff zur Laufwerksermittlung sowie Zugriff auf die administrative Freigabe mit dem aktuellen Windows-Konto. WinRM wird von Option 1 nicht verwendet. Ist die WMI-Abfrage oder die Freigabe nicht erreichbar, wird der Server mit einer Warnung übersprungen; das Skript rät kein Ersatzlaufwerk. Firewall-, DCOM- und Berechtigungseinstellungen werden nicht automatisch verändert. -Die Übertragung erfolgt über PowerShell-Remoting (WinRM). Administrative Freigaben wie `C$` oder `D$` werden nicht benötigt. Fehlen WinRM-Zugriff, Berechtigungen oder das ermittelte Laufwerk, wird für den betroffenen Server ein Fehler gemeldet; es erfolgt keine automatische Auswahl eines anderen Laufwerks. +Der Zielordner wird über die Freigabe angelegt. Eine vorhandene Scan-Sperre verhindert das Kopieren; der Task-Zustand wird hier nicht per WinRM geprüft. Option 1 nur ausführen, wenn kein Scan läuft. Optionen 2, 3 und 7 verwenden weiterhin WinRM, jedoch denselben ermittelten Zielpfad. -Wichtig für die mitgelieferte CMD: Sie muss ebenfalls ohne fest eingetragenes `C:\ndtrack` funktionieren und ihre Ergebnisse im Unterordner `inventory` des tatsächlichen NDTrack-Verzeichnisses ablegen. Das Hauptskript setzt das Arbeitsverzeichnis passend, korrigiert aber keine fest eingebauten Pfade innerhalb der CMD. Deren Inhalt wurde noch nicht geprüft. +Die CMD-Datei muss ohne fest eingebautes C:\ndtrack funktionieren. Ihre internen Pfade wurden nicht geprüft. Die festen C:\SCAN-Pfade gelten ausschließlich für den Verwaltungsrechner. Alte Installationen werden nicht automatisch migriert. -Ein expliziter Wert für `DestinationPath`, beispielsweise `E:\ndtrack`, überschreibt die automatische Ermittlung für alle Windows-Zielserver. Dieses Laufwerk muss dann auf jedem Zielserver vorhanden sein. Vorhandene Installationen auf einem anderen Laufwerk werden nicht automatisch verschoben. +Die simulierten Tests decken unterschiedliche Laufwerke, fehlende Freigaben, WMI-Fehler und das Schließen der CIM-Verbindungen ab. Ein echter Zielservertest steht aus; der zuvor gemeldete Anmeldefehler ist damit noch nicht nachweislich behoben. ## Prüfung und Grenzen - PowerShell-Syntax geprüft. - Alle acht Menüabläufe isoliert getestet. -- Geprüft: getrennte Menüaktionen für Kopieren, Starten und Einsammeln; Task-Entfernung vor Dateilöschung; native Exitcodes; Kontoabbruch; automatisches Systemlaufwerk pro Server und fester Zielpfad; Ablehnung ungültiger Hostnamen/Pfadsegmente. +- Geprüft: getrennte Menüaktionen für Kopieren, Starten und Einsammeln; Task-Entfernung vor Dateilöschung; native Exitcodes; Kontoabbruch; Standardzielpfad und explizite Zielpfade pro Server; Ablehnung ungültiger Hostnamen/Pfadsegmente. - Fehlerpfade mit simulierten Remote-/SSH-Fehlern geprüft: Warnung statt falscher Erfolgsmeldung. - Aktuelle Menü-/Fehlerprüfungen: 42 bestanden. Zusätzlich 3 simulierte Task-Start-Szenarien bestanden. Ordner-/Datei- und PreScript-Tests liegen separat vor. - Keine echten AD-, Windows-, RDS- oder Linux-Zielsysteme getestet. Die Tests ersetzen keinen Abnahmelauf mit den tatsächlichen NDTrack-Dateien. @@ -127,7 +126,6 @@ git commit -m "NDTrack: alle acht Ablaeufe und Fehlerbehandlung korrigieren" -- Es wurde von Codex nichts vorgemerkt, committed oder hochgeladen. -Bei einer bereits auf C:\ndtrack vorhandenen Installation auf einem anderen Laufwerk als dem Systemlaufwerk den bisherigen DestinationPath ausdrücklich konfigurieren. Es findet keine automatische Migration alter Installationen statt. Auch die CMD-Dateien selbst müssen ohne fest eingebautes C:\ndtrack auskommen; ihr Inhalt wurde nicht bereitgestellt. ## Separates PreScript @@ -158,3 +156,5 @@ Zusätzliche Dateien für Git: `NDTrack/PreScript.ps1` und `NDTrack/tests/Test-P Nach Umstieg wird ausschließlich der Task NDTRACK verwendet. Ein alter Task NDTrackTask aus einer früheren Version wird nicht automatisch migriert oder entfernt. Task-Start-Test: `pwsh -NoProfile -File ./NDTrack/tests/Test-TaskStart.ps1`. Auch diese Tests verwenden keine echten Server. + +SMB-Kopiertest: `pwsh -NoProfile -File ./NDTrack/tests/Test-SmbCopy.ps1` (simulierte Freigaben, keine Serverzugriffe). diff --git a/NDTrack/NDTrack-Geprueft.ps1 b/NDTrack/NDTrack-Geprueft.ps1 index c30133e..8011672 100644 --- a/NDTrack/NDTrack-Geprueft.ps1 +++ b/NDTrack/NDTrack-Geprueft.ps1 @@ -13,7 +13,8 @@ function Initialize-Configuration { $script:ScriptFolder = 'C:\SCAN\SCRIPT' $script:SourcePath = 'C:\SCAN\NDTRACK' $script:LinuxSourcePath = 'C:\SCAN\NDTRACK' - $script:DestinationPath = '' # Leer = Systemlaufwerk des jeweiligen Zielservers + \ndtrack + $script:DestinationPath = '' # Leer = Systemlaufwerk automatisch per WMI/DCOM ermitteln + $script:ServerDestinationPaths = @{} # Optional: @{ 'sql01.firma.example' = 'D:\ndtrack' } $script:TaskName = 'NDTRACK' $script:WindowsLauncher = 'RunNdTrackWindows_Local.cmd' $script:LinuxLauncher = 'RunNdTrackLinuxUnix_Local.sh' @@ -131,18 +132,31 @@ function GetLinuxServer { function Resolve-WindowsFolder { param([string]$Server) Assert-ServerName $Server - Invoke-Command -ComputerName $Server -ErrorAction Stop -ScriptBlock { - param($configured) - $ErrorActionPreference = 'Stop' - $folder = $configured - if (-not $folder) { - if ($env:SystemDrive -notmatch '^[A-Za-z]:$') { throw 'Systemlaufwerk nicht ermittelbar.' } - $folder = $env:SystemDrive + '\ndtrack' + $folder = $script:DestinationPath + $overrides = Get-Variable -Name ServerDestinationPaths -Scope Script -ErrorAction SilentlyContinue + if ($overrides -and $overrides.Value.ContainsKey($Server)) { $folder = $overrides.Value[$Server] } + if (-not $folder) { + $cimSession = $null + try { + $options = New-CimSessionOption -Protocol Dcom -ErrorAction Stop + $cimSession = New-CimSession -ComputerName $Server -SessionOption $options -ErrorAction Stop + $os = Get-CimInstance -CimSession $cimSession -ClassName Win32_OperatingSystem -Property SystemDrive -ErrorAction Stop + $drive = [string]$os.SystemDrive + if ($drive -notmatch '^[A-Za-z]:$') { throw 'Kein gueltiges Systemlaufwerk vom Zielserver erhalten.' } + $folder = $drive + '\ndtrack' + } catch { + throw "Systemlaufwerk von '$Server' konnte per WMI/DCOM nicht ermittelt werden: $($_.Exception.Message)" + } finally { + if ($null -ne $cimSession) { Remove-CimSession -CimSession $cimSession -ErrorAction SilentlyContinue } } - if ($folder -notmatch '^[A-Za-z]:\\[^"\r\n]+$' -or $folder -match '(?:^|\\)\.\.?(?:\\|$)') { throw 'Ungueltiger lokaler NDTrack-Zielpfad.' } - if (-not (Test-Path -LiteralPath ($folder.Substring(0,3)) -PathType Container)) { throw "Ziellaufwerk fehlt: $folder" } - $folder.TrimEnd('\') - } -ArgumentList $script:DestinationPath + } + if ($folder -notmatch '^[A-Za-z]:\\[^"\r\n]+$' -or $folder -match '(?:^|\\)\.\.?(?:\\|$)') { throw 'Ungueltiger lokaler NDTrack-Zielpfad.' } + $folder.TrimEnd('\') +} +function Get-WindowsSharePath { + param([string]$Server) + $folder = Resolve-WindowsFolder $Server + '\\{0}\{1}$\{2}' -f $Server,$folder.Substring(0,1),$folder.Substring(3) } function CheckDirectory { $paths = @($script:ScriptFolder,$script:SourcePath,$script:LinuxSourcePath, @@ -183,26 +197,23 @@ function CopyFile { param([string[]]$Servers) Test-SourceFiles -Path $script:SourcePath -Launcher $script:WindowsLauncher foreach ($server in $Servers) { - $session = $null try { - $remote = Resolve-WindowsFolder $server - $session = New-PSSession -ComputerName $server -ErrorAction Stop - # Kein Ueberschreiben waehrend eines bekannten Scans/Tasks. - Invoke-Command -Session $session -ErrorAction Stop -ScriptBlock { - param($folder,$taskName) - $ErrorActionPreference = 'Stop' - if (Test-Path -LiteralPath (Join-Path $folder '.ndtrack-running')) { throw 'Scan-Sperre vorhanden; laufenden Scan bzw. verwaiste Sperre pruefen.' } - $task = Get-ScheduledTask | Where-Object { $_.TaskName -eq $taskName -and $_.TaskPath -eq '\' } - if ($task -and $task.State -in @('Running','Queued')) { throw 'NDTrack-Task ist aktiv.' } - New-Item -Path $folder -ItemType Directory -Force | Out-Null - } -ArgumentList $remote,$script:TaskName + $folder = Resolve-WindowsFolder $server + $remote = '\\{0}\{1}$\{2}' -f $server,$folder.Substring(0,1),$folder.Substring(3) + $share = '\\{0}\{1}$' -f $server,$folder.Substring(0,1) + if (-not (Test-Path -LiteralPath $share -PathType Container -ErrorAction Stop)) { + throw "Freigabe nicht erreichbar: $share. Laufwerk, Freigabe und Berechtigungen pruefen." + } + if (Test-Path -LiteralPath ($remote + '\.ndtrack-running') -ErrorAction Stop) { + throw 'Scan-Sperre vorhanden; laufenden Scan bzw. verwaiste Sperre pruefen.' + } + New-Item -Path $remote -ItemType Directory -Force -ErrorAction Stop | Out-Null Get-ChildItem -LiteralPath $script:SourcePath -Force -ErrorAction Stop | Where-Object { $_.Name -notin @('inventory','Result','Ergebnisse','.ndtrack-running') } | - Copy-Item -Destination $remote -ToSession $session -Recurse -Force -ErrorAction Stop - Write-Host "KOPIERT: $server" + Copy-Item -Destination $remote -Recurse -Force -ErrorAction Stop + Write-Host "KOPIERT: $server -> $remote" $server } catch { Write-Warning "${server}: $($_.Exception.Message)" } - finally { if ($null -ne $session) { Remove-PSSession -Session $session } } } } function CreateScheduledTask { diff --git a/NDTrack/tests/Test-NDTrack.ps1 b/NDTrack/tests/Test-NDTrack.ps1 index 1b8362d..f42efa8 100644 --- a/NDTrack/tests/Test-NDTrack.ps1 +++ b/NDTrack/tests/Test-NDTrack.ps1 @@ -9,13 +9,16 @@ $script:checks=0 function Assert { param($Condition,$Message) if(-not $Condition){throw $Message}; $script:checks++ } function Invoke-Command { param($ComputerName,$ScriptBlock,[object[]]$ArgumentList,$ErrorAction) & $ScriptBlock @ArgumentList } function Test-Path { $true } -$priorSystemDrive=$env:SystemDrive -$env:SystemDrive='E:' +function New-CimSessionOption { param($Protocol,$ErrorAction) if($Protocol -ne 'Dcom'){throw 'Falsches Protokoll'}; 'DCOM' } +function New-CimSession { param($ComputerName,$SessionOption,$ErrorAction) $ComputerName } +function Get-CimInstance { [pscustomobject]@{SystemDrive='E:'} } +function Remove-CimSession { } +$script:ServerDestinationPaths=@{} $script:DestinationPath='' -Assert ((Resolve-WindowsFolder 'server01') -eq 'E:\ndtrack') 'Systemlaufwerk E nicht verwendet' -$env:SystemDrive='D:' -Assert ((Resolve-WindowsFolder 'server02') -eq 'D:\ndtrack') 'Systemlaufwerk nicht pro Server aufgeloest' -$env:SystemDrive=$priorSystemDrive +Assert ((Resolve-WindowsFolder 'server01') -eq 'E:\ndtrack') 'Automatisches Systemlaufwerk falsch' +$script:ServerDestinationPaths=@{'server02'='E:\ndtrack'} +Assert ((Get-WindowsSharePath 'server02') -eq '\\server02\E$\ndtrack') 'Server-Ausnahme falsch' +$script:ServerDestinationPaths=@{} $script:DestinationPath='D:\Tools\ndtrack' Assert ((Resolve-WindowsFolder 'server01') -eq 'D:\Tools\ndtrack') 'Dynamischer Zielpfad falsch' $rejected=$false diff --git a/NDTrack/tests/Test-SmbCopy.ps1 b/NDTrack/tests/Test-SmbCopy.ps1 new file mode 100644 index 0000000..b23aeec --- /dev/null +++ b/NDTrack/tests/Test-SmbCopy.ps1 @@ -0,0 +1,34 @@ +$ErrorActionPreference='Stop' +. (Join-Path (Split-Path $PSScriptRoot -Parent) 'NDTrack-Geprueft.ps1') -LibraryOnly +$script:DestinationPath=''; $script:ServerDestinationPaths=@{} +$script:removed=0; $script:wmiFail=$false +function New-CimSessionOption { param($Protocol,$ErrorAction) if($Protocol -ne 'Dcom'){throw 'WinRM statt DCOM verwendet'}; 'DCOM' } +function New-CimSession { param($ComputerName,$SessionOption,$ErrorAction) $ComputerName } +function Get-CimInstance { param($CimSession,$ClassName,$Property,$ErrorAction) + if($script:wmiFail){throw 'WMI nicht erreichbar'} + if($CimSession -eq 'sql01.example'){[pscustomobject]@{SystemDrive='D:'}}else{[pscustomobject]@{SystemDrive='C:'}} +} +function Remove-CimSession { $script:removed++ } + +$script:SourcePath='source'; $script:WindowsLauncher='Run.cmd' +$script:copied=@(); $script:shareAvailable=$true +function Test-SourceFiles { } +function Invoke-Command { throw 'WinRM darf beim Kopieren nicht verwendet werden' } +function New-PSSession { throw 'Keine WinRM-Sitzung erlaubt' } +function Test-Path { param($LiteralPath,$PathType,$ErrorAction) if($LiteralPath -like '*.ndtrack-running'){return $false}; $script:shareAvailable } +function New-Item { } +function Get-ChildItem { [pscustomobject]@{Name='Run.cmd'} } +function Copy-Item { param([Parameter(ValueFromPipeline)]$InputObject,$Destination,[switch]$Recurse,[switch]$Force) process {$script:copied += $Destination} } +$result=@(CopyFile @('win01.example','sql01.example')) +if(($result -join ',') -ne 'win01.example,sql01.example'){throw 'Falsche Erfolgsrueckgabe'} +if(($script:copied -join ',') -ne '\\win01.example\C$\ndtrack,\\sql01.example\D$\ndtrack'){throw 'Falsche SMB-Ziele'} +$script:shareAvailable=$false; $script:copied=@() +$result=@(CopyFile @('win01.example')) +if($result.Count -or $script:copied.Count){throw 'Kopiert trotz fehlender Freigabe'} +Write-Host 'SMB-Kopieren: Standard C$, Ausnahme D$, Fehlerfall und keine WinRM-Aufrufe geprueft.' + +$script:shareAvailable=$true; $script:wmiFail=$true; $script:copied=@() +$result=@(CopyFile @('sql01.example')) +if($result.Count -or $script:copied.Count){throw 'Kopiert trotz WMI-Fehler'} +if($script:removed -ne 4){throw 'CIM-Sitzungen nicht bereinigt'} +Write-Host 'Dynamische Laufwerke C:/D:, WMI-Fehler und Sitzungsbereinigung bestanden.'