Add AvmRoutingEntry - Gincules/avmtools GitHub Wiki

Add-AvmRoutingEntry

Synopsis

Action: AddForwardingEntry
Available on: ✅ FRITZ!Box / đŸšĢ FRITZ!Repeater
Status: ✅
Remote access: ✅
Required rights: 🔧

Description

This function adds a rounting entry.

Input:

Data type Variable Example or Description
String NewType
String NewDestIPAddress
String NewDestSubnetMask
String NewSourceIPAddress
String NewSourceSubnetMask
String NewGatewayIPAddress
String NewInterface
String NewForwardingMetric

Output:

Data type Variable Example
String u urn:dslforum-org:service:Layer3Forwarding:1

Syntax

Add-AvmRoutingEntry
    [-Insecure]
    [-RemoteAccess]
    [-Url <String>]
    [-Port <Ushort>]
    [-Credential <PSCredential>]
    [-NewType <String>]
    [-NewDestIPAddress <String>]
    [-NewDestSubnetMask <String>]
    [-NewSourceIPAddress <String>]
    [-NewSourceSubnetMask <String>]
    [-NewGatewayIPAddress <String>]
    [-NewInterface <String>]
    [-NewForwardingMetric <Int>]

Examples

Example 1

This example describes how to run the command using a valid certificate and remote access.

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

$splatParameters = @{
    RemoteAccess = $true
    Url = "https://myfritzaddress12.myfritz.net"
    Port = 443
    Credential = $Credential
    NewType = "Host"
    NewDestIPAddress = "10.10.10.0"
    NewDestSubnetMask = "255.255.255.0"
    NewSourceIPAddress = "0.0.0.0"
    NewSourceSubnetMask = "0.0.0.0"
    NewGatewayIPAddress = "192.168.172.1"
    NewInterface = "LanHostConfigManagement1"
    NewForwardingMetric = 0 
}

Add-AvmRoutingEntry @splatParameters

Example 2

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
    NewType = "Host"
    NewDestIPAddress = "10.10.10.0"
    NewDestSubnetMask = "255.255.255.0"
    NewSourceIPAddress = "0.0.0.0"
    NewSourceSubnetMask = "0.0.0.0"
    NewGatewayIPAddress = "192.168.172.1"
    NewInterface = "LanHostConfigManagement1"
    NewForwardingMetric = 0 
}

Add-AvmRoutingEntry @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
    NewType = "Host"
    NewDestIPAddress = "10.10.10.0"
    NewDestSubnetMask = "255.255.255.0"
    NewSourceIPAddress = "0.0.0.0"
    NewSourceSubnetMask = "0.0.0.0"
    NewGatewayIPAddress = "192.168.172.1"
    NewInterface = "LanHostConfigManagement1"
    NewForwardingMetric = 0 
}

Add-AvmRoutingEntry @splatParameters

Example 3

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
    NewType = "Host"
    NewDestIPAddress = "10.10.10.0"
    NewDestSubnetMask = "255.255.255.0"
    NewSourceIPAddress = "0.0.0.0"
    NewSourceSubnetMask = "0.0.0.0"
    NewGatewayIPAddress = "192.168.172.1"
    NewInterface = "LanHostConfigManagement1"
    NewForwardingMetric = 0 
}

Add-AvmRoutingEntry @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
    NewType = "Host"
    NewDestIPAddress = "10.10.10.0"
    NewDestSubnetMask = "255.255.255.0"
    NewSourceIPAddress = "0.0.0.0"
    NewSourceSubnetMask = "0.0.0.0"
    NewGatewayIPAddress = "192.168.172.1"
    NewInterface = "LanHostConfigManagement1"
    NewForwardingMetric = 0 
}

Add-AvmRoutingEntry @splatParameters

Copyright Šī¸ 2020 Gincules. All rights reserved.

⚠ī¸ **GitHub.com Fallback** ⚠ī¸