Viele Geräte auf einmal verteilen — MSI mit Zugang und Verteil-Schlüssel

Worum es geht

Wer viele Rechner betreut, will sie nicht einzeln einrichten. Mit dem MSI installieren Sie BrowserDesk samt Dienst über Ihre Softwareverteilung. Geben Sie dabei den Namen Ihres Zugangs und einen Verteil-Schlüssel mit, kommt jedes Gerät beim Installieren in Ihren Zugang — ohne Klick, ohne Kennwort, ohne Zugangs-Passwort.

Das brauchen Sie

• Einen Zugang in der Cloud oder auf Ihrem eigenen Relay. Free hat keine Verteil-Schlüssel; dort kommen Geräte per Einmalcode hinein (C2).
• Genug freie Plätze im Zugang.
• Das MSI: auf browserdesk.de im Download-Bereich der Knopf MSI (Adresse /dl/client/latest/msi). Auf Ihrem eigenen Relay dieselbe Adresse auf Ihrem Server.
• Eine Softwareverteilung, die msiexec mit Administratorrechten ausführt (GPO, Intune, PDQ oder ein eigenes Skript).
• Eigenes Relay: Die Geräte müssen die Adresse Ihres Relays kennen, bevor sie beitreten (siehe „Gut zu wissen“).

So geht's

1. Verteil-Schlüssel anlegen

1. In der Konsole Mandanten → Zugang doppelt anklicken (Mandant bearbeiten) → Reiter Geräte hinzufügen → Abschnitt Verteil-Schlüssel. In der Konsole heißt der Zugang Mandant.
2. „Gültig (Tage)“ (1 bis 30), „Höchstens Geräte“ und eine „Notiz“ eintragen, dann Schlüssel anlegen.
3. Der Schlüssel (beginnt mit bdk_) und die fertigen Befehle unter So installieren sind nur jetzt sichtbar. Schlüssel kopieren bzw. Befehle kopieren.

2. Verteilen

Windows, MSI — der Befehl für Ihre Softwareverteilung:

msiexec /i BrowserDesk.msi BDZUGANG=<Zugang> BDSCHLUESSEL=<Schlüssel> /qn

Das MSI installiert für alle Benutzer, richtet den Dienst ein und legt die Beitrittsanfrage ab. Der Dienst löst sie ein, sobald er läuft.

Windows, Einzeldatei per Skript — ohne MSI:

1. Die aktuelle EXE laden und als Dienst einrichten (Client per Kommandozeile installieren).
2. Beitreten: BrowserDesk.exe --join <Zugang> --key <Schlüssel> — ohne Fenster.

Linux (deb bzw. rpm):

sudo BDZUGANG=<Zugang> BDSCHLUESSEL=<Schlüssel> apt install ./<Dateiname>.deb

Reicht der Paketmanager die Angaben nicht durch, die Datei /var/lib/browserdesk/join-request.json mit dem Inhalt {"tenant":"<Zugang>","key":"<Schlüssel>"} von Hand ablegen.

3. Nach dem Ausrollen

Den Schlüssel in der Konsole widerrufen (Menü der Zeile → Widerrufen). Schon hinzugefügte Geräte bleiben.

Daran sehen Sie, dass es geklappt hat

• In der Konsole zählt die Zeile des Schlüssels mit: benutzt / höchstens, Zustand „gültig“, später „aufgebraucht“.
• Die Geräte erscheinen unter Geräte im Zugang.
• Am Gerät steht in der Karte Zugang: „Dieses Gerät gehört zum Zugang „…“ (bei der Installation oder von einem anderen Benutzer hinzugefügt).“
• --join meldet sich mit einem Rückgabewert: 0 hinzugefügt, 1 abgelehnt (der Grund steht in der Ausgabe), 2 noch nicht (Relay nicht erreichbar oder Zugang voll — der Dienst versucht es weiter), 64 Aufruf falsch.

Gut zu wissen

• Behandeln Sie den Schlüssel wie ein Kennwort. Wer die Befehlszeile in Ihrer Softwareverteilung lesen kann, sieht ihn. Deshalb ist er befristet, auf eine Gerätezahl begrenzt und widerrufbar — und nie das Zugangs-Passwort.
• Zugang voll: Ein Gerät mit Schlüssel wartet und fragt alle 10 Minuten neu. Ein frei gewordener oder dazugekaufter Platz wird ohne Ihr Zutun genutzt.
• Eigenes Relay: Der Beitritt geht an das Relay, das das Gerät kennt — ab Werk browserdesk.de. Dort wird er abgewiesen („Dieser Verteil-Schlüssel gilt nicht für diesen Zugang“), und die Anfrage ist verworfen. Eine MSI-Eigenschaft für die Relay-Adresse gibt es nicht. Wo das Gerät die Adresse speichert, steht in Relay-Adresse anpassen; einen geprüften Weg, sie bei der Verteilung vorab zu setzen, gibt es noch nicht — schreiben Sie an info@browserdesk.de.
• Mac: Das MSI und --join gibt es nur für Windows, das Linux-Paket nur für Linux. Macs fügen Sie einzeln hinzu (C2).
• Ohne Zugriff ohne Bestätigung muss jemand am Gerät jede Sitzung annehmen. Wie Sie Geräte unbeaufsichtigt erreichen: C4.
• Dieselbe Anfrage zweimal einzulösen schadet nicht: Ein Gerät zählt je Schlüssel einmal und behält seinen Platz.

Wenn es nicht klappt