Get AvmDeviceConfigFile - Gincules/avmtools GitHub Wiki

Get-AvmDeviceConfigFile

Synopsis

Action: X_AVM-DE_GetConfigFile
Available on: ✅ FRITZ!Box / ✅ FRITZ!Repeater
Status: ⚠ī¸
Remote access: ✅
Required rights: 🔧

Description

This function uses the given password to offer an encrypted password file to be downloaded at the given URL.

The URL is secured by SSL (https://) using the TR-064 SSL certificate.
The URL is secured by Digest authorization using the currently active username and password of the TR-064 service.

The URL is valid for less than 30 seconds.

Input:

Data type Variable Example or Description
SecureString NewPassword empty or password as SecureString

Output:

Data type Variable Example
String u urn:dslforum-org:service:DeviceConfig:1
String NewX_AVM-DE_ConfigFileUrl

Syntax

Get-AvmDeviceConfigFile
    [-Insecure]
    [-RemoteAccess]
    [-Url <String>]
    [-Port <Ushort>]
    [-Credential <PSCredential>]
    [-NewPassword <SecureString>]

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"
[SecureString]$NewPassword = Get-Content -Path "${env:APPDATA}\PScred\function-password.txt" | ConvertTo-SecureString

$splatParameters = @{
    RemoteAccess = $true
    Url = "https://myfritzaddress12.myfritz.net"
    Port = 443
    Credential = $Credential
    NewPassword = $NewPassword 
}

Get-AvmDeviceConfigFile @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"
[SecureString]$NewPassword = Get-Content -Path "${env:APPDATA}\PScred\function-password.txt" | ConvertTo-SecureString

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

Get-AvmDeviceConfigFile @splatParameters

IP address can be used instead of DNS name.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"
[SecureString]$NewPassword = Get-Content -Path "${env:APPDATA}\PScred\function-password.txt" | ConvertTo-SecureString

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

Get-AvmDeviceConfigFile @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"
[SecureString]$NewPassword = Get-Content -Path "${env:APPDATA}\PScred\function-password.txt" | ConvertTo-SecureString

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

Get-AvmDeviceConfigFile @splatParameters

IP address can be used instead of DNS name.

[PSCredential]$Credential = Import-Clixml -Path "${env:APPDATA}\PScred\avmtools-credential.xml"
[SecureString]$NewPassword = Get-Content -Path "${env:APPDATA}\PScred\function-password.txt" | ConvertTo-SecureString

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

Get-AvmDeviceConfigFile @splatParameters

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

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