From 1b3e50cd322304301b05113293b3436f3025ada8 Mon Sep 17 00:00:00 2001 From: Madzone Date: Thu, 15 Oct 2026 13:11:00 +0200 Subject: [PATCH] function Get-VeeamConfig { MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit <# .SYNOPSIS Lädt zentrale Veeam Konfiguration aus JSON. #> param( [string]$Path = (Join-Path ( Split-Path $PSScriptRoot -Parent )"Config\VeeamConfig.json") ) if(!(Test-Path $Path)) { throw ` "Konfigurationsdatei nicht gefunden: $Path" } $Content = Get-Content ` -Path $Path ` -Raw $Configuration = $Content | ConvertFrom-Json return $Configuration } --- NDTrack/ANLEITUNG-Geprueft.md | 18 ++++++--- NDTrack/NDTrack-Geprueft.ps1 | 68 ++++++++++++++++++++++++-------- NDTrack/tests/Test-TaskStart.ps1 | 46 +++++++++++++++------ 3 files changed, 98 insertions(+), 34 deletions(-) diff --git a/NDTrack/ANLEITUNG-Geprueft.md b/NDTrack/ANLEITUNG-Geprueft.md index 3e37465..bb00419 100644 --- a/NDTrack/ANLEITUNG-Geprueft.md +++ b/NDTrack/ANLEITUNG-Geprueft.md @@ -1,6 +1,6 @@ # Korrigierte Kopie: alle acht Optionen -Datei: `NDTrack-Geprueft.ps1`. Das Original und die vorherige Fassung bleiben unverändert. +Datei: `NDTrack-Geprueft.ps1`, Version **1.0.1** (2026-10-15). Das Original und die vorherige Fassung bleiben unverändert. ## Vor dem Einsatz @@ -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; 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. +- `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. @@ -39,7 +39,7 @@ Set-Location 'C:\SCAN\SCRIPT' ``` 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. +2. Windows: Task **NDTRACK** unter dem abgefragten Konto erstellen und sofort mit `schtasks.exe /Run` starten. Die Erstellung erfolgt wie im Original über `schtasks.exe /Create /S`, hier mit einer temporären XML-Definition für das Arbeitsverzeichnis. 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. @@ -90,7 +90,7 @@ Für einen SQL-Server ohne C: mit Windows auf D: wird damit automatisch D:\ndtra 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. Optionen 2, 3 und 7 verwenden weiterhin WinRM, jedoch denselben ermittelten Zielpfad. +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: Task-Zustand über Task-Scheduler-RPC prüfen, dann schtasks.exe /Create und /Run. 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. @@ -102,7 +102,7 @@ Die simulierten Tests decken unterschiedliche Laufwerke, fehlende Freigaben, WMI - 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; 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. +- Aktuelle Menü-/Fehlerprüfungen: 42 bestanden. Zusätzlich 5 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: @@ -158,3 +158,11 @@ Nach Umstieg wird ausschließlich der Task NDTRACK verwendet. Ein alter Task NDT 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). + +## Änderung in Version 1.0.1: Option 2 ohne WinRM + +Das aktuelle Windows-Konto benötigt Rechte für die Remote-Aufgabenplanung und Zugriff auf die administrative Freigabe. Das abgefragte Konto ist weiterhin ausschließlich das Ausführungskonto für NDTRACK. Die Remote-Task-Verwaltung muss per RPC erreichbar sein; eine WinRM-Berechtigung wird für Option 2 nicht mehr benötigt. Vor einer Änderung wird der Task-Zustand über die Windows-Task-Scheduler-Schnittstelle geprüft. Ein aktiver Task wird nicht überschrieben. + +Die temporäre XML enthält das dynamische Zielverzeichnis als Arbeitsverzeichnis, keinen Zeittrigger und kein Passwort. Das Passwort wird wie im Original als /RP-Argument an schtasks.exe übergeben und nicht absichtlich protokolliert; Prozessüberwachung kann Befehlszeilen dennoch erfassen. Die XML wird nach Erfolg oder Fehler entfernt. Ein Fehler beim Erstellen verhindert den Start; Fehler beim Start werden ausdrücklich gemeldet. Fehlermeldungen nennen jetzt die genaue Phase. + +Die Umstellung entfernt die WinRM-Abhängigkeit, ersetzt jedoch keine Rechte oder Kennwortrichtlinien für Tasks. Der vorherige Fehler wurde nicht auf einem echten Zielserver nachgestellt; ein Praxistest ist weiterhin notwendig. PreScript und Option 1 sind unverändert. diff --git a/NDTrack/NDTrack-Geprueft.ps1 b/NDTrack/NDTrack-Geprueft.ps1 index b6a7e67..6d0c017 100644 --- a/NDTrack/NDTrack-Geprueft.ps1 +++ b/NDTrack/NDTrack-Geprueft.ps1 @@ -1,5 +1,5 @@ #Requires -Version 5.1 -# Skriptversion: 1.0.0 +# Skriptversion: 1.0.1 # Versionsstand: 2026-10-15 <# Korrigierte Kopie auf Basis des Originalskripts, mit denselben acht Optionen. @@ -33,7 +33,7 @@ function Initialize-Configuration { function ShowMenu { Write-Host @' -NDTRACK - Version 1.0.0 (Stand: 2026-10-15) +NDTRACK - Version 1.0.1 (Stand: 2026-10-15) 1: Windows - NDTrack-Dateien auf Server kopieren 2: Windows - Task NDTRACK erstellen und sofort starten @@ -220,27 +220,63 @@ function CopyFile { } catch { Write-Warning "${server}: $($_.Exception.Message)" } } } +function Assert-TaskNotRunning { + param([string]$Server,[string]$Name) + $service=$null; $root=$null; $tasks=$null + try { + $service = New-Object -ComObject 'Schedule.Service' -ErrorAction Stop + $service.Connect($Server) + $root = $service.GetFolder('\') + $tasks = $root.GetTasks(1) + foreach ($task in $tasks) { + try { + if ($task.Name -ieq $Name -and $task.State -in @(2,4)) { throw 'NDTRACK-Task ist bereits aktiv.' } + } finally { [void][Runtime.InteropServices.Marshal]::ReleaseComObject($task) } + } + } finally { + foreach ($item in @($tasks,$root,$service)) { + if ($null -ne $item) { [void][Runtime.InteropServices.Marshal]::ReleaseComObject($item) } + } + } +} function CreateScheduledTask { param([string[]]$Servers,[pscredential]$Credential) if ($null -eq $Credential) { throw 'Kein Task-Konto angegeben.' } foreach ($server in $Servers) { + $xmlFile = $null + $stage = 'Zielpfad ermitteln' try { $folder = Resolve-WindowsFolder $server - Invoke-Command -ComputerName $server -ErrorAction Stop -ScriptBlock { - param($folder,$launcher,$name,[pscredential]$credential) - $ErrorActionPreference = 'Stop' - $path = Join-Path $folder $launcher - if (-not (Test-Path -LiteralPath $path -PathType Leaf)) { throw 'CMD fehlt.' } - $action = New-ScheduledTaskAction -Execute "$env:SystemRoot\System32\cmd.exe" -Argument ('/d /s /c ""{0}""' -f $path) -WorkingDirectory $folder - $existing = Get-ScheduledTask | Where-Object { $_.TaskName -eq $name -and $_.TaskPath -eq '\' } - if ($existing -and $existing.State -in @('Running','Queued')) { throw 'NDTRACK-Task ist bereits aktiv.' } - if (Test-Path -LiteralPath (Join-Path $folder '.ndtrack-running')) { throw 'Ein direkter Scan ist aktiv oder die Sperre ist verwaist.' } - $settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew - Register-ScheduledTask -TaskName $name -TaskPath '\' -Action $action -Settings $settings -User $credential.UserName -Password $credential.GetNetworkCredential().Password -RunLevel Highest -Force | Out-Null - Start-ScheduledTask -TaskName $name -TaskPath '\' -ErrorAction Stop - } -ArgumentList $folder,$script:WindowsLauncher,$script:TaskName,$Credential + $share = '\\{0}\{1}$\{2}' -f $server,$folder.Substring(0,1),$folder.Substring(3) + $stage = 'CMD und Scan-Sperre ueber SMB pruefen' + if (-not (Test-Path -LiteralPath ($share + '\' + $script:WindowsLauncher) -PathType Leaf -ErrorAction Stop)) { throw 'CMD fehlt; zuerst Option 1 ausfuehren.' } + if (Test-Path -LiteralPath ($share + '\.ndtrack-running') -ErrorAction Stop) { throw 'Scan-Sperre vorhanden.' } + $stage = 'Task-Zustand ueber Task-Scheduler-RPC pruefen' + Assert-TaskNotRunning -Server $server -Name $script:TaskName + # XML erhaelt das Arbeitsverzeichnis und verhindert einen zweiten zeitgesteuerten Start. + $escapedFolder = [Security.SecurityElement]::Escape($folder) + $escapedUser = [Security.SecurityElement]::Escape($Credential.UserName) + $arguments = [Security.SecurityElement]::Escape(('/d /s /c ""{0}\{1}""' -f $folder,$script:WindowsLauncher)) + $xml = @" + + + + $escapedUserPasswordHighestAvailable + IgnoreNewfalsefalsetruetrue + %SystemRoot%\System32\cmd.exe$arguments$escapedFolder + +"@ + $xmlFile = [IO.Path]::GetTempFileName() + [IO.File]::WriteAllText($xmlFile,$xml,[Text.Encoding]::Unicode) + $stage = 'Task mit schtasks.exe registrieren' + # Aktuelles Konto verwaltet den Remote-Task; Credential ist nur das Ausfuehrungskonto. + # Passwort wie beim Original nur an /RP uebergeben, nie in XML oder Log schreiben. + Invoke-NativeChecked 'schtasks.exe' @('/Create','/S',$server,'/TN',$script:TaskName,'/XML',$xmlFile,'/RU',$Credential.UserName,'/RP',$Credential.GetNetworkCredential().Password,'/F') + $stage = 'Task mit schtasks.exe starten' + Invoke-NativeChecked 'schtasks.exe' @('/Run','/S',$server,'/TN',$script:TaskName) Write-Host "START ANGEFORDERT: $server - Task NDTRACK erstellt und Start ausgeloest; Scan-Abschluss noch nicht bestaetigt." - } catch { Write-Warning "${server}: $($_.Exception.Message)" } + } catch { Write-Warning "${server}: $stage fehlgeschlagen: $($_.Exception.Message)" } + finally { if ($xmlFile -and (Test-Path -LiteralPath $xmlFile)) { Remove-Item -LiteralPath $xmlFile -Force -ErrorAction SilentlyContinue } } } } function Invoke-WindowsScan { diff --git a/NDTrack/tests/Test-TaskStart.ps1 b/NDTrack/tests/Test-TaskStart.ps1 index 0597168..b2c6976 100644 --- a/NDTrack/tests/Test-TaskStart.ps1 +++ b/NDTrack/tests/Test-TaskStart.ps1 @@ -1,22 +1,42 @@ $ErrorActionPreference='Stop' . (Join-Path (Split-Path $PSScriptRoot -Parent) 'NDTrack-Geprueft.ps1') -LibraryOnly $script:TaskName='NDTRACK'; $script:WindowsLauncher='Run.cmd' -$script:events=@(); $script:hasFile=$true; $script:running=$false -function Resolve-WindowsFolder { '/simulated/ndtrack' } -function Invoke-Command { param($ComputerName,$ScriptBlock,[object[]]$ArgumentList,$ErrorAction) & $ScriptBlock @ArgumentList } -function Test-Path { param($LiteralPath,$PathType) if($LiteralPath -like '*.ndtrack-running'){return $false}; $script:hasFile } -function Get-ScheduledTask { if($script:running){[pscustomobject]@{TaskName='NDTRACK';TaskPath='\';State='Running'}} } -function New-ScheduledTaskAction { 'action' } -function New-ScheduledTaskSettingsSet { 'settings' } -function Register-ScheduledTask { param($TaskName) if($TaskName -ne 'NDTRACK'){throw 'Falscher Taskname'}; $script:events+='register' } -function Start-ScheduledTask { param($TaskName) if($TaskName -ne 'NDTRACK'){throw 'Falscher Taskname'}; $script:events+='start' } -$credential=[pscredential]::new('test',(ConvertTo-SecureString 'test' -AsPlainText -Force)) +$script:events=@(); $script:hasFile=$true; $script:running=$false; $script:failCreate=$false; $script:failRun=$false +function Resolve-WindowsFolder { 'D:\ndtrack' } +function Invoke-Command { throw 'WinRM darf nicht aufgerufen werden' } +function Test-Path { param($LiteralPath,$PathType,$ErrorAction) + if($LiteralPath -like '*.ndtrack-running'){return $false} + if($LiteralPath -like '\\*'){return $script:hasFile} + Microsoft.PowerShell.Management\Test-Path -LiteralPath $LiteralPath +} +function Assert-TaskNotRunning { if($script:running){throw 'Task aktiv'} } +function Invoke-NativeChecked { param($Program,$Arguments) + if($Program -ne 'schtasks.exe'){throw 'Falsches Programm'} + $script:events += $Arguments[0] + if($Arguments[0] -eq '/Create'){ + $script:xmlPath=$Arguments[[array]::IndexOf($Arguments,'/XML')+1] + [xml]$xml=Get-Content -LiteralPath $script:xmlPath -Raw + if($xml.Task.Actions.Exec.WorkingDirectory -ne 'D:\ndtrack'){throw 'Arbeitsverzeichnis falsch'} + if($xml.Task.Actions.Exec.Command -ne '%SystemRoot%\System32\cmd.exe'){throw 'Programm falsch'} + if($xml.Task.Triggers.ChildNodes.Count){throw 'Unerwuenschter Trigger'} + if($script:failCreate){throw 'Exitcode 1 beim Erstellen'} + } elseif($script:failRun){throw 'Exitcode 1 beim Starten'} +} +$credential=[pscredential]::new('DOMAIN\scan',(ConvertTo-SecureString 'test-only' -AsPlainText -Force)) CreateScheduledTask @('server01') $credential -if(($script:events -join ',') -ne 'register,start'){throw 'Task nicht zuerst registriert und danach gestartet'} +if(($script:events -join ',') -ne '/Create,/Run'){throw 'Reihenfolge falsch'} +if(Test-Path $script:xmlPath){throw 'Temporaere XML nicht entfernt'} $script:events=@(); $script:hasFile=$false CreateScheduledTask @('server01') $credential -if($script:events.Count){throw 'Task trotz fehlender CMD erstellt'} +if($script:events.Count){throw 'Erstellung trotz fehlender CMD'} $script:hasFile=$true; $script:running=$true CreateScheduledTask @('server01') $credential if($script:events.Count){throw 'Aktiven Task ueberschrieben'} -Write-Host '3 Task-Start-Szenarien bestanden.' +$script:running=$false; $script:failCreate=$true +CreateScheduledTask @('server01') $credential +if(($script:events -join ',') -ne '/Create'){throw 'Start trotz Erstellungsfehler'} +$script:events=@(); $script:failCreate=$false; $script:failRun=$true +$output=@(CreateScheduledTask @('server01') $credential *>&1) +if(($output | Out-String) -match 'START ANGEFORDERT:'){throw 'Falscher Erfolg nach Startfehler'} +if(Test-Path $script:xmlPath){throw 'Temporaere XML nach Fehler vorhanden'} +Write-Host '5 Task-Szenarien bestanden: Erfolg, fehlende CMD, aktiver Task, Create-Fehler, Run-Fehler; XML und Bereinigung geprueft.'