Public/Set-TemperatureControllerTemp.ps1
|
function Set-TemperatureControllerTemp { <# .NAME Set-TemperatureControllerTemp .SYNOPSIS Get information about your TemperatureController(s) .PARAMETER Id Id of your TemperatureController .PARAMETER Name Name of your TemperatureController .PARAMETER Temperature Temperature target for your TemperatureController .INPUTS System.String System.Double .OUTPUTS System.Object .EXAMPLE Set-TemperatureControllerTemp -Id $id -Temperature $temp .RELATED LINKS https://api.rapt.io/index.html #> [CmdletBinding(SupportsShouldProcess)][OutputType('System.Management.Automation.PSObject')] Param ( [Parameter(Mandatory = $false)] [ValidateNotNullOrEmpty()] [string]$Id, [Parameter(Mandatory = $false)] [ValidateNotNullOrEmpty()] [string]$Name, [Parameter(Mandatory = $true)] [Alias('Temp')] [ValidateNotNullOrEmpty()] [double]$Temperature ) Begin { # Check if connection to RAPT portal exists If (-not (Get-Variable -Name raptObj -Scope Script -ErrorAction SilentlyContinue)) { throw "Please connect to the RAPT.io portal using the Connect-Rapt cmdlet" } $uri = "$($Script:raptObj.baseUri)/api/TemperatureControllers/SetTargetTemperature" # Check time left on token; if less than 2 minutes, refresh it. $timeLeft = New-TimeSpan $(Get-Date) $Script:raptObj.expireTime If ($timeLeft.Minutes -LT 2 -and $Script:raptObj) { Connect-Rapt -username $Script:raptObj.username -apiKey $Script:raptObj.apiKey } # Use the script-scoped token $token = $Script:raptObj.accessToken $header = @{ 'Accept' = 'application/json' 'Accept-Encoding' = 'gzip, compress, br' 'Authorization' = "Bearer ${token}" } If ($PSBoundParameters.ContainsKey('Name')){ $Id = (Get-TemperatureController | Where-Object {$_.Name -EQ $Name}).Id } $body = @{ TemperatureControllerId = $Id target = $Temperature } } Process { if ($PSCmdlet.ShouldProcess($Id, "Modify device settings")) { try { $params = @{ uri = $uri headers = $header body = $body method = 'POST' } $response = Invoke-RestMethod @params } catch [Exception]{ throw $_.Exception } return $response } } End { } } |