Get-PublicIpByFritz

ÜBERSICHT

Liest die öffentliche IPv4-Adresse direkt von einer Fritz!Box über den IGD-UPnP-Endpunkt.

SYNTAX

Get-PublicIpByFritz [[-FritzBoxAddress] <string>] [-AsObject] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion fragt die öffentliche IP-Adresse der Fritz!Box per SOAP über den IGD-UPnP-Endpunkt ab. Sie nutzt den Port 49000 und den Pfad /igdupnp/control/WANIPConn1, der von AVM für UPnP-Dienste vorgesehen ist. Die Antwort enthält die öffentliche IPv4-Adresse, sofern keine DS-Lite-Verbindung (= Dual Stack Lite) besteht.

Bei Bedarf kann die Ausgabe als Objekt mit Metadaten erfolgen (z. B. Zeitpunkt, Quelle, Hostname).

PARAMETER

-FritzBoxAddress

Type: string
Default: "fritz.box"

Hostname oder IP-Adresse der Fritz!Box. Standardwert ist 'fritz.box'.

-AsObject

Type: switch

Gibt statt eines reinen Strings ein Objekt mit IP-Adresse, Zeitpunkt, Quelle und Hostname zurück.

AUSGABEN

string, PSCustomObject

BEISPIELE

# Liest die öffentliche IPv4-Adresse von der Fritz!Box und gibt sie als String zurück.
Get-PublicIpByFritz

# Gibt ein Objekt mit IP-Adresse und weiteren Metadaten zurück.
Get-PublicIpByFritz -FritzBoxAddress "192.168.178.1" -AsObject

HINWEISE

Kompatibilität: PowerShell 5.1+, keine Module erforderlich