Files
syno-scripts/NDTrack/ANLEITUNG-Geprueft.md
T
2026-10-15 14:46:41 +02:00

171 lines
15 KiB
Markdown

# Korrigierte Kopie: alle acht Optionen
Datei: `NDTrack-Geprueft.ps1`, Version **1.0.3** (2026-10-15). 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:
```text
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; Systemlaufwerk automatisch per WMI/DCOM. `ServerDestinationPaths` ist nur für optionale Ausnahmen. Option 1 kopiert wie im Original über administrative Freigaben. Option 2 verwendet Task-Scheduler-RPC und schtasks.exe; Optionen 3 und 7 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.
## Ausführen
Empfohlener Start in Windows PowerShell über die Vorprüfung:
```powershell
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 mit dem eingegebenen Benutzerkonto über den ursprünglichen schtasks.exe-Aufruf erstellen. Einmaliger Start nach fünf Minuten, kein sofortiger /Run-Aufruf. CMD muss aus Option 1 vorhanden sein. Kein XML, kein SYSTEM, kein WinRM. Wie im Original überschreibt /F einen vorhandenen Task; nur bei nicht laufendem Scan verwenden.
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.
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 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.
## Einsatz in unterschiedlichen AD-Domänen
Das Hauptskript enthält keine fest vorgegebene Kundendomäne. Bei leeren Werten für `TargetDomain` und `DomainController` verwendet es `USERDNSDOMAIN`, also die DNS-Domäne des ausführenden Windows-Benutzers. Die Suchbasis wird aus dem AD selbst ermittelt. Es werden aktivierte Windows-Server der ausgewählten Domäne über ihre vollständigen DNS-Hostnamen angesprochen. Es erfolgt keine automatische Suche über alle Domänen einer Gesamtstruktur.
Für eine andere Domäne in `Initialize-Configuration` setzen, zum Beispiel:
```powershell
$script:TargetDomain = 'firma.example'
$script:DomainController = ''
```
Optional einen bestimmten DC angeben:
```powershell
$script:TargetDomain = 'firma.example'
$script:DomainController = 'dc01.firma.example'
```
Die Namen sind Beispiele und müssen durch die tatsächlichen DNS-Namen ersetzt werden. Bei beiden Angaben prüft das Skript, ob der DC zur angegebenen Domäne gehört. Ohne automatisch erkennbare Benutzerdomäne und ohne explizite Konfiguration bricht die AD-Auswahl mit einem Hinweis ab. Eine explizite `TestServers`-Liste umgeht die AD-Suche.
AD-Abfrage und WinRM verwenden das aktuelle Windows-Konto. Option 2 fragt das Ausführungskonto für den Task ab; Remote-Verwaltung erfolgt weiterhin mit dem aktuell angemeldeten Windows-Konto. DNS, Netzwerkzugriff und Berechtigungen müssen in der Zieldomäne vorhanden sein. Bei nicht vertrauenswürdigen Domänen reicht die Angabe des Domänennamens allein nicht; das Skript richtet keine Vertrauensstellung oder alternative WinRM-Anmeldung ein. Es kann auf einem passend berechtigten Verwaltungsrechner der jeweiligen Domäne verwendet werden. Linux-Ziele bleiben unabhängig davon in der Textdatei definiert.
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`.
## Dynamischer Zielpfad ohne WinRM beim Kopieren
`$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:
| Systemlaufwerk des Servers | Lokaler Zielordner | Kopierfreigabe |
|---|---|---|
| C: | `C:\ndtrack` | `\\SERVER\C$\ndtrack` |
| D: | `D:\ndtrack` | `\\SERVER\D$\ndtrack` |
| E: | `E:\ndtrack` | `\\SERVER\E$\ndtrack` |
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.
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.
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. Option 2 verwendet ebenfalls kein WinRM mehr: ursprünglicher schtasks.exe /Create-Aufruf mit Benutzerkonto und einmaligem Start nach fünf Minuten. Optionen 3 und 7 verwenden weiterhin WinRM. Alle verwenden denselben ermittelten Zielpfad.
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.
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; Task-Aufruf ohne Kontoabfrage; 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: 41 bestanden. Zusätzlich 4 simulierte Task-Start-Szenarien für schtasks.exe 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:
```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
```bash
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.
## 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`
```powershell
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:
```powershell
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.
SMB-Kopiertest: `pwsh -NoProfile -File ./NDTrack/tests/Test-SmbCopy.ps1` (simulierte Freigaben, keine Serverzugriffe).
## Version 1.0.3: ursprüngliche Task-Erstellung wiederhergestellt
Option 2 verwendet wieder /Create /S /TN /TR /SC Once /ST /RU /RP /RL HIGHEST /F wie das Original. Taskname NDTRACK, dynamischer Zielpfad und Exitcode-Prüfung bleiben erhalten. Benutzerkonto und Kennwort werden wieder abgefragt. Der Start erfolgt nach fünf Minuten; es gibt keinen zusätzlichen Sofortstart. Die Zeit wird auf dem Verwaltungsrechner berechnet und auf dem Zielserver als lokale Uhrzeit verwendet; gleiche Zeitzone und synchronisierte Uhren werden vorausgesetzt. Bei Überschreiten der Tagesgrenze wird vor Erstellung abgebrochen; nach Mitternacht erneut ausführen.
Kein XML und kein SYSTEM-Konto. Wie im Original wird kein Arbeitsverzeichnis in der Taskdefinition gesetzt. Die CMD muss selbst in ihren Ordner wechseln oder absolute Pfade verwenden. Ein vorhandener Task wird mit /F überschrieben; eine zusätzliche Remote-Zustandsabfrage ist nicht mehr vorgeschaltet. Option 2 daher nicht während eines laufenden Scans erneut ausführen.
Die CMD wird vorab über SMB auf Vorhandensein geprüft. Das Kennwort wird wie im Original als /RP-Argument übergeben. RPC-Taskverwaltung und das verwendete Task-Konto benötigen weiterhin die passenden Rechte. Die Rückkehr zum Originalaufruf ist keine bestätigte Behebung des Anmeldesitzungsfehlers; hierfür ist der Test auf deinen Windows-Servern erforderlich.
41 Ablauf-/Fehlerprüfungen und vier Task-Szenarien bestanden. Option 1 und PreScript unverändert.