PoshCode Archive  Artifact Content

Artifact dec29973c8e1bce31869469756d1303f11c45d23050dee7ffd6bfa9a61b9a354:

  • File whois.ps1 — part of check-in [d19f89a628] at 2018-06-10 13:40:21 on branch trunk — A Whois script for powershell. (user: Joel Bennett size: 5307)

# encoding: ascii
# api: powershell
# title: whois
# description: A Whois script for powershell. 
# version: 0.3
# type: function
# author: Joel Bennett
# license: CC0
# function: Get-WhoIs
# x-poshcode-id: 4404
# x-derived-from-id: 4405
# x-archived: 2016-08-26T00:25:54
# x-published: 2013-08-19T04:31:00
#
# v0.3 Supports commands like:  whois domain google.com
# v0.2 Now strips command prefixes off when forwarding queries (if you want to send the prefix to the forwarded server, specify that server with the original query).
# v0.1 Now able to re-query the correct whois for .com and .org to get the full information!
#
    #.Synopsis
    #   Does a raw WHOIS query and returns the results
    #.Example
    #   whois poshcode.org
    #
    #   The simplest whois search
    #.Example
    #   whois poshcode.com
    #
    #   This example is one that forwards to a second whois server ...
    #.Example
    #   whois poshcode.com -NoForward
    #
    #   Returns the partial results you get when you don't follow forwarding to a new whois server
    #.Example
    #   whois domain google.com
    #
    #   Shows an example of sending a command as part of the search.
    #   This example does a search for an exact domain (the "domain" command works on crsnic.net for .com and .net domains)
    #
    #   The google.com domain has a lot of look-alike domains, the least offensive ones are actually Google's domains (like "GOOGLE.COM.BR"), but in general, if you want to look up the actual "google.com" you need to search for the exact domain.
    #.Example
    #   whois n 129.21.1.82 -server whois.arin.net
    #  
    #   Does an ip lookup at arin.net
    #.Notes
    # v0.3 Added documentation, examples, error handling for ip lookups, etc.
    # v0.2 Now strips command prefixes off when forwarding queries (if you want to send the prefix to the forwarded server, specify that server with the original query).
    # v0.1 Now able to re-query the correct whois for .com and .org to get the full information!
# function Get-WhoIs {
    [CmdletBinding()]
    param(
        # The query to send to WHOIS servers
        [Parameter(Position=0, ValueFromRemainingArguments=$true)]
        [string]$query,

        # A specific whois server to search
        [string]$server,

        # Disable forwarding to new whois servers
        [switch]$NoForward
    )
    end {
        $TLDs = DATA {
          @{
            ".br.com"="whois.centralnic.net"
            ".cn.com"="whois.centralnic.net"
            ".eu.org"="whois.eu.org"
            ".com"="whois.crsnic.net"
            ".net"="whois.crsnic.net"
            ".org"="whois.publicinterestregistry.net"
            ".edu"="whois.educause.net"
            ".gov"="whois.nic.gov"
          }
        }

        $EAP, $ErrorActionPreference = $ErrorActionPreference, "Stop"

        $query = $query.Trim()

        if($query -match "(?:\d{1,3}\.){3}\d{1,3}") {
            Write-Verbose "IP Lookup!"
            if($query -notmatch " ") {
                $query = "n $query"
            }
            if(!$server) { $server = "whois.arin.net" }
        } elseif(!$server) {
            $server = $TLDs.GetEnumerator() |
                Where { $query -like  ("*"+$_.name) } |
                Select -Expand Value -First 1
        }

        if(!$server) { $server = "whois.arin.net" }
        $maxRequery = 3 

        do {
            Write-Verbose "Connecting to $server"
            $client = New-Object System.Net.Sockets.TcpClient $server, 43

            try {
                $stream = $client.GetStream()

                Write-Verbose "Sending Query: $query"
                $data = [System.Text.Encoding]::Ascii.GetBytes( $query + "`r`n" )
                $stream.Write($data, 0, $data.Length)

                Write-Verbose "Reading Response:"
                $reader = New-Object System.IO.StreamReader $stream, [System.Text.Encoding]::ASCII

                $result = $reader.ReadToEnd()

                if($result -match "(?s)Whois Server:\s*(\S+)\s*") {
                    Write-Warning "Recommended WHOIS server: ${server}"
                    if(!$NoForward) {
                        Write-verbose "Non-Authoritative Results:`n${result}"
                        # cache, in case we can't get an answer at the forwarder
                        if(!$cachedResult) {
                            $cachedResult = $result
                            $cachedServer = $server
                        }
                        $server = $matches[1]
                        $query = ($query -split " ")[-1]
                        $maxRequery--
                    } else { $maxRequery = 0 }
                } else { $maxRequery = 0 }
            } finally {
                if($stream) {
                    $stream.Close()
                    $stream.Dispose()
                }
            }
        } while ($maxRequery -gt 0)

        $result

        if($cachedResult -and ($result -split "`n").count -lt 5) {
            Write-Warning "Original Result from ${cachedServer}:"
            $cachedResult
        }

        $ErrorActionPreference = $EAP
    }
# }
# Set-Alias whois Get-WhoIs