Kommandozeileninstallation

Unbeaufsichtigte Installation über die Kommandozeile

Für automatisierte Rollouts oder Setups durch IT-Partner kann der Installer auch ohne Benutzerinteraktion ausgeführt werden.

Beispiel:

./setup.exe --output="C:\KlardatenDatevService" --install-datev-user --install-service --start-service

Grundlegende Installationsparameter

• --output="C:\KlardatenDatevService": Für Kommandozeileninstallationen erforderlich. Definiert das Zielverzeichnis. Eigene Pfade sollten in Anführungszeichen stehen, damit Backslashes erhalten bleiben.
• --install-service: Legt einen Windows-Dienst mit dem Namen Klardaten DATEV Connector und automatischem Start an. Wenn der Dienst bereits existiert, wird er neu erstellt.
• --start-service: Startet den Windows-Dienst automatisch nach der Installation.
• --install-userless: Unterdrückt die Warnung, wenn der Dienst ohne Windows-Benutzer installiert wird. Das ist sinnvoll, wenn Zugangsdaten später gesetzt werden sollen, zum Beispiel remote.

Windows- und DATEV-Benutzer per Kommandozeile

Neuen Benutzer anlegen

• --install-datev-user: Legt den Windows-Benutzer klardaten sowie den zugehörigen DATEV-Benutzer an.
• -s DATEVconnect.Domain="domain.ad.example.com": Überschreibt bei Bedarf die automatisch ermittelte Domäne.

Bestehenden Benutzer verwenden

Wenn ein vorhandener Windows- und DATEV-Benutzer verwendet werden soll, müssen die Angaben explizit gesetzt werden:

• -s DATEVconnect.IsConfigured=true
• -s DATEVconnect.Username="windowsUsername"
• -s DATEVconnect.Domain="domain.ad.example.com"
• -se windows.user.password="windowsPassword"

Für geheime Werte sollte immer -se statt -s verwendet werden, damit die Werte verschlüsselt auf dem System gespeichert werden.

Konfigurationswerte während der Installation

Laufzeitparameter können direkt während der Installation gesetzt werden:

• -s <key>=<value>: Ändert einen Konfigurationswert in der aktuellen Umgebungsdatei, zum Beispiel appsettings.Production.json. Der Parameter kann mehrfach angegeben werden.
• -se <key>=<value>: Speichert einen geheimen Wert verschlüsselt. Intern wird Windows DPAPI genutzt, daher kann der Wert nur auf demselben System entschlüsselt werden.

Beispiel:

./setup.exe --output="C:\KlardatenDatevService" -s DATEVconnect.DatevGroup="My Datev Group" -se windows.user.password="Windows user password"

Debugging und Entwicklung

Zusätzlich unterstützt der Installer einige Parameter für Betrieb, Analyse und Entwicklung:

• --dev: Führt die Anwendung in PowerShell aus, statt sie als Windows-Dienst zu starten.
• --ui: Erzwingt die UI-Installation, statt direkt in den Service-Pfad zu wechseln.
• --stop-watchdog: Stoppt alle vorhandenen Watchdog-Dienste, bis der Hauptdienst erneut startet.
• --start-update: Führt Update-bezogene Abschlussaufgaben aus. Dieser Parameter wird intern im Update-Prozess verwendet.