--- title: "UniFi-Network-Aktion in Link’nX: Client, WLAN, Neustart und PoE" description: Sperren oder verbinden Sie aus einem Link’nX-Szenario einen UniFi-Network-Client, schalten Sie ein WLAN oder starten Sie Gerät oder PoE-Port mit MAC-Ziel neu. canonical: https://wiki.can-nx.com/de/guides/link-unifi-network-actions/ language: de product: Link’nX audience: - administrateur - installateur context: "Link’nX Web: Actions, Typ UniFi Network, im Projekt und Gateway angelegter Controller" --- # UniFi-Network-Aktion in Link’nX: Client, WLAN, Neustart und PoE Kontext: Link’nX Web: Actions, Typ UniFi Network, im Projekt und Gateway angelegter Controller Eine UniFi-Network-Aktion in Link’nX sendet einen Befehl an die UniFi-Konsole: einen Client sperren, entsperren oder neu verbinden, ein WLAN aktivieren oder deaktivieren, ein Gerät neu starten oder die Versorgung eines PoE-Ports ab- und wieder einschalten. In einem Szenario wird sie zusammen mit diesem ausgeführt. Für Administratoren und Installateure. Diese Befehle können Verbindungen unterbrechen: Legen Sie das genaue Ziel mit dem Netzwerkverantwortlichen fest und planen Sie den Vorgang im autorisierten Kontext. Für Befehle vom KNX-Bus folgen Sie dem Leitfaden zur [UniFi-Network-Anwesenheit und KNX-Tabelle](https://wiki.can-nx.com/de/guides/link-unifi-network-presence-knx/). ## Bevor Sie beginnen - Die UniFi-Network-Konsole ist [in Link’nX angelegt](https://wiki.can-nx.com/de/guides/link-unifi-devices/). - Sie haben für jeden Befehl das bestätigte Ziel: MAC-Adresse des Clients oder Geräts, PoE-Portnummer oder genauer WLAN-Name. ## Die Aktion erstellen 1. Wählen Sie das Projekt und das Gateway und öffnen Sie dann **Actions → Add → UniFi Network** (Aktionen → Hinzufügen → UniFi Network). 2. Füllen Sie das Pflichtfeld **Name** aus. 3. Wählen Sie unter **UniFi Network controller(s) to control** (Zu steuernde UniFi-Network-Controller) die Controller aus. Die Liste akzeptiert mehrere Controller und bietet **Select all** (Alle auswählen). Für jeden wird dasselbe Ziel verwendet: Wählen Sie nur die Controller aus, zu denen es passt. 4. Geben Sie unter **Target (client MAC / device ID)** (Ziel: Client-MAC / Geräte-ID) das zum Befehl passende Ziel gemäß der Tabelle unten ein. 5. Wählen Sie den **UniFi Network command** (UniFi-Network-Befehl). Diese sieben Befehle benötigen kein Feld **Value** (Wert). 6. Klicken Sie unten rechts auf das Diskettensymbol, warten Sie auf **Success!** (Erfolg!) und prüfen Sie dann die Liste. 7. Soll ein Szenario den Befehl ausführen, fügen Sie die Aktion dem [passenden Szenario](https://wiki.can-nx.com/de/guides/link-scenario-save/) hinzu und speichern Sie es. Das Speichern bereitet die Aktion vor, ohne sie auszuführen. ## Befehl und Ziel wählen | Angezeigter Befehl | Vorzubereitendes Ziel | Angeforderte Wirkung | | --- | --- | --- | | **Block client** (Client sperren) | MAC-Adresse des Clients | Seinen Netzwerkzugang sperren | | **Unblock client** (Client entsperren) | MAC-Adresse des Clients | Diese Sperre aufheben | | **Reconnect (kick) client** (Client neu verbinden) | MAC-Adresse des Clients | Seine Trennung erzwingen, damit er sich neu verbindet; seine Rückkehr ist nicht garantiert | | **Restart device** (Gerät neu starten) | MAC-Adresse des UniFi-Geräts | Seinen Neustart anfordern | | **PoE power-cycle port** (PoE-Port aus- und einschalten) | MAC des Geräts, gefolgt von `_` und der Portnummer | Die PoE-Versorgung des Ports ab- und wieder einschalten | | **Enable WLAN** (WLAN aktivieren) | Genauer Name des WLAN/SSID | Die Aktivierung dieses WLAN anfordern | | **Disable WLAN** (WLAN deaktivieren) | Genauer Name des WLAN/SSID | Seine Deaktivierung anfordern | Völlig fiktive Beispiele: `02:00:00:00:00:01` für eine MAC, `02:00:00:00:00:02_3` für den PoE-Port 3 eines Geräts, `Fiktive SSID` für ein WLAN. Ersetzen Sie sie durch die für Ihre Installation bestätigten Werte. Die allgemeine Bezeichnung **Target** (Ziel) umfasst mehrere Formate: Verwenden Sie das Format des gewählten Befehls und keine IP-Adresse, keinen Anzeigenamen des Geräts und keine andere Kennung. - WLAN: Geben Sie den genauen Namen ein. Tragen mehrere WLAN denselben Namen, lassen Sie das Ziel vom Support bestätigen, bevor Sie diese Automatisierung verwenden. - PoE-Port: Verwenden Sie die vom Installateur bestätigte positive Nummer, ohne die Nummerierung aus dem Beispiel abzuleiten. ## Die Aktion ändern oder zum vorherigen Zustand zurückkehren Zum Ändern oder Duplizieren folgen Sie dem [Aktionseditor](https://wiki.can-nx.com/de/guides/link-action-edit/). Prüfen Sie Namen, Controller, Ziel und Befehl, bevor Sie speichern. Das Löschen einer Aktion lässt das Netzwerk in seinem aktuellen Zustand. Um eine Sperre aufzuheben oder ein WLAN wieder zu aktivieren, erstellen oder verwenden Sie den umgekehrten Befehl, **Unblock client** oder **Enable WLAN**, im autorisierten Kontext. ## Ergebnis prüfen 1. Öffnen Sie die Aktion erneut und prüfen Sie Controller, Ziel und Befehl. 2. Prüfen Sie, ob sie im richtigen Szenario enthalten ist und dieses Szenario gespeichert ist. 3. Kontrollieren Sie nach der Ausführung das Ergebnis in der Konsole des betreffenden Netzwerks: Client gesperrt oder neu verbunden, WLAN, Gerät oder PoE-Port. ## Fehlerbehebung - **Please provide the UniFi Network target (client MAC / device ID)** (Bitte das UniFi-Network-Ziel angeben): Füllen Sie das Ziel aus; es ist auch bei einem Befehl ohne Feld **Value** erforderlich. - Die Aktion ist gespeichert, aber es ist keine Wirkung zu beobachten: Prüfen Sie Controller und Site des Eintrags, das zum Befehl passende Ziel und dann die Zuordnung zum Szenario und dessen Ausführung. Starten Sie das Gerät nicht mehrmals neu, um den Ablauf zu testen. - Der WLAN-Name hat sich geändert: Bestätigen Sie den neuen Namen in der Konsole und aktualisieren Sie dann die betroffenen Aktionen und Zuordnungen. Wenn diese Prüfungen bereits erfolgt sind, schreiben Sie an support@can-nx.com und geben Sie den Befehl, das Symptom, die Uhrzeit und die durchgeführten Tests an. Fügen Sie kein Passwort bei. Französische Bezeichnungen: **Contrôleur(s) UniFi Network à contrôler**, **Cible (MAC du client / ID de l'équipement)**, **Commande UniFi Network**, **Bloquer le client**, **Débloquer le client**, **Reconnecter (kick) le client**, **Redémarrer l'équipement**, **Redémarrer le port PoE**, **Activer le WLAN** und **Désactiver le WLAN**.