Proxx.SNMP

1.0.2.0

Invoke-SnmpWalk.ps1

Function Invoke-SnmpWalk { 
    <#
        .SYNOPSIS
            Invoke-SnmpWalk returnes all object within the subtree from snmp
 
        .DESCRIPTION
            Invoke-SnmpWalk returnes all object within the subtree from snmp
 
        .PARAMETER IpAddress
            This parameter contains the node address of the agent.
 
        .PARAMETER OID
            this variable contains the OID (Object IDentifier)
             
        .PARAMETER Force
            This lets the Walk operation break out of the subtree and returns all OID's until node returns NULL
 
        .EXAMPLE
            PS C:\> | Invoke-SnmpWalk -IpAddress 192.168.1.100 -OID 1.3.6.1.2.1.1 | ft -AutoSize
 
            Node OID Type Value
            ---- --- ---- -----
            192.168.1.100 1.3.6.1.2.1.1.1.0 OctetString HP ETHERNET
            192.168.1.100 1.3.6.1.2.1.1.2.0 ObjectId 1.3.6.1.4.1.11.2.3.9.1
            192.168.1.100 1.3.6.1.2.1.1.3.0 TimeTicks 9d 0h 11m 24s 730ms
 
        .EXAMPLE
            PS C:\> "192.168.1.100", "192.168.1.104", "192.168.1.94" | Invoke-SnmpWalk -OID 1.3.6.1.2.1.1.1 | ft -AutoSize
 
            Node OID Type Value
            ---- --- ---- -----
            192.168.1.100 1.3.6.1.2.1.1.1.0 OctetString HP ETHERNET
            192.168.1.104 1.3.6.1.2.1.1.1.0 OctetString SonicWALL NSA
            192.168.1.94 1.3.6.1.2.1.1.1.0 OctetString Digi Connect
 
        .INPUTS
            System.String
 
        .LINK
            http://www.proxx.nl
 
    #>
    [CmdletBinding()]
    [OutputType([System.Object])]
    Param(
        
        [String]$Community = "public",
        [Switch]$Force,
        [Parameter(
            Mandatory=$true,
            Position=0,
            ValueFromPipeline=$true,
            ValueFromPipelineByPropertyName=$true
        )]
        [Alias("Address","ComputerName","IP","Node")]
        [String[]]$IpAddress,
        [Parameter(
            Mandatory=$false,
            Position=1
        )]
        [String]$OID="1.3.6.1",
        [int] $Port=161,
        [int] $Retry =  1,
        [int] $TimeOut = 2000,
        [ValidateSet("1","2")]
        [String]$Version="2"

    )
    Begin { 
        [SnmpSharpNet.Oid]$RootOID = $null
        if (!($Force)) { [SnmpSharpNet.Oid]$RootOID = $OID }

        $SimpleSnmp = New-Object -TypeName SnmpSharpNet.SimpleSnmp
        $SimpleSnmp.Community = $Community
        $SimpleSnmp.Retry = $Retry
        $SimpleSnmp.PeerPort = $Port
        $SimpleSnmp.Timeout = $TimeOut
        [SnmpSharpNet.SnmpVersion]$ver = [SnmpSharpNet.SnmpVersion]::Ver2
        Switch($Version) {
            1 {$Ver = [SnmpSharpNet.SnmpVersion]::Ver1 }
            2 {$Ver = [SnmpSharpNet.SnmpVersion]::Ver2 }
            default {$Ver = [SnmpSharpNet.SnmpVersion]::Ver2 }
        }
    }
    Process {
        ForEach($Node in $IpAddress) {
            $LastOID = $OID
            $SimpleSnmp.PeerIP = $Node
            $SimpleSnmp.PeerName = $Node
            While($null -ne $LastOID) {
                $Response = $simplesnmp.GetNext($Ver,$LastOID)
                if ($Response) 
                {
                    if ($Response.Count -gt 0) 
                    {
                        ForEach($var in $Response.GetEnumerator()) {
                            $Object = [PSCustomObject] @{
                                Node = $Node
                                OID = $var.Key.ToString()
                                Type = [snmpsharpnet.SnmpConstants]::GetTypeName($var.Value.Type)
                                Value = $var.Value.ToString()
                            }
                            if (!($Force)) 
                            {
                                if ($RootOID.IsRootOf($var.Key)) { $LastOID = $var.Key.ToString() } Else { $LastOID = $null;Break }
                            } 
                            Else { $LastOID = $var.Key.ToString() }
                            Write-Output -InputObject $Object
                        }
                    } 
                    Else { $LastOID = $null } #end of MIB
                } 
                Else { Write-Warning -Message "OID returned Null $LastOID"; $LastOID = $null }
            }
        }
    }
}