Functions/Twinkly/Get-Twinkly.ps1
|
function Get-Twinkly { <# .Synopsis Gets Twinkly .Description Gets Twinkly lights. .Example Get-Twinkly .Link Connect-Twinkly #> [CmdletBinding(PositionalBinding=$false,DefaultParameterSetName='ListDevices')] [OutputType([PSObject])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="Parameters used as hints for Parameter Sets")] param( # One or more IP Addresses of Twinkly devices. [Parameter(ValueFromPipelineByPropertyName)] [Alias('TwinklyIPAddress')] [IPAddress[]] $IPAddress, # If set, will get the operation mode [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/mode')] [switch] $OperationMode, # If set, will get the layout of the Twinkly lights. This may take a bit. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/layout/full')] [switch] $Layout, # If set, will get the color displayed when the Twinkly lights are in color mode. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/color')] [Alias('CurrentColour')] [switch] $CurrentColor, # If set, will list the available effects. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/effects')] [Alias('ListEffects')] [switch] $ListEffect, # If set, will show the current effect. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/effects/current')] [switch] $CurrentEffect, # If set, will list the configuration of each LED. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/config')] [Alias('Config')] [switch] $Configuration, # If set, will output the brightness levels. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/out/brightness')] [switch] $Brightness, # If set, will output the saturation levels. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/out/saturation')] [switch] $Saturation, # If set, will output the list of movies. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/movies')] [switch] $ListMovie, # If set, will output the list of movies. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/movies/current')] [switch] $CurrentMovie, # If set, will output movie configuration. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/led/movie/config')] [switch] $MovieConfiguration, # If set, will output the playlists. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/playlist')] [Alias('Playlists')] [switch] $Playlist, # If set, will output the current playlist item. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/playlist/current')] [switch] $CurrentPlaylistItem, # If set, will output the MQTT configuration. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/mqtt/config')] [Alias('MQTTConfig')] [switch] $MQTTConfiguration, # If set, will output the summary. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/summary')] [switch] $Summary, # If set, will output the network status. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/network/status')] [switch] $NetworkStatus, # If set, will output the network status. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/fw/version')] [switch] $FirmwareVersion, # If set, will output timers associated with each device. [Parameter(Mandatory,ValueFromPipelineByPropertyName,ParameterSetName='/xled/v1/timer')] [switch] $Timer ) begin { if (-not $script:TwinklyCache) { $script:TwinklyCache = @{} } if ($home) { $lightScriptRoot = Join-Path $home -ChildPath LightScript } } process { #region Default to All Devices if (-not $IPAddress) { # If no -IPAddress was passed if ($home) { # Read all .twinkly.clixml files beneath your LightScript directory. Get-ChildItem -Path $lightScriptRoot -ErrorAction SilentlyContinue -Filter *.twinkly.clixml -Force | Import-Clixml | ForEach-Object { if (-not $_) { return } $twinklyConnection = $_ # If the connection would have expired if ([DateTime]::Now -ge $twinklyConnection.Authentication_ExpiresAt) { # then reconnect. $twinklyConnection = Connect-Twinkly -IPAddress $twinklyConnection.IPAddress -PassThru } $script:TwinklyCache["$($twinklyConnection.IPAddress)"] = $twinklyConnection } $IPAddress = $script:TwinklyCache.Keys # The keys of the device cache become the -IPAddress. } if (-not $IPAddress) { # If we still have no -IPAddress Write-Warning "No -IPAddress provided and no cached devices found" # warn return # and return. } } #endregion Default to All Devices if ($PSCmdlet.ParameterSetName -like '/*') { foreach ($ip in $IPAddress) { $uri = "http://$ip$($PSCmdlet.ParameterSetName)" if ($VerbosePreference -ne 'silentlyContinue') { Write-Verbose "GET $uri" } Invoke-RestMethod -Uri $uri -Headers @{ "X-Auth-Token" = $script:TwinklyCache["$ip"].authentication_token } | & { process { $out = $_ $out.pstypenames.clear() $out.pstypenames.add(($PSCmdlet.ParameterSetName -replace '/xled/v1/' -replace '/', '.')) $out } } } } elseif ($PSCmdlet.ParameterSetName -eq 'ListDevices') { $script:TwinklyCache.Values } } } |