This commit is contained in:
Madzone
2026-10-13 15:13:34 +02:00
parent 3bc149a3e6
commit c286614cfd
4 changed files with 98 additions and 50 deletions
+17 -17
View File
@@ -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 `<Systemlaufwerk>\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 `<Systemlaufwerk>\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-<Kennung>\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).
+38 -27
View File
@@ -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 {
+9 -6
View File
@@ -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
+34
View File
@@ -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.'