Set AvmHostFilterTicketMarked

Set-AvmHostFilterTicketMarked

Synopsis

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

Description

This function returns a TicketID and set their state to marked. Only unmarked TicketIDs can be retrieved.
The number of TicketIDs which can be marked at the same time is limited to 10.
If the return code 714 is retrieved, no unmarked TicketID is available.
If a new TicketID is needed, it is necessary to discard all (old) TicketIDs (see Update-AvmHostFilterTickets) or activate at least one of them.

Output:

Data type	Variable	Example
String	u	urn:dslforum-org:service:X_AVM-DE_HostFilter:1
String	NewTicketID	123456

Syntax

Set-AvmHostFilterTicketMarked
    [-Insecure]
    [-RemoteAccess]
    [-Url <String>]
    [-Port <Ushort>]
    [-Credential <PSCredential>]

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
}

Set-AvmHostFilterTicketMarked @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
}

Set-AvmHostFilterTicketMarked @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
}

Set-AvmHostFilterTicketMarked @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
}

Set-AvmHostFilterTicketMarked @splatParameters