Aktionen mit Gerätegruppen

Neben Richtlinien lassen sich auch Aktionen und CRON-Jobs durch die Mitgliedschaft in Gerätegruppen auslösen. Diese Funktion hat die Regelwerke mit Relution 26.0 vollständig abgelöst. Eine Übernahme alter Regelwerke in die neue Funktionalität findet nicht statt.

Die grundlegende Funktionsweise von Gerätegruppen ist an dieser Stelle erklärt: Gerätegruppen →

Aktionen anlegen #

Aktionen gehören jeweils zu einer Gerätegruppe. Sie werden unter Geräte → Gerätegruppen in der Detailansicht der Gruppe im Reiter Aktionen über Hinzufügen angelegt. Dafür ist die Berechtigung zum Anlegen bzw. Bearbeiten von Gerätegruppenaktionen erforderlich.

Das Formular Aktion hinzufügen besteht aus zwei Bereichen:

• Allgemein: Name, optional Beschreibung sowie Trigger. Im Feld Trigger stehen die Optionen Eventbasiert und CRON-gesteuert zur Auswahl.
• Aktion: Im Feld Aktionstyp wird festgelegt, was auf den Geräten ausgeführt wird (siehe Abschnitt Hauptaktionstypen).

In der Liste der Aktionen lässt sich jede Aktion über den Schalter Aktiviert ein- und ausschalten. Deaktivierte Aktionen werden nicht ausgeführt.

Eventbasiert #

Eventbasierte Aktionen reagieren auf Änderungen der Gruppenmitgliedschaft:

1. Unter Auslöser der Aktion wird festgelegt, wann die Aktion ausgeführt wird: Kein Auslöser, Wenn ein Gerät der Gruppe beitritt, Wenn ein Gerät die Gruppe verlässt oder Beides.
2. Unter Verzögerung der Ausführung wird zwischen Sofort und Zeitverzögert gewählt. Bei Zeitverzögert wird die Verzögerung in Tage, Stunden und Minuten angegeben; vorbelegt sind 90 Minuten. Ist ein beigetretenes Gerät nach Ablauf der Verzögerung nicht mehr Mitglied der Gruppe bzw. ein ausgetretenes Gerät wieder Mitglied, wird die Aktion nicht ausgeführt. So lassen sich Ausführungen vermeiden, wenn ein Gerät nur kurzzeitig zur Gruppe gehört.

Eventbasierte Aktionen wirken nur auf künftige Beitritte und Austritte. Geräte, die beim Anlegen der Aktion bereits Mitglied der Gruppe sind, lösen die Aktion nicht aus.

CRON-gesteuert #

1. Aktionen können zeitgesteuert nach einem CRON-Ausdruck ausgelöst werden WIKI CRON →. Die Aktion wird zu den angegebenen Zeitpunkten für alle Geräte ausgeführt, die dann Mitglied der Gruppe sind.
2. Alle Felder müssen befüllt sein. Komma-Separierung, Bereiche und Schrittwerte werden akzeptiert. Tage des Monats und Wochentage können nicht gleichzeitig konkrete Werte enthalten; eines der beiden Felder wird auf * oder ? gesetzt.
3. Vorbelegt ist eine Ausführung täglich um 06:00 und 21:00 Uhr (Minuten 0, Stunden 6,21, Tage des Monats *, Monate *, Wochentage ?). Die Zeitpunkte beziehen sich auf die Zeitzone des Relution-Servers.

Ergänzende Hinweise zur Syntax #

Die Werte werden ohne Leerzeichen eingegeben, da das Portal die Eingabe sonst als ungültig ablehnt.

• Stern (*): Steht für “jeden” (z. B. jede Minute, jeden Tag).
• Fragezeichen (?): Nur bei Tage des Monats und Wochentage; steht für “keine Angabe”.
• Komma (,): Trennt einzelne Werte (z. B. 1,15,30 für die 1., 15. und 30. Minute).
• Bindestrich (-): Definiert einen Bereich (z. B. 1-5 für Montag bis Freitag).
• Schrägstrich (/): Definiert Intervalle (z. B. */5 für alle 5 Einheiten).
• Crontab Guru →

Diese Konfigurationen sind direkt gültig und werden nach dem Speichern angewendet.

Hauptaktionstypen #

Im Feld Aktionstyp stehen folgende Typen zur Verfügung:

1. Gerät löschen
2. Geräteaktion
3. Benachrichtigungsaktion
4. Gerätename ändern
5. Geräterichtlinie aktualisieren
6. Webhook

Gerät löschen #

Beschreibung:

• Diese Aktion entfernt das Gerät aus der Relution-Verwaltung. Was dabei auf dem Gerät geschieht, hängt von der Einschreibungsart ab:
  • Vollständig verwaltete Android-Enterprise-Geräte werden auf Werkseinstellungen zurückgesetzt.
  • Bei Android-Enterprise-Geräten mit Arbeitsprofil oder mit persönlichem Profil wird nur das Arbeitsprofil entfernt; persönliche Apps und Daten bleiben erhalten.
  • Auf allen anderen Plattformen wird die Verwaltung entfernt (z. B. das MDM-Profil bei Apple-Geräten oder die Registrierung bei Windows), das Gerät wird aber nicht zurückgesetzt.
• Wichtig: Dies kann nicht rückgängig gemacht werden.
• Bei Geräten, die über KME (Knox Mobile Enrollment) eingeschrieben wurden, muss sichergestellt sein, dass im Samsung Knox Enrollment Portal kein Profil zugewiesen ist, da das Gerät sonst nach dem Löschen automatisch neu eingeschrieben wird (nur Android).

Optionen:

• Android:
  • Relution App nicht deinstallieren: ja/nein
• Verwaltetes Gerät (Android Enterprise, vollständig verwaltet):
  • Factory Reset Protection (FRP) aktiviert lassen: ja/nein
  • Den externen Speicher des Geräts ebenfalls löschen (z. B. SD-Karten): ja/nein
  • Nachricht: Text, der Benutzern privater Geräte mit Arbeitsprofil vor dem Entfernen des Arbeitsprofils angezeigt wird. Auf firmeneigenen Geräten hat er keine Wirkung.

Geräteaktion #

Beschreibung:

• Ermöglicht verschiedene Einzelaktionen auf den Geräten.

Welche Aktionen konkret auf welchem Betriebssystem verfügbar sind, wird nach der Auswahl im Bereich Details als Plattform-Kennzeichnung angezeigt.

Unteraktionen:

1. Lost Mode aktivieren
   • Sperrt das Gerät und ermöglicht seine Ortung. Kann verwendet werden, wenn ein Gerät verloren gegangen ist.
   • Felder: Nachricht, Telefonnummer, Fußnote, E-Mail, Adresse, Organisationsname
2. Lost Mode deaktivieren
   • Hebt den Lost Mode auf.
3. Gerät neu starten
   • Startet das Gerät neu.
   • Feld: Grund für den Neustart (nur Android-Geräte ohne Android Enterprise und interaktive Whiteboards)
   • Optionen: Ausschalten (nur Android-Geräte ohne Android Enterprise und interaktive Whiteboards), Den Benutzer benachrichtigen, um das Gerät neu zu starten (kein erzwungener Neustart), nur macOS ab 11
4. Geräteinformationen aktualisieren
   • Aktualisiert die in Relution gespeicherten Geräteinformationen.
5. Alarm auslösen
   • Lässt einen Alarm auf dem Gerät ertönen.
   • Feld: Dauer (in Sekunden)
6. Bluetooth ein- oder ausschalten
   • Aktiviert oder deaktiviert Bluetooth.
   • Option: Bluetooth einschalten
7. Gerät scannen
   • Startet einen Virenscan mit Microsoft Defender auf Windows-Geräten.
   • Feld: Scan Typ (Schnell Scan oder Vollständiger Scan)
8. Lokale Benutzer löschen
   • Löscht alle lokalen Benutzerkonten und Daten.
   • Option: Kontolöschung erzwingen
9. Persönlichen Hotspot ein- oder ausschalten
   • Aktiviert oder deaktiviert den persönlichen Hotspot.
   • Option: Persönlichen Hotspot einschalten
10. eSIM-Mobilfunktarif
    • Konfiguriert einen eSIM-Mobilfunktarif.
    • Feld: Server-URL
11. Shortcut entfernen
    • Entfernt eine Verknüpfung vom Gerät.
    • Felder: Bezeichnung, URL
12. AirPlay-Wiedergabe starten
    • Startet die AirPlay-Wiedergabe auf einem Apple TV oder einem anderen AirPlay-fähigen Gerät.
    • Felder: Name, MAC-Adresse, Scanzeit (Sekunden), Passwort
    • Ab Relution 26.5.5 wird ein gespeichertes Passwort nicht mehr angezeigt, sondern erscheint als *****; bleibt das Feld beim Bearbeiten leer, wird es beibehalten.
13. Return to Service
    • Setzt das Gerät auf die Werkseinstellungen zurück. Danach versucht das Gerät, sich automatisch wieder bei Relution einzuschreiben; dafür muss die Aktivierungssperre deaktiviert sein. Verfügbar für iOS ab 17 und tvOS ab 18.
    • Feld: WLAN-Konfiguration (Pflichtfeld; Auswahl aus den aktivierten WLAN-Konfigurationen veröffentlichter Richtlinien)
    • Option: Bestehenden Datentarif beibehalten (nur iOS)
14. Datei an Gerät senden
    • Sendet eine Datei an das Gerät.
    • Felder: Datei auswählen, Verzeichnis, ZIP-Archive nicht dekomprimieren
15. Gerät auf Werkszustand zurücksetzen
    • Setzt das Gerät auf die Werkseinstellungen zurück.
    • Optionen: Factory Reset Protection (FRP) aktiviert lassen, Den externen Speicher des Geräts ebenfalls löschen, Nachricht, PIN, Bestehenden Datentarif beibehalten, Proximity Setup deaktivieren
    • Die PIN (nur macOS, sechs Ziffern) ist Pflicht, solange keine gespeichert ist. Ab Relution 26.5.5 erscheint eine gespeicherte PIN als *****; bleibt das Feld beim Bearbeiten leer, wird sie beibehalten.
16. Prowise-Update installieren
    • Installiert ein Prowise-Update.
    • Feld: Update am
17. Gerät vollständig sperren
    • Sperrt das Gerät mit dem aktuellen Passwort.
    • Felder: Nachricht, Telefonnummer, PIN
    • Die PIN (nur macOS, sechs Ziffern) ist Pflicht, solange keine gespeichert ist. Ab Relution 26.5.5 erscheint eine gespeicherte PIN als *****; bleibt das Feld beim Bearbeiten leer, wird sie beibehalten.
18. Shortcut hinzufügen
    • Fügt eine Verknüpfung zum Gerät hinzu.
    • Felder: Bezeichnung, URL, Im Vollbildmodus öffnen, Icon
19. Passwort zurücksetzen
    • Setzt das Gerätepasswort zurück.
    • Feld: Neues Passwort (Pflichtfeld, maskierte Eingabe)
    • Optionen: Sofort sperren, Eingabe vor erneutem Reset erfordern, Beim Booten nicht fragen
    • Ab Relution 26.5.5 erzeugt das Portal kein Passwort mehr automatisch. Das gesetzte Passwort ist danach nicht mehr einsehbar, auch nicht im Kommentar der Aktion; es muss daher vorab festgehalten werden. In einer gespeicherten Aktion erscheint es als *****; bleibt das Feld beim Bearbeiten leer, wird es beibehalten.
20. Passwort zurücksetzen (Windows)
    • Setzt das Passwort eines Windows-Benutzerkontos zurück.
    • Felder: Benutzername, Passwort, Passwort wiederholen
    • Aktion: Beispielkennwort generieren
21. Gerät herunterfahren
    • Fährt das Gerät herunter.
22. AirPlay-Wiedergabe stoppen
    • Beendet die AirPlay-Wiedergabe.
23. Gerät orten
    • Löst die Ortung des Geräts aus.
24. Bildschirmzeit-Code entfernen
    • Entfernt den Bildschirmzeit-Code.
25. Daten-Roaming ein- oder ausschalten
    • Schaltet das Daten-Roaming auf iOS-Geräten ein oder aus. Die Einstellung kann vom Benutzer auf dem Gerät wieder geändert werden.
    • Option: Daten-Roaming aktivieren
26. Im Geräte-Setup-Assistenten fortfahren
    • Setzt das Gerät im Setup-Assistenten fort.
27. Medien installieren
    • Installiert Medien auf dem Gerät.
    • Feld: Token-Auswahl
28. Medien entfernen
    • Entfernt Medien vom Gerät.
    • Feld: Token-Auswahl
29. PowerShell-Skript ausführen
    • Führt ein PowerShell-Skript auf Windows-Geräten aus.
30. Den Benutzer abmelden
    • Meldet den aktuellen Benutzer ab.
31. Shell-Skript ausführen
    • Führt ein Shell-Skript auf macOS- und Linux-Geräten aus. Die Unteraktion steht nur zur Auswahl, wenn der macOS Companion aktiviert ist (Einstellungen → Relution Client Apps, Schalter macOS Companion aktivieren).
32. Geräteinformationen anfordern
    • Fordert bestimmte Geräteinformationen an (Android Enterprise, Arbeitsprofil auf privatem Gerät, ab Android 13). Der Benutzer wird gebeten, der Weitergabe der Information zuzustimmen.
    • Feld: Typ (eSIM-Kennung (EID))
33. Enterprise Wipe
    • Entfernt das Arbeitsprofil und alle Richtlinien und überlässt das Gerät der persönlichen Nutzung. Apps und Daten des persönlichen Profils bleiben erhalten (Android Enterprise, firmeneigenes Gerät mit persönlichem Profil, ab Android 8).
34. Standard-Apps festlegen
    • Legt die Standard-Apps für Anrufe, Nachrichten und Webbrowser auf iOS-Geräten fest.
    • Felder: Standard-Anruf-App und Standard-Nachrichten-App (ab iOS 26), Standard-Browser-App (ab iOS 18.2)
35. Bildschirmfreigabe aktivieren
    • Aktiviert auf Macs die entfernte Verwaltung über die Apple-Bildschirmfreigabe: Zugriff für alle Benutzer, Empfang entfernter Ereignisse sowie die Optionen Beobachten, Steuern und Anzeigen während Beobachtung. Alle anderen Optionen bleiben unverändert (ab macOS 10.14.4).
36. Bildschirmfreigabe deaktivieren
    • Deaktiviert auf Macs die entfernte Verwaltung über die Apple-Bildschirmfreigabe (ab macOS 10.14.4).

Benachrichtigungsaktion #

Beschreibung:

• Sendet Benachrichtigungen an Gerätebenutzer oder andere Personen.

Empfänger:

• Gerätebenutzer benachrichtigen
• Andere Benutzer benachrichtigen: Auswahl von Benutzern und Benutzergruppen
• Zusätzliche E-Mail-Empfänger: weitere E-Mail-Adressen

Nachricht:

• Per E-Mail benachrichtigen: Versand einer E-Mail auf Basis einer Vorlage. Über Auf Vorlage zurücksetzen wird der Standardtext wiederhergestellt.
• Per Push-Nachricht benachrichtigen: Die Empfänger erhalten die Push-Nachricht auf allen ihnen zugewiesenen eingeschriebenen Geräten.

In den Texten können Platzhalter verwendet werden; die verfügbaren Platzhalter werden im Formular angezeigt: Erweiterte Platzhalter →

Gerätename ändern #

Beschreibung:

• Ändert den Namen des Geräts.

Feld: Gerätename. Platzhalter wie ${device.serialnumber} werden je Gerät aufgelöst. Ergibt sich ein leerer Name, bleibt der bisherige Gerätename erhalten.

Geräterichtlinie aktualisieren #

Beschreibung:

• Aktualisiert die auf dem Gerät angewendeten Richtlinien.

Webhook #

Beschreibung:

• Sendet eine Anfrage an einen externen Dienst (z. B. ein anderes System).

Felder: URL, Method (GET, POST oder PUT; voreingestellt ist POST), Headers (Request-Header als Liste), Body

Über Prüfen im Bereich Webhook-Parameter testen sendet der Server eine OPTIONS-Anfrage an die angegebene URL und zeigt Statuscode und Statusmeldung der Antwort an; den Inhalt der Antwort zeigt das Portal nicht an. So lässt sich prüfen, ob der Zielhost vom Relution-Server aus erreichbar ist.

Ab Relution 26.5.3 ruft der Server nur noch zulässige Ziele auf. Das gilt für Webhooks, für den Abruf von Favicons und Seiteninformationen bei Weblinks sowie für die URLs von SCEP- und NDES-Servern:

• Öffentliche Adressen sind erlaubt.
• Standardmäßig sind zusätzlich die privaten Netze 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 und fc00::/7 erlaubt.
• Loopback- und Link-Local-Adressen sind nur erlaubt, wenn sie ausdrücklich eingetragen sind. Adressen des Relution-Servers selbst lassen sich nur als einzelner Host freigeben (z. B. 127.0.0.1/32, bei IPv6 /128).

Ein abgelehntes Ziel wird mit The destination of the URL is not allowed gemeldet. Die erlaubten Netze werden über relution.security.egress.allowed-networks in der application.yml bzw. die Umgebungsvariable RELUTION_SECURITY_EGRESS_ALLOWEDNETWORKS (kommagetrennt) festgelegt. Die Angabe ersetzt die Standardliste, die benötigten privaten Netze müssen also mit aufgeführt werden; ein leerer Wert sperrt alle privaten Ziele. Die Änderung wird nach einem Neustart des Servers wirksam.