Nuttercode-SNMP

1.0

Nuttercode-SNMP.psm1

########################################################################################################################
#
# Author: Johannes B. Latzel
#
# Version: 2019.05.30
#
########################################################################################################################
#
# Description:
#
# applies the methods of the olePrn.OleSNMP Com-Object and wraps them into 4 easy to use CMDlets:
# Get-Snmp, Get-SnmpValue, Get-SnmpWalk, Get-SnmpWalkValue
# (uses: https://docs.microsoft.com/en-us/windows-hardware/drivers/print/isnmp-methods)
#
########################################################################################################################
#
# Dependencies:
#
# Powershell 5.0 (or higher)
#
########################################################################################################################

class SNMPResult {
    [string]$Oid
    [string]$Value
    SNMPResult([string]$Oid,[string]$Value) {
        $this.Oid = $Oid
        $this.Value = $Value
    }
}

function Init-Snmp([string]$Hostname, [string]$Community = "public") {
    $comSnmp = New-Object -ComObject olePrn.OleSNMP
    $comSnmp.Open($Hostname, $Community)
    return $comSnmp
}

function Prepare-Oid([string]$Oid) {
    if( -not $Oid.StartsWith(".") ) {
        $Oid = ".$Oid"
    }
    return $Oid.Trim()
}

function Get-SnmpWalk() {
    [cmdletbinding()] Param(
        [Parameter(Position=0, Mandatory=$true)][string]$Hostname,
        [Parameter(Position=1, Mandatory=$true)][string]$Oid,
        [Parameter(Position=2, Mandatory=$false)][string]$Community = "public"
    )
    try { 
        $comSnmp = Init-Snmp -Hostname $Hostname -Community $Community
        $result = $comSnmp.GetTree((Prepare-Oid -Oid $Oid))
        $comSnmp.Close()
    }
    catch {
        $result = @()
    }
    for($a = 0; $a -lt $result.Count / 2; $a++) {
        [SNMPResult]::new(".$($comSnmp.OIDFromString($($result[0, $a])) -join ".")", "$($result[1, $a])")
    }
}
export-modulemember -function Get-SNMPWalk


function Get-SnmpWalkValue() {
    [cmdletbinding()] Param(
        [Parameter(Position=0, Mandatory=$true)][string]$Hostname,
        [Parameter(Position=1, Mandatory=$true)][string]$Oid,
        [Parameter(Position=2, Mandatory=$false)][string]$Community = "public"
    )
    Get-SNMPWalk -Hostname $Hostname -Oid $Oid -Community $Community | % {
        if( $_ -ne $null ) {
            $_.Value
        }
        else {
            ""
        }
    }
}
export-modulemember -function Get-SNMPWalkValue


function Get-Snmp() {
    [cmdletbinding()] Param(
        [Parameter(Position=0, Mandatory=$true)][string]$Hostname,
        [Parameter(Position=1, Mandatory=$true)][string]$Oid,
        [Parameter(Position=2, Mandatory=$false)][string]$Community = "public"
    )
    try {
        $comSnmp = Init-Snmp -Hostname $Hostname -Community $Community
        $result = $comSnmp.Get((Prepare-Oid -Oid $Oid))
        $comSnmp.Close()
    }
    catch {
        $result = ""
    }
    [SNMPResult]::new($Oid, $result)
}
export-modulemember -function Get-SNMP


function Get-SnmpValue() {
    [cmdletbinding()] Param(
        [Parameter(Position=0, Mandatory=$true)][string]$Hostname,
        [Parameter(Position=1, Mandatory=$true)][string]$Oid,
        [Parameter(Position=2, Mandatory=$false)][string]$Community = "public"
    )
    $result = Get-SNMP -Hostname $Hostname -Oid $Oid -Community $Community
    if( ($result -ne $null) -and ($result.Value -ne $null) ) {
        return $result.Value
    }
    return ""
}
export-modulemember -function Get-SNMPValue