Functions/Hue/Get-HueBridge.ps1

function Get-HueBridge {
    <#
    .Synopsis
        Gets Hue Bridges
    .Description
        Gets Hue Bridges registered on the system, and gets Hue bridge resources.
    .Link
        Find-HueBridge
    .Link
        Join-HueBridge
    .Example
        Get-HueBridge
    #>

    [CmdletBinding(DefaultParameterSetName='ConnectionInfo',SupportsShouldProcess)]
    [OutputType([PSObject])]    
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="Parameters used as hints for Parameter Sets")]
    param(
    # If set, will get the schedules defined on the Hue bridge
    [Parameter(Mandatory=$true,ParameterSetName='Schedules',ValueFromPipelineByPropertyName=$true)]
    [Alias('Schedules', 'Timer', 'Timers')]
    [Switch]
    $Schedule,

    # If set, will get the rules defined on the Hue bridge
    [Parameter(Mandatory=$true,ParameterSetName='Rules',ValueFromPipelineByPropertyName=$true)]
    [Alias('Rules', 'Trigger', 'Triggers')]
    [Switch]
    $Rule,

    # If set, will get the scenes defined on the Hue bridge
    [Parameter(Mandatory=$true,ParameterSetName='Scenes',ValueFromPipelineByPropertyName=$true)]
    [Alias('Scenes')]
    [Switch]
    $Scene,

    # If set, will get the sensors defined on the Hue bridge
    [Parameter(Mandatory=$true,ParameterSetName='Sensors',ValueFromPipelineByPropertyName=$true)]
    [Alias('Sensors')]
    [Switch]
    $Sensor,

    # If set, will get the groups (or rooms) defined on the Hue bridge
    [Parameter(Mandatory=$true,ParameterSetName='Groups',ValueFromPipelineByPropertyName=$true)]
    [Alias('Groups','Room', 'Rooms')]
    [Switch]
    $Group,

    # If set, will get the device configuration
    [Parameter(Mandatory=$true,ParameterSetName='Config',ValueFromPipelineByPropertyName=$true)]
    [Switch]
    $Configuration,

    # If set, will get the device capabilities
    [Parameter(Mandatory=$true,ParameterSetName='Capabilities',ValueFromPipelineByPropertyName=$true)]
    [Alias('Capabilities')]
    [Switch]
    $Capability,

    # If set, will get resources defined on the device
    [Parameter(Mandatory=$true,ParameterSetName='Resourcelinks',ValueFromPipelineByPropertyName=$true)]
    [Alias('Resources', 'ResourceLink', 'ResourceLinks')]
    [Switch]
    $Resource,

    # If set, will get the lights defined on the device
    [Parameter(Mandatory=$true,ParameterSetName='Lights',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
    )


    begin {
        if ($home) { # If there's a $home directory, construct a LightScript root.
            $lightScriptRoot = Join-Path $home -ChildPath LightScript
        }
        if (-not $script:cachedBridges) { # If there were not cached bridges
            $script:cachedBridges = if (Test-Path $lightScriptRoot) { # and the LightScript root exists
                Get-ChildItem -Path $lightScriptRoot -Filter *.huebridge.clixml -Force | # find any bridge files.
                    Import-Clixml -Path { $_.FullName } # and import the clixml.
            }  else {
                @()
            }

            $script:cachedBridges = foreach ($cb in @($script:cachedBridges)) {
                $pingedIt =
                    if ($PSVersionTable.Platform -ne 'Unix') {
                        @(ping -w 1000 $cb.IPAddress -n 1) -like 'reply*'
                    } else {
                        @(@(ping -w 1 $cb.IPAddress -c 1) -match $($cb.IPAddress -replace '\.','\.')).Count -gt 2
                    }
                if (-not $pingedIt) {
                    Write-Warning "Hue Bridge '$($cb.DeviceID)' not found at $($cb.IPAddress)"
                } else {
                    $cb
                }
            }

        }
        $bridges = $script:cachedBridges
    }

    process {
        if ($PSCmdlet.ParameterSetName -eq 'ConnectionInfo') {
            $bridges
        } else {
            $bridges | # Get all bridges
                Send-HueBridge -Command $PSCmdlet.ParameterSetName.ToLower() | # get the set of data we want from the bridge.
                ForEach-Object {
                    if ($WhatIfPreference) { return $_ }
                    if ('Config', 'Capabilities' -contains $psCmdlet.ParameterSetName) {
                        return $_ # config and capabilities are directly returned.
                    }
                    $list = $_ # the rest of things are returned as a list packed into a single object.

                    #region Unroll results
                    :ToTheNextItem foreach ($item in $list.psobject.properties) { # Walk over each property in the object.
                        if ($item.Name -as [int] -eq $null -and $PSCmdlet.ParameterSetName -ne 'scenes') { continue }
                        if ('IPAddress', 'HueUserName' -contains $item.Name) { continue }
                        $itemId = $item.Name
                        if ($ID -and $ID -notcontains $itemId) { continue }
                        $itemObject = @{
                            ID = $itemId
                            IPAddress = $list.IPAddress
                            HueUserName = $list.HueUserName
                            PSTypeName="Hue.$($PSCmdlet.ParameterSetName.TrimEnd('s'))"
                        }
                        $itemInfo = $item.Value
                        $allProperties = @($itemInfo.psobject.properties)
                        foreach ($prop in $allProperties) {
                            $itemObject[$prop.Name] = $prop.Value
                        }

                        if ($Name) {
                            $matched = foreach ($n in $Name) {
                                if ($RegularExpression -and $itemObject.Name -match $N) {
                                    $true
                                    break
                                } elseif ($ExactMatch -and $itemObject.Name -eq $N) {
                                    $true
                                    break
                                } elseif ($itemObject.Name -like $n) {
                                    $true
                                    break
                                }
                            }

                            if (-not $matched) { continue ToTheNextItem }
                        }

                        if ($Detailed) {
                            [PSCustomObject]$itemObject |
                                Send-HueBridge -Command ($psCmdlet.ParameterSetName.ToLower() + '/' + $itemId)
                        } else {
                            [PSCustomObject]$itemObject
                        }
                    }
                    #endregion Unroll results
                }
        }
    }
}