From ae8f4037150dc21002453ff2e22336ee22d9ac7a Mon Sep 17 00:00:00 2001 From: Madzone Date: Fri, 9 Oct 2026 14:55:47 +0200 Subject: [PATCH] Update --- NDTrack/ANLEITUNG-Geprueft.md | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/NDTrack/ANLEITUNG-Geprueft.md b/NDTrack/ANLEITUNG-Geprueft.md index c90a8f4..c7e27b4 100644 --- a/NDTrack/ANLEITUNG-Geprueft.md +++ b/NDTrack/ANLEITUNG-Geprueft.md @@ -9,6 +9,7 @@ Auf dem Mac bearbeiten, auf einem Windows-Verwaltungsrechner mit Windows PowerSh Ablage auf dem ausführenden Windows-Verwaltungsrechner: ```text +C:\SCAN\SCRIPT\PreScript.ps1 C:\SCAN\SCRIPT\NDTrack-Geprueft.ps1 C:\SCAN\SCRIPT\Logs\ C:\SCAN\NDTRACK\RunNdTrackWindows_Local.cmd @@ -16,25 +17,25 @@ C:\SCAN\NDTRACK\RunNdTrackLinuxUnix_Local.sh C:\SCAN\RESULTS\ ``` -Das Skript vom Mac nach `C:\SCAN\SCRIPT` kopieren. Die vollständigen NDTrack-Pakete liegen unter `C:\SCAN\NDTRACK`; für Linux wird die SH-Datei nur bei Verwendung der Linux-Optionen benötigt. Bei gleichnamigen, unterschiedlichen Paketdateien separate Quellunterordner verwenden und die beiden Quellpfade entsprechend anpassen. SCRIPT-, NDTRACK-, RESULTS- und Logordner werden beim Start geprüft und bei Bedarf angelegt. Existiert unter einem dieser Pfade eine Datei statt eines Ordners, wird abgebrochen. Anschließend muss NDTRACK mindestens eine Datei enthalten (Unterordner werden mit durchsucht); andernfalls endet das Skript vor dem Menü mit einem Hinweis zum Ablegen des Pakets. Vor der Windows- oder Linux-Verteilung wird zusätzlich geprüft, ob die jeweils benötigte CMD-/SH-Startdatei vorhanden und nicht leer ist. Die Prüfung bewertet nicht die Vollständigkeit oder Funktionsfähigkeit aller Paketdateien. Der ausführende Benutzer braucht dort Schreibrechte. Die Pfade sind jetzt bewusst unabhängig vom Benutzerprofil. +Das Skript vom Mac nach `C:\SCAN\SCRIPT` kopieren. Die vollständigen NDTrack-Pakete liegen unter `C:\SCAN\NDTRACK`; für Linux wird die SH-Datei nur bei Verwendung der Linux-Optionen benötigt. Bei gleichnamigen, unterschiedlichen Paketdateien separate Quellunterordner verwenden und die beiden Quellpfade entsprechend anpassen. Beim empfohlenen Start über das PreScript müssen SCRIPT-, NDTRACK-, RESULTS- und Logordner bereits vorhanden sein: Das PreScript prüft nur und legt nichts an. Das Hauptskript besitzt zusätzlich eine eigene Ordnerprüfung, die bei direktem Start fehlende Ordner anlegen kann. Existiert unter einem dieser Pfade eine Datei statt eines Ordners, wird abgebrochen. Anschließend muss NDTRACK mindestens eine Datei enthalten (Unterordner werden mit durchsucht); andernfalls endet das Skript vor dem Menü mit einem Hinweis zum Ablegen des Pakets. Vor der Windows- oder Linux-Verteilung wird zusätzlich geprüft, ob die jeweils benötigte CMD-/SH-Startdatei vorhanden und nicht leer ist. Die Prüfung bewertet nicht die Vollständigkeit oder Funktionsfähigkeit aller Paketdateien. Der ausführende Benutzer braucht dort Schreibrechte. Die Pfade sind jetzt bewusst unabhängig vom Benutzerprofil. 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 AD bzw. RDS. 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. +- `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. -- Nur für die nicht mehr im Menü verwendeten RDS-Hilfsfunktionen: `RDSConnectionBroker` und `RDSLauncherPath`: bekannte Werte eintragen oder bei Option 8 eingeben. Der RDS-Pfad muss vom Zielserver erreichbar sein. Für UNC-Pfade muss der Remote-Kontext Zugriff besitzen; normale WinRM-Anmeldung garantiert keine Weitergabe von Anmeldedaten an einen dritten Server. Bevorzugt eine bereits lokal bereitgestellte CMD verwenden. +- 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. RDS verwendet seine gesondert konfigurierte CMD; deren Ergebnisablage ist gesondert zu prüfen. +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. ## Ausführen -In Windows PowerShell: +Empfohlener Start in Windows PowerShell über die Vorprüfung: ```powershell Set-Location 'C:\SCAN\SCRIPT' -.\NDTrack-Geprueft.ps1 +.\PreScript.ps1 -Platform Windows ``` 1. Windows: NDTrack-Dateien auf die AD-Server kopieren. Startet keinen Scan. @@ -51,6 +52,27 @@ Ergebnisse liegen unter `C:\SCAN\RESULTS`, Protokolle unter `C:\SCAN\SCRIPT\Logs 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. +## Zielserver ohne Laufwerk C: — Beispiel SQL-Server + +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. + +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. + +Beispiel: Auf `SQL01` läuft Windows unter D:, ein Laufwerk C: existiert nicht: + +| 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. | + +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. + +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. + +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. + ## Prüfung und Grenzen - PowerShell-Syntax geprüft.