Automatisierung und Setup-Integration

CLI-Parameter vollständig erklärt

Die installierte CLI heißt AmrumStartmenueCLI.exe. Ohne Unterbefehl öffnet sie die GUI. Rückgabecode 0 bedeutet Erfolg, 1 einen Fehler und 2 einen geschützten Konflikt bei synchronisierenden Befehlen.

Sichere Vorschau: Verwenden Sie vor manuellen Änderungen zuerst sync --dry-run --json oder restore-direct --dry-run.

Ohne Unterbefehl / gui

AmrumStartmenueCLI.exe [gui]

Zweck: Öffnet die grafische Verwaltung.
Parameter: Keine.
Standard: Ohne Unterbefehl startet ebenfalls die GUI.
Abhängigkeiten: Benötigt eine interaktive Windows-Benutzersitzung.
Sicherheit: Ändert das Startmenü erst, wenn in der GUI eine Aktion bestätigt wird.
Beispiel: AmrumStartmenueCLI.exe gui

--help / -h / --version

AmrumStartmenueCLI.exe --help
AmrumStartmenueCLI.exe -h
AmrumStartmenueCLI.exe --version

Zweck: Zeigt Hilfe oder Programmversion und beendet sich.
Parameter: Keine Werte.
Standard: Keine weiteren Aktionen.
Abhängigkeiten: Keine.
Sicherheit: Rein lesend.
Beispiel: AmrumStartmenueCLI.exe --help

Globale Testpfade

AmrumStartmenueCLI.exe [--state-root PFAD] [--amrum-root PFAD] BEFEHL

Zweck: Verwendet abweichende Zustands- oder Startmenüpfade, insbesondere für Tests.
Parameter: --state-root PFAD und --amrum-root PFAD erwarten Windows-Pfade.
Standard: Ohne Angabe gelten die regulären Benutzerpfade.
Abhängigkeiten: Müssen vor dem Unterbefehl stehen.
Sicherheit: Falsche Pfade können einen anderen Datenbestand bearbeiten. Für echte Nutzung normalerweise nicht setzen.
Beispiel: AmrumStartmenueCLI.exe --amrum-root C:\Test\Startmenue status

status

AmrumStartmenueCLI.exe status [--json]

Zweck: Zeigt Version, Moduswahl, Erkennung, Grund und Produktzahl.
Parameter: --json liefert zusätzlich Produkt- und Updatefelder als JSON.
Standard: Menschenlesbare Textausgabe.
Abhängigkeiten: Verwendet den vorhandenen Katalog und die gespeicherten Einstellungen.
Sicherheit: Rein lesend; eine Installations-ID wird bei Bedarf lokal sichergestellt.
Beispiel: AmrumStartmenueCLI.exe status --json

import-existing

AmrumStartmenueCLI.exe import-existing [--overwrite] [--sync] [--silent]

Zweck: Kopiert vorhandene Produkt-Unterordner in den sicheren Katalog.
Parameter: --overwrite ersetzt vorhandene Katalogvorlagen; --sync synchronisiert danach; --silent unterdrückt normale Ausgabe.
Standard: Vorhandene Katalogeinträge werden nicht überschrieben und es wird nicht synchronisiert.
Abhängigkeiten: Erwartet bestehende Produkt-Unterordner im gewählten AmrumSoftware-Startmenü.
Sicherheit: Mit --overwrite werden Katalogkopien erneuert. --sync kann das Startmenü nach vorheriger Sicherung ändern.
Beispiel: AmrumStartmenueCLI.exe import-existing --sync

sync

AmrumStartmenueCLI.exe sync [--mode auto|flat|nested] [--dry-run] [--silent] [--json]

Zweck: Synchronisiert die gewählte Startmenü-Darstellung.
Parameter: --mode überschreibt die Auswahl für diesen Lauf; --dry-run zeigt nur die Vorschau; --silent unterdrückt normale Ausgabe; --json liefert JSON.
Standard: Gespeicherter Modus, echte Ausführung, Textausgabe.
Abhängigkeiten: Benötigt einen eingelesenen oder registrierten Katalog.
Sicherheit: Echte Ausführung sichert vor Änderungen. Konflikte liefern Rückgabecode 2 und bleiben erhalten.
Beispiel: AmrumStartmenueCLI.exe sync --dry-run --json

set-mode

AmrumStartmenueCLI.exe set-mode auto|flat|nested [--silent]

Zweck: Speichert den Modus und wendet ihn unmittelbar an.
Parameter: Pflichtwert auto, flat oder nested; optional --silent.
Standard: Keine Modusvorgabe; der Wert ist Pflicht.
Abhängigkeiten: Benötigt den Katalog.
Sicherheit: Sichert vor Änderungen. Konflikte liefern Rückgabecode 2.
Beispiel: AmrumStartmenueCLI.exe set-mode auto

set-main

AmrumStartmenueCLI.exe set-main PRODUKT_ID DATEINAME

Zweck: Markiert einen katalogisierten Eintrag als Haupt-Eintrag.
Parameter: Produkt-ID und exakter Vorlagen-Dateiname sind Pflicht.
Standard: Keine.
Abhängigkeiten: Produkt und Datei müssen im Katalog existieren.
Sicherheit: Ändert nur die Katalogklassifikation; eine sichtbare Änderung folgt bei der nächsten Synchronisierung.
Beispiel: AmrumStartmenueCLI.exe set-main mein-produkt "Mein Programm.lnk"

set-extra

AmrumStartmenueCLI.exe set-extra PRODUKT_ID DATEINAME

Zweck: Markiert einen katalogisierten Eintrag als Extra-Eintrag.
Parameter: Produkt-ID und exakter Vorlagen-Dateiname sind Pflicht.
Standard: Keine.
Abhängigkeiten: Produkt und Datei müssen im Katalog existieren.
Sicherheit: Ändert nur die Katalogklassifikation; im kompakten Modus verschwindet der Eintrag nach der nächsten Synchronisierung aus dem sichtbaren Startmenü.
Beispiel: AmrumStartmenueCLI.exe set-extra mein-produkt "Hilfe.lnk"

rename-product

AmrumStartmenueCLI.exe rename-product PRODUKT_ID ANZEIGENAME [--sync] [--silent]

Zweck: Ändert die sichtbare Produktbezeichnung bei unveränderter stabiler Produkt-ID.
Parameter: Produkt-ID und neuer Anzeigename sind Pflicht; --sync aktualisiert das Startmenü sofort; --silent unterdrückt normale Ausgabe.
Standard: Ändert ohne --sync nur den Katalog.
Abhängigkeiten: Produkt muss im Katalog existieren. Ungültige oder doppelte Namen werden abgewiesen.
Sicherheit: Bei geschützten Konflikten während der Synchronisierung wird der bisherige Produktname wiederhergestellt.
Beispiel: AmrumStartmenueCLI.exe rename-product mein-produkt "Neuer Produktname" --sync

reclassify

AmrumStartmenueCLI.exe reclassify

Zweck: Teilt vorhandene Katalogeinträge anhand der aktuellen Erkennungsregeln erneut in Haupt und Extra ein.
Parameter: Keine.
Standard: Bearbeitet alle Produkte im Katalog.
Abhängigkeiten: Benötigt vorhandene Katalogdaten.
Sicherheit: Ändert Katalogrollen, aber synchronisiert das Startmenü nicht automatisch.
Beispiel: AmrumStartmenueCLI.exe reclassify

launch

AmrumStartmenueCLI.exe launch PRODUKT_ID [DATEINAME] [--silent]

Zweck: Prüft die Darstellung und startet danach den gespeicherten Originaleintrag.
Parameter: Produkt-ID ist Pflicht; Dateiname und --silent sind optional.
Standard: Ohne Dateiname wird der passende Haupt-Eintrag gewählt.
Abhängigkeiten: Produkt und gewünschter Eintrag müssen im Katalog stehen.
Sicherheit: Eine fehlgeschlagene Startmenüprüfung darf den eigentlichen Programmstart nicht blockieren.
Beispiel: AmrumStartmenueCLI.exe launch mein-produkt "Mein Programm.lnk" --silent

register-templates

AmrumStartmenueCLI.exe register-templates PRODUKT_ID ANZEIGENAME VORLAGENORDNER HAUPTDATEI [--no-wrap] [--sync] [--silent]

Zweck: Registriert die von einem Setup außerhalb des Startmenüs erzeugten Verknüpfungsvorlagen.
Parameter: Vier Pflichtwerte; --no-wrap verhindert das Umschreiben des Hauptstarts über den Manager; --sync synchronisiert; --silent unterdrückt normale Ausgabe.
Standard: Der Hauptstart wird verwaltet umhüllt, aber nicht automatisch synchronisiert.
Abhängigkeiten: Der Vorlagenordner und die Hauptdatei müssen existieren. Produkt-ID dauerhaft stabil halten.
Sicherheit: Mit --sync folgt eine gesicherte Startmenüänderung. Vorlagen bleiben außerhalb des Startmenüs.
Beispiel: AmrumStartmenueCLI.exe register-templates mein-produkt "Mein Produkt" "C:\Programme\MeinProdukt\StartMenuTemplates" "Mein Produkt.lnk" --sync --silent

unregister

AmrumStartmenueCLI.exe unregister PRODUKT_ID [--sync] [--silent]

Zweck: Entfernt ein Produkt aus dem Verwaltungskatalog.
Parameter: Produkt-ID ist Pflicht; --sync und --silent sind optional.
Standard: Nur Katalogentfernung, keine unmittelbare Synchronisierung.
Abhängigkeiten: Vor einer Produktdeinstallation sollten deren direkten Einträge passend wiederhergestellt sein.
Sicherheit: Mit --sync kann sich das sichtbare Startmenü nach vorheriger Sicherung ändern.
Beispiel: AmrumStartmenueCLI.exe unregister mein-produkt --silent

restore-direct

AmrumStartmenueCLI.exe restore-direct [--dry-run] [--silent]

Zweck: Stellt alle katalogisierten Einträge direkt und unabhängig vom Manager wieder her.
Parameter: --dry-run zeigt nur die geplanten Schritte; --silent unterdrückt normale Ausgabe.
Standard: Echte Wiederherstellung.
Abhängigkeiten: Wird vor der Deinstallation der zentralen Verwaltung benötigt.
Sicherheit: Sichert vor Änderungen. Konflikte bleiben erhalten und liefern Rückgabecode 2.
Beispiel: AmrumStartmenueCLI.exe restore-direct --dry-run