Logo des Z-Cron Extraktors

Amrum Software · Windows-Werkzeug

CLI-Parameter

Alle Kommandozeilenoptionen mit Werten, Abhängigkeiten, Sicherheitsfolgen und Beispielen.

Ohne Parameter startet ZCronExtraktorCLI.exe die grafische Oberfläche. CLI-Aktionen benötigen einen der folgenden Betriebsmodi. Extraktion, Servermodus und Aufgabenübernahme unterliegen derselben höchstens täglichen 90-Tage-Updateprüfung wie die GUI; --hilfe und --version bleiben auch nach einem Fristablauf erreichbar.

--extrahieren, --extract

Erzeugt Bericht und Exporte ohne GUI und beendet sich anschließend.

--server, --serve

Extrahiert und stellt den neuen Bericht über einen lokalen Server auf 127.0.0.1 bereit, bis Strg+C gedrückt wird.

--gui

Startet ausdrücklich die grafische Oberfläche.

--nach-windows JOB

Wählt einen Z-Cron-Auftrag über seine Jobnummer oder seinen exakten Namen und bereitet eine Windows-Aufgabe vor. Standard ist ausschließlich eine Vorschau; geschrieben wird erst mit --ausfuehren --bestaetigt.

--nach-zcron AUFGABE

Wählt eine Windows-Aufgabe über ihren vollständigen Aufgabenpfad oder einen eindeutigen Namen und bereitet einen neuen Z-Cron-Auftrag vor. Nicht verlustfrei abbildbare Aktionen oder Trigger werden abgelehnt. Standard ist ausschließlich eine Vorschau.

--quelle PFAD, --source PFAD

Ordner mit zcronjob.ini oder direkter Pfad zu dieser Datei. Ohne Angabe wird automatisch gesucht.

--ausgabe ORDNER, --output ORDNER

Übergeordneter Zielordner für datierte Berichte. Standard ist der lokale Ausgabenordner der Anwendung.

--zukunft-tage TAGE, --future-days TAGE

Vorschauzeitraum von 1 bis 366 Tagen. Standard: 31.

--vergangenheit-tage TAGE, --history-days TAGE

Auswertungszeitraum für vorhandene Protokolldateien von 1 bis 3650 Tagen. Standard: 365.

--originale-einschliessen, --include-originals

Kopiert zcronjob.ini und Protokolldateien in den Bericht. zcron.ini bleibt dabei ausgeschlossen.

--zcron-ini-einschliessen, --include-zcron-ini

Kopiert zusätzlich die vertrauliche zcron.ini. Diese Option funktioniert nur zusammen mit --risiko-bestaetigt bzw. --risk-confirmed.

--risiko-bestaetigt, --risk-confirmed

Bestätigt ausdrücklich, dass zcron.ini Zugangsdaten, lokale Pfade, IP-Adressen und Netzdetails enthalten kann. Ohne die Einschlussoption allein wirkungslos.

--ohne-zip, --without-zip

Erzeugt keinen zusätzlichen ZIP-Transportcontainer. Der normale Berichtsordner bleibt erhalten.

--oeffnen, --open

Öffnet die lokale Webseite nach der Extraktion; im Servermodus den lokalen Server.

--port NUMMER

Port von 0 bis 65535 für den lokalen Server. Standard 0 wählt automatisch einen freien Port.

--zusammenfassung-json DATEI, --summary-json DATEI

Schreibt zusätzlich eine maschinenlesbare Zusammenfassung in die angegebene JSON-Datei.

--zielname NAME

Vergibt bei einer Aufgabenübernahme einen abweichenden Zielnamen. Ohne Angabe entsteht nach Windows Z-Cron NNN - Name; nach Z-Cron wird der Windows-Aufgabenname verwendet.

--uhrzeit HH:MM

Verschiebt die erste Startzeit und alle weiteren Zeiten mit gleichem Abstand. Windows-Ziele sind minutengenau; Z-Cron-Ziele müssen im Fünf-Minuten-Raster liegen.

--ausfuehren

Schaltet von der sicheren Vorschau auf eine tatsächliche Änderung um. Die Option allein reicht nicht; zusätzlich ist --bestaetigt Pflicht.

--bestaetigt

Bestätigt die zuvor geprüfte Aufgabenübernahme. Ohne --ausfuehren wird die Kombination als Bedienfehler abgelehnt.

--quelle-aktiv-lassen

Verhindert die standardmäßige Deaktivierung der Ursprungsaufgabe nach erfolgreicher Übernahme. Dadurch können Quelle und Ziel denselben Befehl parallel starten; diese Folge muss bewusst berücksichtigt werden.

--ersetzen

Erlaubt bei Z-Cron→Windows das Ersetzen einer gleichnamigen Windows-Aufgabe. Deren vollständige XML-Definition wird vorher gesichert; der vorhandene Aktivstatus bleibt erhalten. Für Windows→Z-Cron ist diese Option unzulässig.

--duplikate-zulassen

Übergeht die Sperre bei erkannten namens- oder inhaltsgleichen Aufgaben. Ohne diese ausdrückliche Option wird keine möglicherweise doppelt laufende Aufgabe geschrieben.

-h, --hilfe, --help

Zeigt die vollständige Kommandozeilenhilfe und beendet das Programm.

--version

Zeigt Programmname und Version und beendet das Programm.

Typische Aufrufe

ZCronExtraktorCLI.exe --extrahieren
ZCronExtraktorCLI.exe --extrahieren --quelle C:\ProgramData\Z-Manufaktur\Z-Cron
ZCronExtraktorCLI.exe --extrahieren --ausgabe D:\ZCron-Export --zukunft-tage 90
ZCronExtraktorCLI.exe --server --port 8765 --oeffnen
ZCronExtraktorCLI.exe --extrahieren --originale-einschliessen --zcron-ini-einschliessen --risiko-bestaetigt
ZCronExtraktorCLI.exe --nach-windows 12 --quelle C:\ProgramData\Z-Manufaktur\Z-Cron
ZCronExtraktorCLI.exe --nach-windows 12 --uhrzeit 02:17 --ausfuehren --bestaetigt
ZCronExtraktorCLI.exe --nach-zcron \MeineAufgabe --uhrzeit 02:15 --ausfuehren --bestaetigt