Public/Set-ReaderMode.ps1
|
<#
.SYNOPSIS Sets a reader to the specified reader mode. .DESCRIPTION Sets a reader to the specified reader mode. If the result returns null, try the parameter "-Verbose" to get more details. .EXAMPLE .LINK https://github.com/erwindevreugd/PSDataConduIT .EXTERNALHELP PSDataConduIT-help.xml #> function Set-ReaderMode { [CmdletBinding()] param ( [Parameter( Position = 0, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The name of the server where the DataConduIT service is running or localhost.')] [string] $Server = $Script:Server, [Parameter( Position = 1, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The credentials used to authenticate the user to the DataConduIT service.')] [PSCredential] $Credential = $Script:Credential, [ValidateRange(1, 2147483647)] [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Specifies the panel id of the reader for which to set the reader mode.')] [int] $PanelID, [ValidateRange(1, 2147483647)] [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Specifies the reader id of the reader for which to set the reader mode.')] [int] $ReaderID, [Parameter( Mandatory = $true, HelpMessage = 'Specifies the new reader mode for the reader.')] [ReaderMode] $Mode ) process { $parameters = @{ Server = $Server; } if ($Credential -ne $null) { $parameters.Add("Credential", $Credential) } if (($panel = Get-Panel @parameters -PanelID $PanelID) -eq $null) { Write-Error -Message ("Panel id '$($PanelID)' not found") return } if (($reader = Get-Reader @parameters -PanelID $PanelID -ReaderID $ReaderID) -eq $null) { Write-Error -Message ("Reader id '$($ReaderID)' on panel id '$($PanelID)' not found") return } $reader.SetReaderMode.Invoke($Mode) Write-Verbose -Message ("Reader '$($reader.Name)' on panel '$($panel.Name)' mode set to '$($Mode)'") } } |