Functions/Hue/Add-HueSensor.ps1
|
function Add-HueSensor { <# .Synopsis Adds a sensor to a Hue Bridge. .Description Adds sensors to a Hue Bridge. Sensors can be physical sensors, such as a motion detector, or virtual sensors, such as GenericFlag. .Link Get-HueSensor .Example Add-HueSensor -Name "ChaseStatus1" -SensorType GenericStatus #> [OutputType([PSObject])] [CmdletBinding(SupportsShouldProcess)] param( # The name of the sensor. [Parameter(Mandatory,Position=0,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [string] $Name, <# The sensor type. Sensors can be: * Switches * OpenClose * Presence (motion detectors) * Temperature * Humidity * LightLevel * GenericFlag (used for virtual sensors) * GenericStatus (used for virtual sensors) #> [Parameter(Mandatory,Position=1,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [ValidateSet('Switch','OpenClose','Presence','Temperature','Humidity','LightLevel', 'GenericFlag', 'GenericStatus')] [string] $SensorType, # The sensor ModelID [Parameter(Position=2,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [string] $ModelID = "ABCD-12345", # The sensor manufacturer [Parameter(Position=2,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [string] $Manufacturer = "ACME LTD", # The sensor unique ID. [Parameter(Position=3,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [string] $UniqueID= [guid]::NewGuid().tostring('n'), # The sensor version. [Parameter(Position=4,ValueFromPipelineByPropertyName,ParameterSetName='CustomSensor')] [Version] $Version = '0.1', # If set, will search for new sensors to add. [Parameter(Mandatory,ParameterSetName='NewSensor')] [Alias('Find','Discover')] [switch] $New ) begin { $myCmd = $MyInvocation.MyCommand } process { #region Prepare REST Input $sensorRest = if ($PSCmdlet.ParameterSetName -eq 'CustomSensor') { if ($SensorType) { $sensorType = foreach ($_ in $myCmd.Parameters['SensorType'].Attributes) { if (-not $_.ValidValues) { continue } $_.ValidValues -eq $SensorType break } } @{ name = $Name modelid = $ModelID swversion = "$Version" type = 'CLIP' + $SensorType uniqueid = $UniqueID manufacturername = $Manufacturer recycle = $false } } elseif ($New) { $name = "new" } #endregion Prepare REST Input if ($WhatIfPreference) { return $sensorRest } if ($PSCmdlet.ShouldProcess("Add-HueSensor $name")) { Get-HueBridge | Send-HueBridge -Method POST -Data $sensorRest -Command "sensors" } } } |