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)] [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)] [ValidateSet('Switch','OpenClose','Presence','Temperature','Humidity','LightLevel', 'GenericFlag', 'GenericStatus')] [string] $SensorType, # The sensor ModelID [Parameter(Position=2,ValueFromPipelineByPropertyName)] [string] $ModelID = "ABCD-12345", # The sensor manufacturer [Parameter(Position=2,ValueFromPipelineByPropertyName)] [string] $Manufacturer = "ACME LTD", # The sensor unique ID. [Parameter(Position=3,ValueFromPipelineByPropertyName)] [string] $UniqueID= [guid]::NewGuid().tostring('n'), # The sensor version. [Parameter(Position=4,ValueFromPipelineByPropertyName)] [Version] $Version = '0.1' ) begin { $myCmd = $MyInvocation.MyCommand } process { #region Prepare REST Input $sensorType = foreach ($_ in $myCmd.Parameters['SensorType'].Attributes) { if (-not $_.ValidValues) { continue } $_.ValidValues -eq $SensorType break } $sensorRest = @{ name = $Name modelid = $ModelID swversion = "$Version" type = 'CLIP' + $SensorType uniqueid = $UniqueID manufacturername = $Manufacturer recycle = $false } #endregion Prepare REST Input if ($WhatIfPreference) { return $sensorRest } if ($PSCmdlet.ShouldProcess("Add-HueSensor $name")) { Get-HueBridge | Send-HueBridge -Method POST -Data $sensorRest -Command 'sensors' } } } |