Switch AvmHomeautoDevice - Gincules/avmtools GitHub Wiki
Action: SetSwitch
Available on: â
FRITZ!Box / đĢ FRITZ!Repeater
Status: â
Remote access: â
Required rights: đ§ / đ
This function returns allows to configure the state of the socket (not heaters!).
Input:
| Data type | Variable | Example or Description |
|---|---|---|
| String | NewAIN | |
| SwStateEnum | NewSwitchState | OFF,ON,TOGGLE |
Output:
| Data type | Variable | Example |
|---|---|---|
| String | u | urn:dslforum-org:service:X_AVM-DE_Homeauto:1 |
Switch-AvmHomeautoDevice
[-Insecure]
[-RemoteAccess]
[-Url <String>]
[-Port <Ushort>]
[-Credential <PSCredential>]
[-NewAIN <String>]
[-NewSwitchState <SwStateEnum>]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
NewAIN = "12345 1234567"
NewSwitchState = "OFF"
}
Switch-AvmHomeautoDevice @splatParametersThis 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
NewAIN = "12345 1234567"
NewSwitchState = "OFF"
}
Switch-AvmHomeautoDevice @splatParametersIP 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
NewAIN = "12345 1234567"
NewSwitchState = "OFF"
}
Switch-AvmHomeautoDevice @splatParametersThis 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
NewAIN = "12345 1234567"
NewSwitchState = "OFF"
}
Switch-AvmHomeautoDevice @splatParametersIP 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
NewAIN = "12345 1234567"
NewSwitchState = "OFF"
}
Switch-AvmHomeautoDevice @splatParameters