ArztDashboard-Client zentral unter Windows ausrollen

Überblick

Für die Verteilung gibt es ein PowerShell-Skript. Es

• installiert den Client für alle Benutzer des Rechners nach C:\Program Files\ArztDashboard,
• aktualisiert eine vorhandene Installation auf die neueste Version und tut nichts, wenn sie schon aktuell ist,
• entfernt den alten ArztDashboard-Client (Vorgänger mit lokaler Datenbank), falls er installiert ist,
• prüft die Prüfsumme jedes Downloads, bevor es ihn ausführt.

Dasselbe Skript dient also zur Erstinstallation und zur regelmäßigen Aktualisierung.

Voraussetzungen

• Windows 10 oder 11, 64 Bit
• Ausführung als Administrator oder als SYSTEM (Standard bei ServerEye)
• Windows PowerShell 5.1 (bei Windows 10/11 vorhanden)
• Ausgehender HTTPS-Zugriff auf fsn1.your-objectstorage.com
• Im Praxisnetz läuft der Arzt Dashboard Praxis Server; der Client verbindet sich mit ihm (Standardport 28443).

Download

https://fsn1.your-objectstorage.com/arztdashboard/praxis/electron/install-electron-client.ps1

Wir empfehlen, das Skript bei jeder Ausführung frisch herunterzuladen statt eine lokale Kopie zu verteilen. So laufen Korrekturen am Skript automatisch mit.

Aufruf

Einfache Installation bzw. Aktualisierung:

powershell -ExecutionPolicy Bypass -File .\install-electron-client.ps1

Komplett mit Download, z. B. als ServerEye-Skript:

$script = Join-Path $env:TEMP 'install-electron-client.ps1'
Invoke-WebRequest 'https://fsn1.your-objectstorage.com/arztdashboard/praxis/electron/install-electron-client.ps1' -OutFile $script -UseBasicParsing
powershell -ExecutionPolicy Bypass -File $script
exit $LASTEXITCODE

Parameter

Parameter	Standard	Bedeutung
-InstallDir <Pfad>	C:\Program Files\ArztDashboard	Installationsordner. Muss ein absoluter Pfad sein.
-ServerUrl <URL>	–	Feste Adresse des Praxis-Servers, z. B. http://192.168.1.10:28443. Ohne diesen Parameter sucht der Client den Server selbst im Netz.
-Force	aus	Installiert neu, auch wenn die aktuelle Version schon vorhanden ist.

Beispiel mit fester Serveradresse:

powershell -ExecutionPolicy Bypass -File .\install-electron-client.ps1 -ServerUrl http://192.168.1.10:28443

Serveradresse festlegen

Ohne Konfiguration findet der Client den Praxis-Server selbst: Er prüft den eigenen Rechner und dann das lokale Subnetz auf den Ports 28443–28452. Das funktioniert in den meisten Praxen ohne Zutun.

-ServerUrl ist sinnvoll, wenn

• der Server in einem anderen Subnetz steht,
• der Server auf einem abweichenden Port läuft,
• mehrere Praxis-Server im Netz erreichbar sind.

Das Skript setzt dafür die systemweite Umgebungsvariable AD_SERVER_URL. Sie wirkt ab dem nächsten Start des Clients. Entfernen:

[Environment]::SetEnvironmentVariable('AD_SERVER_URL', $null, 'Machine')

Aktuell halten

Richten Sie das Skript als wiederkehrende Aufgabe ein, z. B. täglich nachts. Ist bereits die neueste Version installiert, beendet es sich sofort ohne Änderung.

Läuft der Client während eines Updates, wird er beendet. Planen Sie die Aufgabe daher außerhalb der Sprechzeiten.

Der Client bietet Updates zusätzlich selbst an. Da er für alle Benutzer installiert ist, braucht die Installation dieses Updates Administratorrechte. Mitarbeiter ohne Adminrechte können es nicht annehmen; die Aktualisierung übernimmt dann Ihr geplanter Skriptlauf.

Ausgabe und Exit-Codes

Exit-Code	Bedeutung
0	Installiert, aktualisiert oder bereits aktuell
1	Fehler. Die Ursache steht in der Ausgabe nach ArztDashboard-Installation fehlgeschlagen:

Typische Ausgabe einer Aktualisierung:

Installiert: 0.0.11, aktuell: 0.0.12
Lade ArztDashboard-0.0.12-setup.exe herunter
Installiere nach C:\Program Files\ArztDashboard
ArztDashboard 0.0.12 installiert

Alter ArztDashboard-Client

Ist auf dem Rechner noch der alte ArztDashboard-Client installiert, deinstalliert das Skript ihn vor der Installation still. In der Ausgabe erscheint dann Entferne alten ArztDashboard-Client ….

• Die Daten des alten Clients unter %APPDATA%\ArztDashboard bleiben erhalten.
• Wurde der alte Client nur für einen Benutzer installiert, wird er nur gefunden, wenn dieser Benutzer während des Skriptlaufs angemeldet ist. Deinstallieren Sie ihn in diesem Fall bei Bedarf über Einstellungen → Apps.

Deinstallation

Über Einstellungen → Apps → Arzt Dashboard, oder still per PowerShell:

$entry = Get-ItemProperty 'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*' |
    Where-Object { $_.DisplayName -in 'Arzt Dashboard', 'ArztDashboard' -and $_.Publisher -like 'Arzt Dashboard GmbH*' }
cmd /c $entry.QuietUninstallString

Fehlerbehebung

Meldung	Ursache und Lösung
Das Skript muss als Administrator oder SYSTEM laufen	PowerShell als Administrator starten bzw. im Verteilungswerkzeug mit Systemrechten ausführen.
Prüfsumme von … stimmt nicht	Download beschädigt oder durch einen Proxy verändert. Erneut ausführen; ggf. fsn1.your-objectstorage.com von der SSL-Inspection ausnehmen.
Installation fehlgeschlagen, Exit-Code …	Der Installer ist abgebrochen. Prüfen, ob ein Virenscanner die Datei blockiert hat.
Client findet den Server nicht	Firewall auf dem Server-Rechner prüfen (eingehend TCP 28443) oder -ServerUrl setzen.

Winget

Der Client ist derzeit nicht über winget verfügbar. Das Skript deckt Installation und Aktualisierung vollständig ab.