Public/Get-WHOIS.ps1
|
<#
.SYNOPSIS Gets WHOIS information for a domain name by querying the WHOIS server for the domain name. .DESCRIPTION Queries the WHOIS server for a domain name and returns summary information by default, the Registrar, Creation Date, Expiration Date, and DNS Name Servers. The WHOIS server is determined by the TLD of the domain name, unless specified. .NOTES Author: Robert D. Biddle Date: 2023-10-18 Get-WHOIS - PowerShell Module to lookup WHOIS information for a domain name. Copyright (C) 2023 Robert D. Biddle This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. .LINK https://github.com/RobBiddle/Get-WHOIS/ .EXAMPLE Get-WHOIS -DomainName "whois-servers.net" This will return the following information: DomainName : whois-servers.net CreationDate : 1999-03-31 12:00:00 AM DaysUntilExpiration : 162 ExpirationDate : 2024-03-31 12:00:00 AM NameServers : {UDNS1.ULTRADNS.NET, UDNS2.ULTRADNS.NET} Registrar : TucowsDomainsInc. WhoisServerName : whois.verisign-grs.com .EXAMPLE Get-WHOIS -DomainName "whois-servers.net" -OutputFormat "detail" This will return the full WHOIS response for the domain name. .PARAMETER DomainName The domain name to query in FQDN format. .PARAMETER OutputFormat The output format for the WHOIS information. Valid values are "summary" and "detail". "summary" is the default value and returns a PSCustomObject with Properties: DomainName, CreationDate, DaysUntilExpiration, ExpirationDate, NameServers, Registrar, WhoisServerName "detail" returns the full WHOIS response. .PARAMETER whoisServer The FQDN of a WHOIS server to query for the domain name. If not specified, the WHOIS server is determined by the TLD of the domain name. .PARAMETER whoisPort The port to use when querying the WHOIS server. If not specified, the default port of 43 is used. .OUTPUTS Selected.System.Management.Automation.PSCustomObject #> function Get-WHOIS { [CmdletBinding()] param ( [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [ValidateScript({ if ($_ -match "^\b((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}\b$") { $true } else { throw "Invalid FQDN format." } })] [string]$DomainName, [Parameter(Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [ValidateSet("summary", "detail")] [string]$OutputFormat = "summary", [Parameter(Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string]$whoisServer, [Parameter(Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [int]$whoisPort = 43 ) begin { # Import the Find-WhoisServer function . "$PSScriptRoot\..\Private\Find-WhoisServer.ps1" } process { if (-NOT $whoisServer) { # Set the appropriate WHOIS server and port based on the TLD of the domain name $whoisDnsServers = Find-WhoisServer -DomainName $DomainName $wServer = $whoisDnsServers | Where-Object IP4Address | Select-Object -first 1 } else { $wServer = Resolve-DnsName $whoisServer | Where-Object IP4Address | Select-Object -first 1 } # Get the IP address of the WHOIS server $wServerIP = ($wServer | Where-Object IP4Address).IP4Address | Select-Object -first 1 # Get the name of the WHOIS server $wServerName = ($wServer | Where-Object IP4Address | Select-Object -first 1).Name # Query the WHOIS server for the domain name $whoisQuery = $DomainName + "`r`n" $whoisSocket = New-Object System.Net.Sockets.TcpClient($wServerIP, $whoisPort) $whoisStream = $whoisSocket.GetStream() $whoisWriter = New-Object System.IO.StreamWriter($whoisStream) $whoisWriter.WriteLine($whoisQuery) $whoisWriter.Flush() $whoisReader = New-Object System.IO.StreamReader($whoisStream) $whoisResponse = $whoisReader.ReadToEnd() $whoisReader.Close() $whoisWriter.Close() $whoisSocket.Close() if ($OutputFormat -eq "summary") { # Remove blank lines $whoisResponse = $whoisResponse -replace "`r`n`r`n", "`r`n" # Split whoisResponse into lines and parse the WHOIS response for the basic information $whoisResponse = $whoisResponse -split "`r`n" $Registrar = $whoisResponse | Select-String -Pattern "Registrar: " | Select-Object -First 1 $Registrar = $registrar -replace "Registrar:", "" $Registrar = $registrar -replace "[\s-[\r\n]]+", "" $CreationDate = $whoisResponse | Select-String -Pattern "Creation Date: " | Select-Object -First 1 $CreationDate = $CreationDate -replace "Creation Date:", "" $CreationDate = $(if($CreationDate) {Get-Date $CreationDate}) $ExpirationDate = $whoisResponse | Select-String -Pattern "Registry Expiry Date: " | Select-Object -First 1 $ExpirationDate = $ExpirationDate -replace "Registry Expiry Date:", "" $ExpirationDate = $(if($ExpirationDate) {Get-Date $ExpirationDate}) $DaysUntilExpiration = $(if($ExpirationDate) {(New-TimeSpan -Start (Get-Date) -End (Get-Date $ExpirationDate)).Days}) $NameServers = $whoisResponse | Select-String -Pattern "Name Server: " | Select-Object -Unique $NameServers = $NameServers -replace "Name Server:", "" $NameServers = $NameServers -replace "[\s-[\r\n]]+", "" $whoisSummary = @{ DomainName = $DomainName Registrar = $Registrar CreationDate = $CreationDate DaysUntilExpiration = $DaysUntilExpiration ExpirationDate = $ExpirationDate NameServers = @($NameServers) WhoisServerName = $wServerName } # Return the basic information New-Object -TypeName PSCustomObject -Property $whoisSummary | Select-Object DomainName, CreationDate, DaysUntilExpiration, ExpirationDate, NameServers, Registrar, WhoisServerName } else { $whoisResponse } } } |