PSDataConduIT

1.0.0

Public/Get-Reader.ps1

<#
    .SYNOPSIS
    Gets a reader.

    .DESCRIPTION
    Gets all reader or a single reader if a panel id and reader id is specified. If the result return null, try the parameter "-Verbose" to get more details.
    
    .EXAMPLE
    Get-Reader
    
    Path : \\SERVER\root\OnGuard:Lnl_Reader.PanelID=1,ReaderID=1
    Credential :
    GetReaderMode : System.Management.ManagementBaseObject GetMode()
    GetHardwareStatus : System.Management.ManagementBaseObject GetHardwareStatus()
    SuperClass : Lnl_Element
    DownloadFirmware : System.Management.ManagementBaseObject DownloadFirmware()
    PanelID : 1
    Class : Lnl_Reader
    Server : SERVER
    ReaderID : 1
    ComputerName : SERVER
    TimeAttendanceType :
    SetReaderMode : System.Management.ManagementBaseObject SetMode(System.Int32 Mode)
    HostName : SERVER
    SegmentId :
    Name : Reader Name
    ControlType : 36
    SetFirstCardUnlockMode : System.Management.ManagementBaseObject SetFirstCardUnlockMode(System.Boolean Value)
    OpenDoor : System.Management.ManagementBaseObject OpenDoor()
    
    .LINK
    https://github.com/erwindevreugd/PSDataConduIT
#>
function Get-Reader
{
    [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,

        [Parameter(
            Mandatory=$false, 
            ValueFromPipelineByPropertyName=$true,
            HelpMessage='The panel id parameter')]
        [int]$PanelID = $null,

        [Parameter(
            Mandatory=$false, 
            ValueFromPipelineByPropertyName=$true,
            HelpMessage='The reader id parameter')]
        [int]$ReaderID = $null
    )

    process { 
        $query = "SELECT * FROM Lnl_Reader WHERE __CLASS='Lnl_Reader'"

        if($PanelID) {
            $query += " AND PanelID=$PanelID"
        }

        if($ReaderID) {
            $query += " AND ReaderID=$ReaderID"
        }

        LogQuery $query

        $parameters = @{
            ComputerName=$Server;
            Namespace=$Script:OnGuardNamespace;
            Query=$query
        }

        if($Credential -ne $null) {
            $parameters.Add("Credential", $Credential)
        }

        Get-WmiObject @parameters | ForEach-Object { New-Object PSObject -Property @{
                Class=$_.__CLASS;
                SuperClass=$_.__SUPERCLASS;
                Server=$_.__SERVER;
                ComputerName=$_.__SERVER;
                Path=$_.__PATH;
                Credential=$Credential;

                SegmentId=$_.SegmentId;

                Name=$_.Name;
                HostName=$_.HostName;
                PanelID=$_.PanelID;
                ReaderID=$_.ReaderID;
                ControlType=$_.ControlType;
                TimeAttendanceType=MapEnum ([TimeAttandanceType]) $_.TimeAttendanceType

                OpenDoor=$_.OpenDoor;
                SetReaderMode=$_.SetMode;
                GetReaderMode=$_.GetMode;
                SetFirstCardUnlockMode=$_.SetFirstCardUnlockMode;
                DownloadFirmware=$_.DownloadFirmware;
                GetHardwareStatus=$_.GetHardwareStatus
            }
        }
    }
}