Agent über Microsoft Intune bereitstellen

Erfahre, wie du den octoja Agent per Microsoft Intune auf viele Windows-Geräte gleichzeitig ausrollst — mit den richtigen Befehlszeilenargumenten.

Mit Microsoft Intune rollst du den octoja Agent in einem Schritt auf alle deine Windows-Geräte aus. octoja liefert den Agent als Standard-MSI-Paket, das Intune als branchenspezifische App (Line-of-Business) verteilt — octoja-spezifisch ist nur, dass du deine Server-URL (und optional ein Enrollment-Token) als MSI-Eigenschaften übergibst.

Voraussetzungen

  • Ein octoja-Konto mit der Berechtigung Agent-Verwaltung — ohne sie erscheint Administration → Agent-Bereitstellung nicht in deiner Navigation.
  • Zugriff auf das Microsoft Intune Admin Center mit der Berechtigung, Apps hinzuzufügen und zuzuweisen.
  • Die Zielgeräte sind in Intune registriert und erfüllen die Agent-Anforderungen aus Agent auf Windows bereitstellen.

Schritt 1 — MSI und Befehlszeilenargumente besorgen

Öffne den Bereitstellungs-Assistenten in octoja und lass ihn alles für dich erzeugen:

  1. Gehe zu Administration → Agent-Bereitstellung und wähle Windows.
  2. Wähle Manuelle Installation und lade das ZIP-Archiv für deine Architektur herunter (x64 für die meisten Geräte). Entpacke es — darin liegt die MSI-Datei (octoja.Launcher.<version>.<arch>.msi).
  3. Wechsle zur Karte Automatischer Rollout und wähle Microsoft Intune. Kopiere die dort angezeigten Befehlszeilenargumente.

Die Karte Automatischer Rollout auf der Agent-Bereitstellung-Seite mit ausgewähltem Microsoft Intune, mit den nummerierten Intune-Schritten und dem kopierbaren Block der Befehlszeilenargumente mit der Eigenschaft OCTOJA_URL.

Schritt 2 — App in Intune anlegen

  1. Gehe im Intune Admin Center zu Apps → Windows → Hinzufügen.
  2. Wähle den App-Typ Branchenspezifische App und lade die MSI-Datei hoch.
  3. Trage im Feld Befehlszeilenargumente die MSI-Eigenschaften als eine einzige Zeile ein, durch Leerzeichen getrennt:
OCTOJA_URL="https://DEINE-OCTOJA-URL" TOKEN="DEIN-TOKEN"

Lass TOKEN weg, wenn dein Bereitstellungsmodus offen ist (kein Enrollment-Token). Die Installation läuft in jedem Fall unbeaufsichtigt — die Silent-Schalter ergänzt Intune selbst.

  1. Vervollständige die App-Informationen und weise die App deinen Ziel-Gerätegruppen als Erforderlich zu.

Schritt 3 — Prüfen

  1. Nach der nächsten Intune-Synchronisierung installiert sich der Agent im Gerätekontext — ohne Benutzerinteraktion.
  2. Öffne in octoja Geräte: Jedes Gerät erscheint innerhalb von 1–2 Minuten nach seiner Installation.

Fehlerbehebung

SymptomLösung
Intune meldet Fehler 0x80070667 (ungültiges Befehlszeilenargument)Das Feld Befehlszeilenargumente enthält etwas anderes als reine EIGENSCHAFT="Wert"-Paare in einer Zeile. Entferne alle msiexec-Schalter (/i, /qn, /L*V), Zeilenumbrüche oder ein vorangestelltes msiexec — Intune akzeptiert nur die Eigenschaften selbst. Kopiere den Block erneut aus dem Bereitstellungs-Assistenten und füge ihn als eine Zeile ein
Die Installation gelingt, aber das Gerät erscheint nie in octojaDie URL- oder Token-Eigenschaft ist nicht beim Installer angekommen. Prüfe das Installationsprotokoll unter C:\ProgramData\octoja GmbH\install.log auf einem betroffenen Gerät und stelle sicher, dass die Werte in geraden doppelten Anführungszeichen stehen — genau wie generiert
Du kannst in deiner Umgebung gar keine Eigenschaften übergebenLege vor dem Paketieren eine Datei installer.settings.json mit URL und Token neben die MSI — der Installer liest sie automatisch. Das Dateiformat findest du in Agent auf Windows bereitstellen

Siehe auch: Enrollment-Tokens konfigurieren