Functions/Resolve-FQDN.ps1
|
Function Resolve-FQDN { <# .SYNOPSIS Resolves a hostname or IPv4 address to a fully qualified domain name .DESCRIPTION Resolves a hostname or IPv4 address to a fully qualified domain name .PARAMETER Computer Either the hostname or IPv4 address of the computer you want resolved to FQDN .EXAMPLE Resolve-FQDN -Computer $env:computername Display the FQDN of this computer .EXAMPLE Resolve-FQDN -Computer "10.28.99.101" Display the FQDN of the computer whose IPv4 address is 10.28.99.101 .EXAMPLE Resolve-FQDN . Display the FQDN of this computer .EXAMPLE "10.28.99.101" | Resolve-FQDN Display the FQDN of the computer whose IPv4 address is 10.28.99.101 .EXAMPLE $DomainController = (($env:logonserver).Substring(2)) Resolve-FQDN $DomainController Display the FQDN of the Active Directory Domain Controller that you authenticated against when you logged onto Windows. .EXAMPLE PS C:\> Resolve-FQDN -Computer "NonExistentPC" The computer "NonExistentPC" does not have an entry in DNS so the function will return the value $False .NOTES Attempting to resolve a FQDN for a system that does not have an entry in DNS will be slow, and will take 1-5 seconds to return a value of $False #> [CmdletBinding()] Param ( [parameter(ValueFromPipeLine,HelpMessage='Add help message for user',ValueFromPipeLineByPropertyName,Mandatory)] [Alias('host')] [string] $Computer ) Begin { Write-Verbose -Message "Starting $($MyInvocation.Mycommand)" } Process { if ($Computer -eq '.') { $Computer = $env:computername } Try { $FQDN = [System.Net.Dns]::GetHostEntry($Computer).HostName write-output -InputObject $FQDN } Catch { Write-Output -InputObject $False } } End { Write-Verbose -Message "Ending $($MyInvocation.Mycommand)" } } #EndFunction Resolve-FQDN |