Functions/PSVersion7/Connect-AvmDevice.ps1
|
function Connect-AvmDevice { <# .SYNOPSIS Wiki: https://github.com/Gincules/avmtools/wiki .DESCRIPTION Wiki: https://github.com/Gincules/avmtools/wiki .NOTES Author: Gincules Website: https://github.com/Gincules/avmtools License: https://github.com/Gincules/avmtools/blob/main/LICENSE .LINK https://github.com/Gincules/avmtools https://github.com/Gincules/avmtools/blob/main/LICENSE #> Param ( [Parameter()] [System.Management.Automation.SwitchParameter]$Insecure, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String]$Url, [Parameter(Mandatory)] [ValidateRange(0,65535)] [System.UInt16]$Port, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCredential]$Credential, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String]$UrlPath, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String]$SoapAction, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String]$XmlResponse, [Parameter()] $Body = $null ) # if body is $null a universal (for PowerShell not valid) xml will be assigned as string for body $Body ??= '<?xml version="1.0"?><s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><s:Body><u:Response/></s:Body></s:Envelope>' -as [System.String] [System.Collections.Hashtable]$SplatParameters = @{ Uri = $Url + ":" + $Port + $UrlPath Method = "Post" Credential = $Credential ContentType = "text/xml;charset=utf-8" Body = $Body Headers = @{ "SoapAction" = $SoapAction "User-Agent" = "AVM UPnP/1.0 Client 1.0" } StatusCodeVariable = "StatusCode" ErrorVariable = "ResponseError" } # PowerShell 7.2 # call TR-064 api and catch error [System.Net.Http.HttpResponseMessage]$WebResponse = ` Try { ` if ($Insecure) { ` [System.Xml.XmlDocument]$AvmResponse = Invoke-RestMethod @SplatParameters -AllowUnencryptedAuthentication ` } else { ` [System.Xml.XmlDocument]$AvmResponse = Invoke-RestMethod @SplatParameters ` } ` } Catch { ` $_.Exception.Response ` } # if http status code is 200 (OK) return XML of FRITZ!Box response, else return http exeption response and response error return ($StatusCode -eq 200) ? $AvmResponse.Envelope.Body.$XmlResponse : $WebResponse, $ResponseError } |