Files
syno-scripts/NDTrack/ANLEITUNG-Geprueft.md
T
2026-10-09 14:55:47 +02:00

12 KiB
Raw Blame History

Korrigierte Kopie: alle acht Optionen

Datei: NDTrack-Geprueft.ps1. Das Original und die vorherige Fassung bleiben unverändert.

Vor dem Einsatz

Auf dem Mac bearbeiten, auf einem Windows-Verwaltungsrechner mit Windows PowerShell 5.1 oder geeigneter Windows-PowerShell-Umgebung ausführen. AD-Zugriff und WinRM-Berechtigungen werden benötigt. Linux benötigt SSH und SCP im Suchpfad. Die bisherige RDS-Option ist nicht mehr im Menü; die alten Hilfsfunktionen bleiben unaufgerufen erhalten. Das Skript ändert keine Ausführungsrichtlinien oder Serverkonfigurationen.

Ablage auf dem ausführenden Windows-Verwaltungsrechner:

C:\SCAN\SCRIPT\PreScript.ps1
C:\SCAN\SCRIPT\NDTrack-Geprueft.ps1
C:\SCAN\SCRIPT\Logs\
C:\SCAN\NDTRACK\RunNdTrackWindows_Local.cmd
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. 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 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.
  • 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.

Ausführen

Empfohlener Start in Windows PowerShell über die Vorprüfung:

Set-Location 'C:\SCAN\SCRIPT'
.\PreScript.ps1 -Platform Windows
  1. Windows: NDTrack-Dateien auf die AD-Server kopieren. Startet keinen Scan.
  2. Windows: Task NDTRACK unter dem abgefragten Konto erstellen und sofort mit Start-ScheduledTask starten. Kopiert keine Dateien. Die CMD muss aus Option 1 bereits vorhanden sein. Ein aktiver Task wird nicht überschrieben. Kein zeitgesteuerter zweiter Start; der Task hat keinen Trigger.
  3. Windows: vorhandene Scan-Dateien nach C:\SCAN\RESULTS holen. Aktive bzw. fehlerhafte Tasks verhindern das Einsammeln.
  4. Linux: NDTrack-Dateien über SCP kopieren. Startet keinen Scan.
  5. Linux: zuvor bereitgestellten Scan per SSH starten und auf Abschluss warten. Verwendet keinen Windows-Scheduled-Task.
  6. Linux: vorhandene Scan-Dateien nach C:\SCAN\RESULTS holen.
  7. Windows: Task NDTRACK stoppen/entfernen, danach den NDTrack-Ordner löschen. Bei Fehlern beim Entfernen des Tasks keine Dateilöschung.
  8. Linux: NDTrack-Ordner entfernen, sofern keine Scan-Sperre oder erkannter laufender ndtrack-Prozess besteht.
  9. 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.

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-<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.

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.
  • 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.
  • 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.

Tests auf Mac oder Windows mit PowerShell:

pwsh -NoProfile -File ./NDTrack/tests/Test-NDTrack.ps1
pwsh -NoProfile -File ./NDTrack/tests/Test-SourceFolders.ps1

Der Befehl gilt aus dem Repository-Hauptordner. Die Tests führen ausschließlich lokale PowerShell-Kindprozesse und Simulationen aus; keine Zielserverzugriffe.

Git im bestehenden Repository

cd '/Users/michaeltroebs/Documents/GIT/syno-scripts'
git status --short
git add NDTrack/NDTrack-Geprueft.ps1 NDTrack/ANLEITUNG-Geprueft.md NDTrack/tests/Test-NDTrack.ps1 NDTrack/tests/Test-SourceFolders.ps1
git diff --cached -- NDTrack/NDTrack-Geprueft.ps1 NDTrack/ANLEITUNG-Geprueft.md NDTrack/tests/Test-NDTrack.ps1 NDTrack/tests/Test-SourceFolders.ps1
git commit -m "NDTrack: alle acht Ablaeufe und Fehlerbehandlung korrigieren" -- NDTrack/NDTrack-Geprueft.ps1 NDTrack/ANLEITUNG-Geprueft.md NDTrack/tests/Test-NDTrack.ps1 NDTrack/tests/Test-SourceFolders.ps1

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

PreScript.ps1 prüft ausschließlich vorhandene Ordner und Dateien. Es legt keine Ordner an und kopiert keine Dateien. Vorab bereitstellen:

  • C:\SCAN\SCRIPT mit PreScript.ps1 und NDTrack-Geprueft.ps1
  • C:\SCAN\SCRIPT\Logs
  • C:\SCAN\NDTRACK mit dem vollständigen NDTrack-Paket
  • C:\SCAN\RESULTS
Set-Location 'C:\SCAN\SCRIPT'
.\PreScript.ps1 -Platform Windows

Für beide Pakete -Platform Both, für Linux -Platform Linux. Bei erfolgreicher Prüfung startet das PreScript automatisch das Hauptskript und damit dessen Menü. Eine Scan-Option wird nicht automatisch ausgewählt. Bei fehlenden Ordnern, fehlenden Dateien, leeren Startdateien oder Syntaxfehlern im Hauptskript wird abgebrochen; das Hauptskript startet nicht.

Die Prüfung bestätigt nicht die vollständige Paketintegrität oder die Erreichbarkeit der Zielserver. Das gestartete Hauptskript besitzt weiterhin seine eigenen Prüfungen und führt erst nach der Menüauswahl die entsprechende Aktion aus.

-BasePath dient isolierten Tests und ändert nicht die Konfiguration des Hauptskripts. Sechs Szenarien wurden mit temporären Dateien und einem harmlosen Test-Hauptskript erfolgreich geprüft, einschließlich automatischem Start und Verzicht auf Ordneranlage:

pwsh -NoProfile -File ./NDTrack/tests/Test-PreScript.ps1

Zusätzliche Dateien für Git: NDTrack/PreScript.ps1 und NDTrack/tests/Test-PreScript.ps1.

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.