Get AvmHostFilterWanAccessByIp

Get-AvmHostFilterWanAccessByIp

Synopsis

Action: GetWANAccessByIP
Available on: ✅ FRITZ!Box / 🚫 FRITZ!Repeater
Status: ✅
Remote access: 🚫
Required rights: 🔧 / ⚙️

Description

This function returns the state of WANAccess for the given LAN device’s IP address. The value of WANAccess represents the state of WAN access derived by configuration settings of Disallow and the LAN device’s filter profile.

Input:

Data type	Variable	Example or Description
String	NewIPv4Address	192.168.178.123

Output:

Data type	Variable	Example
String	u	urn:dslforum-org:service:X_AVM-DE_HostFilter:1
String	NewDisallow	0
String	NewWANAccess	granted, denied or error

Syntax

Get-AvmHostFilterWanAccessByIp
    [-Insecure]
    [-RemoteAccess]
    [-Url <String>]
    [-Port <Ushort>]
    [-Credential <PSCredential>]
    [-NewIPv4Address <String>]

Examples

Example 1

This example describes how to run the command using local connection with a valid certificate.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"

$splatParameters = @{
    Url = "https://fritz.box"
    Port = 49443
    Credential = $Credential
    NewIPv4Address = "192.168.178.123"
}

Get-AvmHostFilterWanAccessByIp @splatParameters

IP address can be used instead of DNS name.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"

$splatParameters = @{
    Url = "https://192.168.178.1"
    Port = 49443
    Credential = $Credential
    NewIPv4Address = "192.168.178.123"
}

Get-AvmHostFilterWanAccessByIp @splatParameters

Example 2

This example describes how to run the command using local connection without a valid certificate.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"

$splatParameters = @{
    Insecure = $true
    Url = "http://fritz.box"
    Port = 49000
    Credential = $Credential
    NewIPv4Address = "192.168.178.123"
}

Get-AvmHostFilterWanAccessByIp @splatParameters

IP address can be used instead of DNS name.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"

$splatParameters = @{
    Insecure = $true
    Url = "http://192.168.178.1"
    Port = 49000
    Credential = $Credential
    NewIPv4Address = "192.168.178.123"
}

Get-AvmHostFilterWanAccessByIp @splatParameters