FRITZ!Box Netzwerk/Dienste (Aktionen)

Aus Meime smarte Welt
Version vom 23. Oktober 2026, 11:00 Uhr von import>Meine smarte Welt (Import Handbuch 2.0.0)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Alle Dienste nehmen zusätzlich das optionale Feld config_entry (im UI „FRITZ!Box“ mit Auswahlliste) entgegen. Ohne Angabe wirkt ein Dienst auf die zuerst geladene Box; Installationen mit nur einer Box sind nicht betroffen. Dienste erscheinen unter Entwicklerwerkzeuge → Aktionen und lassen sich in Automationen und Skripten nutzen. Dienste, die eine Antwort liefern, nutzt du mit response_variable.

fritzbox_netzwerk.set_device_name

Ändert die Bezeichnung (X_AVM-DE_FriendlyName) eines Geräts, nicht den DNS-Hostnamen. 1–64 Zeichen, Leerzeichen und Sonderzeichen erlaubt, nur bei Geräten mit name_writeable. Braucht laut AVM das Recht App für das Konto.

Feld Pflicht Bedeutung
mac ja MAC-Adresse des Geräts
name ja neue Bezeichnung 
action: fritzbox_netzwerk.set_device_name
data:
  mac: "3C:A6:F6:00:11:22"
  name: "Drucker Arbeitszimmer"

fritzbox_netzwerk.wake_on_lan

Sendet ein Wake-on-LAN-Signal.

Feld Pflicht Bedeutung
mac ja MAC-Adresse 
action: fritzbox_netzwerk.wake_on_lan
data:
  mac: "3C:A6:F6:00:11:22"

fritzbox_netzwerk.set_internet_access (experimentell)

Sperrt oder erlaubt den Internetzugang eines Geräts (TR-064 X_AVM-DE_HostFilter). Verfügbarkeit hängt von Modell und FRITZ!OS ab.

Feld Pflicht Bedeutung
mac ja MAC-Adresse
blocked ja true sperrt, false erlaubt
minutes nein nur beim Sperren: danach automatisch wieder freigeben (übersteht einen Neustart) 
# kurz freigeben, dann wieder sperren
- action: fritzbox_netzwerk.set_internet_access
  data: {mac: "3C:A6:F6:00:11:22", blocked: false}
- delay: "00:05:00"
- action: fritzbox_netzwerk.set_internet_access
  data: {mac: "3C:A6:F6:00:11:22", blocked: true}

fritzbox_netzwerk.set_mac_filter (experimentell)

Schaltet den WLAN-MAC-Filter ein oder aus und beendet ein laufendes Pairing. Braucht die FRITZ!Box-Steuerung.

Feld Pflicht Bedeutung
enabled ja true = Filter an 
action: fritzbox_netzwerk.set_mac_filter
data:
  enabled: true

fritzbox_netzwerk.start_pairing (experimentell)

Schaltet den MAC-Filter für minutes Minuten aus, danach automatisch wieder ein. Nur bei eingeschaltetem Filter.

Feld Pflicht Bedeutung
minutes nein 1–120; ohne Angabe die Einstellung Pairing-Dauer 
action: fritzbox_netzwerk.start_pairing
data:
  minutes: 5

fritzbox_netzwerk.reboot_mesh (experimentell)

Startet alle FRITZ!-Geräte neu: erst die erreichbaren Repeater, nach kurzer Pause die Box. Ohne Repeater nur die Box. 

action: fritzbox_netzwerk.reboot_mesh

fritzbox_netzwerk.gast_wlan_info

Liefert SSID, Status und einen QR-Code des Gast-WLANs als Antwort des Dienstes (nicht als Sensor – das Passwort landet nie im Verlauf). Antwortfelder: ssid, eingeschaltet, offen, passwort (null bei offenem Netz), qr_code_svg_base64 (direkt als data:image/svg+xml;base64,… nutzbar) und dienst.

Feld Pflicht Bedeutung
service nein WLAN-Dienst 1–4 erzwingen, falls die Erkennung danebenliegt 
action: fritzbox_netzwerk.gast_wlan_info
data:
  service: 4
response_variable: gast_wlan

fritzbox_netzwerk.set_device_note

Setzt Etikett, Notiz und „reserviert“ eines Geräts, nur in Home Assistant gespeichert. Nicht übergebene Felder bleiben unverändert, ein leerer Text löscht das Feld.

Feld Pflicht Bedeutung
mac ja MAC-Adresse
label nein Etikett
note nein Notiz
reserved nein als reserviert markieren 
action: fritzbox_netzwerk.set_device_note
data:
  mac: "3C:A6:F6:00:11:22"
  label: Kinderzimmer
  note: Gehört Anna
  reserved: true

fritzbox_netzwerk.mark_devices_reserved

Markiert alle Geräte, deren IP zu einem Muster passt, als „reserviert“ (nur in Home Assistant). Antwort: gefunden, geaendert, dry_run, geraete.

Feld Pflicht Bedeutung
ip_filter ja Muster wie beim IP-Filter der Karte (*, ?, Komma, !)
reserved nein false hebt die Markierung auf
dry_run nein nur Vorschau 
action: fritzbox_netzwerk.mark_devices_reserved
data:
  ip_filter: "192.168.178.*,!192.168.178.1"
  reserved: true
  dry_run: true
response_variable: ergebnis

fritzbox_netzwerk.update_oui

Lädt die IEEE-Herstellerregister (MA-L, MA-M, MA-S) neu und gibt die Zahl der Einträge je Register zurück.

fritzbox_netzwerk.list_access_profiles (experimentell)

Liefert alle Zugangsprofile der Kindersicherung (ID und Name). Option nötig. 

action: fritzbox_netzwerk.list_access_profiles
response_variable: profile

fritzbox_netzwerk.get_access_profile (experimentell)

Liefert das aktuelle Zugangsprofil eines Geräts.

Feld Pflicht Bedeutung
mac ja MAC-Adresse

fritzbox_netzwerk.set_access_profile (experimentell)

Weist einem Gerät ein Zugangsprofil zu, optional zeitlich begrenzt.

Feld Pflicht Bedeutung
mac ja MAC-Adresse
profile ja Name oder ID (filtprof…)
minutes nein danach wieder das bisherige Profil 
action: fritzbox_netzwerk.set_access_profile
data:
  mac: "3C:A6:F6:00:11:22"
  profile: Gesperrt
  minutes: 60

fritzbox_netzwerk.install_blueprints

Kopiert die mitgelieferten Blueprints in den Blueprint-Ordner. Antwort: Listen installiert, aktualisiert, unveraendert, uebersprungen.

Feld Pflicht Bedeutung
overwrite nein auch abweichende vorhandene Dateien ersetzen

fritzbox_netzwerk.get_dns_settings (experimentell)

Liest die DNS-Einstellungen der Box, ändert nichts. 

action: fritzbox_netzwerk.get_dns_settings
response_variable: dns
# dns.internet.ipv4.eigene_server, dns.heimnetz.ipv4_lokaler_dns, ...

fritzbox_netzwerk.set_dns_settings (experimentell)

Ändert DNS-Einstellungen. Braucht die Option „DNS-Einstellungen der Box ändern“ (nicht für dry_run). Antwort: geschrieben, aenderungen (vorher/nachher), ergebnis. Nicht angegebene Felder bleiben unverändert; ein leerer Text löscht bei Internet-DNS und zweitem Server den Eintrag.

Feld Pflicht Bedeutung
internet_ipv4_custom, …_dns1, …_dns2 nein eigene DNSv4-Server der Internetverbindung
internet_ipv6_custom, …_dns1, …_dns2 nein eigene DNSv6-Server der Internetverbindung
home_ipv4_dns nein lokaler DNS-Server (IPv4) im Heimnetz
home_ipv6_dns, home_ipv6_advertise nein lokaler DNSv6-Server und Router Advertisement
dry_run nein nur Vorschau 
action: fritzbox_netzwerk.set_dns_settings
data:
  internet_ipv4_custom: true
  internet_ipv4_dns1: "9.9.9.9"
  internet_ipv4_dns2: "149.112.112.112"
  dry_run: true

fritzbox_netzwerk.set_static_ip (experimentell)

Weist einem Gerät eine feste IPv4-Adresse zu. Braucht die Option „Statische IP-Adresse setzen“ (nicht für dry_run).

Feld Pflicht Bedeutung
mac ja MAC-Adresse
ip ja gewünschte Adresse
dry_run nein nur Prüfung 
action: fritzbox_netzwerk.set_static_ip
data:
  mac: "3C:A6:F6:00:11:22"
  ip: "192.168.178.50"
  dry_run: true

← Sensoren und Ereignisse | Inhaltsübersicht | Blueprints →

Abgerufen von „https://doku.meinesmartewelt.de/index.php?title=FRITZ!Box_Netzwerk/Dienste_(Aktionen)&oldid=26“