FRITZ!Box Netzwerk/Dienste (Aktionen)

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 →