Functions/Hue/Get-HueRoom.ps1
|
function Get-HueRoom { <# .Synopsis Gets Hue Groups .Description Gets Groups from one or more Hue Bridges .Example Get-HueRoom .Link Remove-HueRoom .Link Get-HueBridge .Link Send-HueBridge #> [CmdletBinding(DefaultParameterSetName='ConnectionInfo')] [OutputType([PSObject])] param( #If set, will get the schedules defined on the Hue bridge [Parameter(ParameterSetName='Schedules', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Schedules','Timer','Timers')] [switch] $Schedule, #If set, will get the rules defined on the Hue bridge [Parameter(ParameterSetName='Rules', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Rules','Trigger','Triggers')] [switch] $Rule, #If set, will get the scenes defined on the Hue bridge [Parameter(ParameterSetName='Scenes', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Scenes')] [switch] $Scene, #If set, will get the sensors defined on the Hue bridge [Parameter(ParameterSetName='Sensors', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Sensors')] [switch] $Sensor, #If set, will get the groups (or rooms) defined on the Hue bridge [Parameter(ParameterSetName='Groups', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Groups','Room','Rooms')] [switch] $Group, #If set, will get the device configuration [Parameter(ParameterSetName='Config', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [switch] $Configuration, #If set, will get the device capabilities [Parameter(ParameterSetName='Capabilities', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Capabilities')] [switch] $Capability, #If set, will get resources defined on the device [Parameter(ParameterSetName='Resourcelinks', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Resources','ResourceLink','ResourceLinks')] [switch] $Resource, #If set, will get the lights defined on the device [Parameter(ParameterSetName='Lights', Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [Alias('Lights')] [switch] $Light, #If provided, will filter returned items by name [Parameter(Position=0, ValueFromPipelineByPropertyName=$true)] [string[]] $Name, #If set, will treat the Name parameter as a regular expression pattern. By default, Name will be treated as a wildcard [Parameter(ValueFromPipelineByPropertyName=$true)] [switch] $RegularExpression, #If set, will treat the Name parameter as a specific match [Parameter(ValueFromPipelineByPropertyName=$true)] [switch] $ExactMatch, #If provided, will filter returned items by ID [Parameter(ValueFromPipelineByPropertyName=$true)] [string[]] $ID, #If set, will requery each returned resource to retreive additional information. [switch] $Detailed ) process { $GetHueBridgeParametersDefault = ConvertFrom-Json @' { "Groups": true } '@ $GetHueBridgeParameters = @{} foreach ($property in $GetHueBridgeParametersDefault.psobject.properties) { $GetHueBridgeParameters[$property.Name] = $property.Value if ($property.Value -is [string] -and $property.Value.StartsWith('$')) { $GetHueBridgeParameters[$property.Name] = $executionContext.SessionState.PSVariable.Get($property.Value.Substring(1)).Value } } #region Copy Parameters from Get-HueBridge $MyParameters = [Ordered]@{} + $psBoundParameters # Copy $PSBoundParameters foreach ($in in 'Name','ExactMatch','RegularExpression','ID','Detailed') { if (-not $GetHueBridgeParameters.$in -and $myParameters.$in) { $GetHueBridgeParameters.$in = $myParameters.$in } } #endregion Copy Parameters from Get-HueBridge Get-HueBridge @GetHueBridgeParameters } } |