Get AvmAppMessageFilter

Get-AvmAppMessageFilter

Synopsis

Action: GetAppMessageFilter
Available on: ✅ FRITZ!Box / 🚫 FRITZ!Repeater
Status: ⚠️
Remote access: ✅
Required rights: 🔧 / ⚙️ / ☎️ / 🖴 / 🏠

Description

This function returns a list of all message-filters configured for an app instance.
The security context of this action must belong to an app instance.
The app instance of the security context must the same as the one identified by the parameter AppId.

Input:

Data type	Variable	Example or Description
String	NewAppId	Identifier of the app instance

Output:

Data type	Variable	Example
String	u	urn:dslforum-org:service:X_AVM-DE_AppSetup:1
String	NewFilterList	The result of action in a XML format

Syntax

Get-AvmAppMessageFilter
    [-Insecure]
    [-RemoteAccess]
    [-Url <String>]
    [-Port <Ushort>]
    [-Credential <PSCredential>]
    [-NewAppId <String>]

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
    NewAppId = "1"
}

Get-AvmAppMessageFilter @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
    NewAppId = "1"
}

Get-AvmAppMessageFilter @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
    NewAppId = "1"
}

Get-AvmAppMessageFilter @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
    NewAppId = "1"
}

Get-AvmAppMessageFilter @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
    NewAppId = "1"
}

Get-AvmAppMessageFilter @splatParameters