MacAddress

1.2.1

MacAddress.psm1

[string]$Uri = 'http://standards-oui.ieee.org/oui.txt'
[System.Collections.Generic.Dictionary[System.String,System.Object]]$MacAddressDatabase = @{}

[string]$OuiFilePath =  Join-Path -Path $PSScriptRoot -ChildPath 'oui.txt'
[string]$CsvFilePath =  Join-Path -Path $PSScriptRoot -ChildPath 'oui.csv'

$ProgressPreference_ = $ProgressPreference
    
Update-TypeData -Force -TypeName 'MacAddress' -MemberType ScriptMethod -MemberName ToString -Value {$this.Vendor}

Function Get-MacAddressVendor {
<#
    .EXAMPLE
    Get-NetNeighbor -IPAddress 192* | Get-MacAddressVendor
    HTC Corporation
    Microsoft Corporation
    D-Link International
    ZyXEL Communications Corporation
    .EXAMPLE
    Get-NetNeighbor -IPAddress 192* | Get-MacAddressVendor -PassThru | Select-Object IPAddress,LinkLayerAddress,Vendor
    IPAddress LinkLayerAddress Vendor
    --------- ---------------- ------
    192.168.0.255 ffffffffffff
    192.168.0.106 1c659d7cb596 Liteon Technology Corporation
    192.168.0.101 000000000000
    192.168.0.92 f079606a3eda Apple, Inc.
    192.168.0.51 00155d003200 Microsoft Corporation
    192.168.0.1 588bf34b5e10 ZyXEL Communications Corporation
#>
    param(
        [Parameter(Mandatory=$true,ValueFromPipeline=$true)]$InputObject,
        [switch]$PassThru
    )
    Begin{
        Function Resolve-MacAddress {
        param(
            [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)][alias('LinkLayerAddress','PhysicalAddress','ClientId')][AllowEmptyString()][string[]]$MAC
        )
        Begin {}
        Process {
            $MAC | % {
                $MAC6 = [string]''
                $MAC6 = $_.ToUpper() -replace '[^\w\d]' -replace '(......)(.+)','$1'
                    if( ($MAC6 -match '^[\d\w]{6}$') -and  ($MAC6 -notmatch '^(0){6}$') -and ($MAC6 -notmatch '^(f){6}$')) {
                        $MacAddressDatabase[$MAC6]
                    }
            }
        }
        End {}
        }
    }
    Process{
        $InputObject | % {
            if (![bool]$PassThru) {
                $($_ | Resolve-MacAddress)
            } else {
                Add-Member -InputObject $_ -MemberType NoteProperty -Name 'Vendor' -Value $($_ | Resolve-MacAddress) -Force -PassThru
            }
        }
    }
    End{}
}

Function Update-MacAddressDatabase {
    [CmdletBinding()]
    param()

    $ProgressPreference = 'SilentlyContinue'
    
    Write-Verbose -Message "Downloading from $Uri" -Verbose
    
    try {
        Invoke-WebRequest -Uri $Uri -OutFile $OuiFilePath
    } catch {
        throw $_.Exception
    }
    
    Write-Verbose -Message "Parsing raw file to $OuiFilePath" -Verbose
    
    Select-String -Path $OuiFilePath -Pattern '^(?<MAC>[0-9a-fA-F]{6})\s+\(base\s+16\)\s+(?<VEN>.+)' -Context 3 | Select-Object -Property @(
        ,@{Name = 'MacAddress'; Expression = {$_.Matches.Captures.Groups['MAC'].Value.ToUpper()}}
        ,@{Name = 'Vendor'; Expression = {$_.Matches.Captures.Groups['VEN'].Value}}
        ,'Context'
    ) | Select-Object -Property @(
        ,'MacAddress'
        ,'Vendor'
        ,@{Name = 'Country'; Expression = {if ($_.Vendor -ne 'Private') {$_.Context.PostContext[2].Trim()} else {''}}}
        ,@{Name = 'Address'; Expression = {if ($_.Vendor -ne 'Private') {$_.Context.PostContext[0].Trim()} else {''}}}
        ,@{Name = 'POBox'; Expression = {if ($_.Vendor -ne 'Private') {$_.Context.PostContext[1].Trim()} else {''}}}
    ) | % {
        $_.PSTypeNames.Add('MacAddress')
        $MacAddressDatabase[$_.MacAddress] = $_
    }
    
    Write-Verbose -Message "Saving $($MacAddressDatabase.Count) records to $CsvFilePath" -Verbose
    
    $MacAddressDatabase.Values | Export-Csv -Delimiter ';' -NoTypeInformation -Path $CsvFilePath
    
    $ProgressPreference = $ProgressPreference_
}

Function Import_MacAddressDatabase {
    [CmdletBinding()]
    param()
    Import-Csv -Path $CsvFilePath -Delimiter ';' | % {
        $_.PSTypeNames.Add('MacAddress')
        $MacAddressDatabase[$_.MacAddress] = $_
    }
}

Import_MacAddressDatabase