MacAddress

2.0.0

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
#>
    [CmdletBinding()]
    param(
        [CmdletBinding()]
        [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
        [Alias('LinkLayerAddress','PhysicalAddress','ClientId','Mac','MacAddress')]
        [ValidateScript({$_ -replace '[^0-9a-f]' -match '^$|^([0-9a-f]{6})([0-9a-f]{6})?$'})]
        [AllowEmptyString()]
        [System.String[]]$InputObject
    )
    begin {}
    process {
        $InputObject | % {
            $MAC = ("$_") -replace '[^0-9a-f]' -replace '(?<=[0-9a-f]{6}).+'
            $MacAddressDatabase[$MAC.ToUpper()]
        }
    }
    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 {''}}}
    ) | ? {$_.MacAddress -ne '000000'} | % {
        $_.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

Set-Alias -Name 'Resolve-MacAddress' -Value 'Get-MacAddressVendor'