Functions/PSVersion5/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 if ($null -eq $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" } } # PowerShell 5.1 # call TR-064 api [System.Net.HttpWebResponse]$WebResponse = ` Try { ` [System.Xml.XmlDocument]$AvmResponse = Invoke-WebRequest @SplatParameters ` } Catch { ` $_.Exception.Response ` } # if http status code is 200 (OK) return XML of FRITZ!Box response, else return http web response if ($AvmResponse.StatusCode -eq 200) { return [System.Xml.XmlDocument]$AvmResponse.Content.Envelope.Body.$XmlResponse } else { return $WebResponse } } |