Functions/Hue/Set-HueLight.ps1

function Set-HueLight
{
    <#
    .Synopsis
        Sets Hue light state
    .Description
        Changes the state of one or more Hue lights
    .Example
        Set-HueLight -Name *Lightstrip* -Luminance 0.05 # Set any Hue lights named Hue lightstrip to be very dim
    .Example
        LivingRoom -On -ColorTemperature 500 -Brightness .1
        # Room names and light names are automatically aliased to Set-HueLight.
        # This gives all lights in the living room a warm glow.
    .EXAMPLE
        Set-HueLight -Alert select # Make all of the lights blink once
    .EXAMPLE
        Set-HueLight -Effect colorloop # Set all lights to color loop
    .EXAMPLE
        Set-HueLight -Effect none # Make all of the lights stop looping color
    .EXAMPLE
        Set-HueLight -RGBColor "#ff0000" # Make all lights red
    .EXAMPLE
        Set-HueLight -Hue 120 -Saturation .8 -Brightness .6 # Make all lights green
    .EXAMPLE
        Set-HueLight -HueIncrement 60 # Move the hue of all lights
    .Link
        Get-HueLight
    #>

    [CmdletBinding(SupportsShouldProcess=$true,ConfirmImpact='Low',DefaultParameterSetName='All')]
    [OutputType([PSObject])]
    param(
    # The name of the Hue light
    [Parameter(Mandatory=$true,Position=0,ParameterSetName='Lights',ValueFromPipelineByPropertyName)]
    [Alias('LightName')]
    [string[]]
    $Name,

    # The name of the Hue room
    [Parameter(Mandatory=$true,Position=0,ParameterSetName='Rooms')]
    [Alias('Group', 'GroupName','Room')]
    [string[]]
    $RoomName,

    # The identifier of the Hue light
    [Parameter(Mandatory=$true,Position=0,ParameterSetName='LightID',ValueFromPipelineByPropertyName)]
    [string]
    $LightID,

    # The identifier of the Hue group
    [Parameter(Mandatory=$true,Position=0,ParameterSetName='GroupID')]
    [string]
    $GroupID,

    # The transition time. This is how long it will take light to change from it's current state to the one you've set
    [Parameter(Position=1,ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('transitiontime')]
    [ComponentModel.AmbientValue({  [int][Math]::Floor(($_.TotalMilliseconds / 100))})]
    [Timespan]
    $TransitionTime,

    # If set, will switch the light on
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('on')]
    [switch]$On,

    # If set, will switch the light off
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.AmbientValue({@{on = $false}})]
    [switch]$Off,


    # Sets lights to an RGB color
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.AmbientValue({
        $fromRgb = ([PSCustomObject]@{PSTypeName='LightScript.Color'}).FromRGB($_)
        @{
            hue=[uint16][Math]::Floor(($fromRgb.Hue / 360) * [Uint16]::maxValue)
            sat=[byte][Math]::min([Math]::Max($(255 * $fromRgb.Saturation), 1), 254)
            bri=[byte][Math]::min([Math]::Max($(255 * $fromRgb.Luminance), 1), 254)
        }
    })]
    [string]
    $RGBColor,

    # The desired hue (ranged 0-360)
    [ValidateRange(0,360)]
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('hue')]
    [ComponentModel.AmbientValue({ 
        [uint16][Math]::Floor(($_ / 360) * [Uint16]::maxValue)
    })]
    [Alias('H')]
    [float]
    $Hue,

    # The desired saturation (ranged 0-1)
    [Parameter(ValueFromPipelineByPropertyName)]
    [ValidateRange(0,1)]
    [ComponentModel.DefaultBindingProperty('sat')]
    [ComponentModel.AmbientValue({ [byte](255 * $_) })]
    [Alias('S')]
    [float]
    $Saturation,

    # The desired brightness (ranged 0-1)
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('bri')]
    [ComponentModel.AmbientValue({ [byte](255 * $_) })]
    [ValidateRange(0,1)]
    [Alias('B','L','Luminance','.bri')]
    [float]
    $Brightness,

    # The effect
    [ValidateSet('colorloop', 'none')]
    [ComponentModel.DefaultBindingProperty('effect')]
    [Parameter(ValueFromPipelineByPropertyName)]
    [string]
    $Effect,

    # The alert
    [ValidateSet('select','lselect', 'none')]
    [ComponentModel.DefaultBindingProperty('alert')]
    [Parameter(ValueFromPipelineByPropertyName)]
    [string]
    $Alert,

    # The color temperature as a Mired value.
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('ct')]
    [ComponentModel.AmbientValue({
        if ($_ -gt 500) {
            [int](1000000/$_)
        } else {
            $_
        }
    })]
    [ValidateRange(153,7875)]
    [Alias('CT','TemperatureMired')]
    [int]
    $ColorTemperature,

    # The color, in XY coordinates.
    [Parameter(ValueFromPipelineByPropertyName)]
    [ValidateScript({
    if (-not ($_.Count -ne 2)) { throw 'Must provide 2 values to use XY coordinates' }
    return $true
    })]
    [ValidateRange(0,1)]
    [ComponentModel.DefaultBindingProperty('xy')]
    [float[]]
    $XY,

    # The increment in saturation. This will adjust the intensity of the color.
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('sat_inc')]
    [ValidateRange(-1,1)]
    [ComponentModel.AmbientValue({
        if ($_ -lt 0) {
            [Math]::max(-254,
                ([int][Math]::Floor(([Math]::Abs($_) / 1) * [byte]::maxValue)) * -1
            )
        } elseif ($_ -gt 0) {
            [Math]::min(254,
                [int][Math]::Floor(($_ / 1) * [byte]::maxValue)
            )
        } else {
            0
        }        
    })]
    [float]
    $SaturationIncrement,

    # An increment in luminance. This will adjust the brightness of the light.
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('bri_inc')]
    [ComponentModel.AmbientValue({
        if ($_ -lt 0) {
            [Math]::max(-254,
                ([int][Math]::Floor(([Math]::Abs($_) / 1) * [byte]::maxValue)) * -1
            )
        } elseif ($_ -gt 0) {
            [Math]::min(254,
                [int][Math]::Floor(($_ / 1) * [byte]::maxValue)
            )
        } else {
            0
        }        
    })]
    [Alias('LuminanceIncrement')]
    [ValidateRange(-1,1)]
    [float]
    $BrightnessIncrement,

    # An increment in hue. This will adjust the hue
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('hue_inc')]
    [ComponentModel.AmbientValue({
        [int][Math]::Floor(($_ / 360) * [Uint16]::maxValue)
    })]
    [ValidateRange(-360,360)]
    [int]
    $HueIncrement,

    # A change in the color temperature.
    [Parameter(ValueFromPipelineByPropertyName)]
    [ComponentModel.DefaultBindingProperty('ct_inc')]
    [ValidateRange(-65534,65534)]
    [int]
    $ColorTemperatureIncrement,

    # If set, will output the data that would be sent to the bridge. This is useful for creating scheudles, routines, and other macros.
    [Parameter(ValueFromPipelineByPropertyName)]
    [Alias('OutputParameter','OutputParameters','OutputArgument', 'OutputArguments')]
    [switch]
    $OutputInput
    )

    begin {
        $getLightCmd = $ExecutionContext.SessionState.InvokeCommand.GetCommand('Get-HueLight', 'Function')

        $mapInput = {
            param(
            [Collections.IDictionary]$parameter = ([Ordered]@{} + $PSBoundParameters),
            $Caller = $(
                foreach ($CallStack in Get-PSCallStack) {
                    $callstackCmd = $callStack.InvocationInfo.MyCommand
                    if ($callstackCmd -is [Management.Automation.FunctionInfo] -or
                        $callstackCmd -is [Management.Automation.ExternalScriptInfo]) {
                        $callstackCmd;break
                    }
                })
            )

            $RestInput = @{}
            :nextParameter foreach ($paramName in $parameter.Keys) {
                $paramAttributes = $Caller.Parameters[$paramName].Attributes
                $restParamName   = ''
                $value = $_ = $parameter[$paramName]
                :nextAttribute foreach ($attr in $paramAttributes) {
                    if ($attr -is [ComponentModel.DefaultBindingPropertyAttribute]) {
                        $restParamName = $attr.Name
                    }
                    elseif ($attr -is [ComponentModel.AmbientValueAttribute] -and $attr.Value -is [ScriptBlock]) {
                        $value = $_ = & $attr.Value
                    }
                }
                if ($restParamName) {
                    $RestInput[$restParamName] = $value
                    if ($RestInput[$restParamName] -is [switch]) {
                        $RestInput[$restParamName] = $RestInput[$restParamName] -as [bool]
                    }
                } elseif ($value -is [Collections.IDictionary]) {
                    foreach ($kv in $value.GetEnumerator()) {
                        $RestInput[$kv.Key] = $kv.Value
                    }
                }
            }
            $RestInput
        }

        $invocatonName = $MyInvocation.InvocationName
        $invocationCommand = $MyInvocation.MyCommand
    }


    process {
        $lightSplat = @{} + $PSBoundParameters
        foreach ($k in @($lightSplat.Keys)) {
            if (-not $getLightCmd.Parameters.$k) {
                $lightSplat.Remove($k)
            }
        }



        $restIn = & $mapInput

        $sendSplat = @{
            Method = if ($restIn.Count) { 'PUT' } else { 'GET' }
            Data = $restIn
        }
        

        if (-not $restIn.Count) {
            $sendSplat.Remove('Data')
        }
        if ($OutputInput) {
            $sendSplat.OutputInput = $OutputInput
        }

        $paramSet = $PSCmdlet.ParameterSetName

        $bridges = Get-HueBridge
        switch ($paramSet) {
            All {

                if ($invocatonName -ne $invocationCommand.Name) {
                    foreach ($potentialResource in $script:KnownResources) {
                        if ($potentialResource.Name -eq $invocatonName -or
                            (($potentialResource.Name -replace '\s') -eq $invocatonName)
                        ) {
                            if ($potentialResource.action) { #If there's an action, it's a group
                                if ($restIn.Count) {
                                    $sendSplat.Command = "groups/$($potentialResource.id)/action"
                                } else {
                                    $sendSplat.Command = "groups/$($potentialResource.id)"
                                    $sendSplat.PSTypeName = 'Hue.LightGroup'
                                }
                                break
                            }
                            if ($potentialResource.state) { # If there's a state, it's a light
                                if ($restIn.Count) {
                                    $sendSplat.Command = "lights/$($potentialResource.id)/state"
                                } else {
                                    $sendSplat.Command = "lights/$($potentialResource.id)"
                                    $sendSplat.PSTypeName = 'Hue.Light'
                                }
                                break
                            }
                        }
                    }
                    if ($sendSplat.Command) {
                        $bridges | Send-HueBridge @sendSplat
                    }
                    return
                }

                # Get all bridges and send the data to the url that changes all lights

                if ($restIn.Count) {
                    $sendSplat.Command = "groups/0/action"
                } else {
                    $sendSplat.Command = "groups/0"
                    $sendSplat.PSTypeName = 'Hue.LightGroup'
                }


                $bridges | Send-HueBridge @sendSplat
            }
            Rooms {
                # Getting and filtering the rooms
                $RoomSplat = @{} + $lightSplat
                $RoomSplat.Name =  $RoomName
                $rooms = Get-HueBridge -Room @RoomSplat
                if (-not $restIn.Count) { $sendSplat.PSTypeName = 'Hue.LightGroup'}
                $Rooms |
                    Send-HueBridge -Command {
                        if ($restIn.Count) {
                            "groups/$($_.ID)/action"
                        } else {
                            "groups/$($_.ID)"
                        }
                    } @sendSplat
            }
            LightID {
                if ($restIn.Count) {
                    $sendSplat.Command = "lights/$lightID/state"
                } else {
                    $sendSplat.Command = "lights/$lightID"
                    $sendSplat.PSTypeName = 'Hue.Light'
                }

                $bridges |
                    Send-HueBridge @sendSplat
            }
            GroupID {
                if ($restIn.Count) {
                    $sendSplat.Command = "groups/$lightID/action"
                } else {
                    $sendSplat.Command = "groups/$lightID"
                    $sendSplat.PSTypeName = 'Hue.LightGroup'
                }
                $bridges |
                    Send-HueBridge  @sendSplat
            }
            default {
                $theLights = Get-HueLight @lightSplat
                if (-not $restIn.Count) {
                    $theLights
                } else {
                    $theLights |
                        Send-HueBridge -Command { "lights/$($_.ID)/state" } @sendSplat
                }
            }
        }

    }
}