public/Set-AxisParameter.ps1
|
<#
.SYNOPSIS Updates the parameter(s) of an Axis device. .DESCRIPTION The Set-AxisParameter function is used to update the parameter(s) of an Axis device. It supports updating a single parameter or multiple parameters at once. .PARAMETER Device Specifies the hostname or IP address of the Axis device. .PARAMETER Parameter Specifies the name of the parameter to update. .PARAMETER Value Specifies the new value for the parameter. .PARAMETER ParameterSet Specifies a hashtable containing the parameters and their corresponding values to update. .EXAMPLE Set-AxisParameter -Device "192.168.1.100" -Parameter "Brightness" -Value "50" Updates the 'Brightness' parameter of the Axis device with the value '50'. .EXAMPLE Set-AxisParameter -Device "192.168.1.100" -ParameterSet @{ "Brightness" = "50" "Contrast" = "75" } Updates the 'Brightness' and 'Contrast' parameters of the Axis device with the specified values. #> function Set-AxisParameter { [cmdletbinding(DefaultParameterSetName='Single')] [Alias("Update-AxisParameter")] Param( [Parameter(Mandatory=$true, ParameterSetName='Single')] [Parameter(Mandatory=$true, ParameterSetName='Multiple')] [String]$Device, [Parameter(Mandatory=$true, ParameterSetName='Single')] [String]$Parameter, [Parameter(Mandatory=$true, ParameterSetName='Single')] [String]$Value, [Parameter(Mandatory=$true, ParameterSetName='Multiple')] [Hashtable]$ParameterSet ) if($PSCmdlet.ParameterSetName -eq 'Single') { $ParameterSet = @{} $ParameterSet[$Parameter] = $Value } $URIString = "" ForEach ($p in $ParameterSet.Keys) { $URIString += "&$p=$([System.Web.HttpUtility]::UrlPathEncode($ParameterSet[$p]))" } $Param = @{ Device = $Device Path = "/axis-cgi/param.cgi?action=update$($URIString)" } $result = Invoke-AxisWebApi @Param if($result -ne 'OK') { Throw "Unable to update parameter(s)" } } |