GetHostInfo – Remote Host Query Script using WMI

Param ([string]$HostName="localhost",$Option=1, $Cred=$null, [switch]$Help)
$HelpText = @'
 
 Name    : GetHostInfo.ps1
 Date    : 02/25/2011
 Author  : xb90@PoshTips.com
 Site    : http://poshtips.com
 Purpose : Use WMI to lookup various host details
 Usage
        ./GetHostInfo [-HostName ][-Option |ALL][-Cred=|][-Help]
        where
        -HostName   The host from which information will be queried
                    (using WMI) and displayed to the console
 
        -Option  Used to specify a specific Win32 Class where the value  can be one
                    or more of the following:
                                1  : Win32_OperatingSystem
                                2  : Win32_ComputerSystem
                                3  : Win32_NetworkAdapterConfiguration
                                4  : Win32_LogicalDisk
                                5  : Win32_PhysicalMemory
                                6  : Win32_Processor
                                7  : Win32_PageFileSetting
                               99  : Local Administrators Group members (using ADSI)
                                     Note: ADSI calls will ALWAYS use your logged-on
                                     credentials
                               ALL : Show all options
                           (multiple values must be comma-delimited)
        -Cred       Enables use of alternate credentials that will be applied to the WMI queries
                    if Filename is used, contents must originate from Export-Credential function
                    otherwise user will be prompted to enter credentials interactively
                    If credentials are passed via file, the Import-Credential function must be
                    loaded into memory and setup with the alias "icred"
        -Help       produces this help output
'@
$MaintNotes = @'
 Maintenance Log
 Date       By   Updates
 ---------- ---- ---------------------------------------------------------------------
 03/25/2011 xb90 New Script
'@
 
if ($help){
    $HelpText;
    exit
    }
 
if ($cred){
    if (test-path($Cred)){
    $cred = icred -path $Cred
    }
    else{
        write-host "Please enter your user credentials" -fore red
        $usr = read-host "Enter user account; e.g. `"mydomain\myname`" "
        $pwd = read-host "Password for $usr " -assecurestring
        $cred = new-object system.management.automation.pscredential($usr,$pwd)
        }
    }
 
function HasVal{
    param($array,$item)
    foreach ($i in $array){
        if ($i -eq "all"){
            $true
            return
            }
        if ($i -eq $item){
            $true
            return
            }
        }
    $false
    }
 
function BldQry {
    param ([string]$CmdStr)
    if ($cred){
        "$cmdStr -credential `$cred"
        }
    else{
        $cmdStr
        }
    }
 
function WMIDateStringToDate($Bootup){
    [System.Management.ManagementDateTimeconverter]::ToDateTime($Bootup)
    }
 
function WriteHeader{
    param ($hn, $cl, $op)
    write-host " $hn " -nonewline -back yellow -fore red
    write-host " $cl (option $op) ".padright(80-$($hn.length+2)) -back darkgreen -fore white
    }
 
if (HasVal $Option 1){
    WriteHeader $hostname "Win32_OperatingSystem"  1
    $x = BldQry "gwmi win32_OperatingSystem -computer `$hostname" | iex
    $Uptime = (WMIDateStringToDate($x.localdatetime)) - (WMIDateStringToDate($x.LastBootUpTime))
    $x | fl Caption,Version,csdversion,csname,SystemDirectory,Organization,RegisteredUser,numberofusers, `
        @{Label="TotalVisibleMemorySize";   Expression={"{0:N2} GB" -f ($($_.TotalVisibleMemorySize)/1MB)}}, `
        @{Label="TotalVirtualMemorySize";   Expression={"{0:N2} GB" -f ($($_.TotalVirtualMemorySize)/1MB)}}, `
        @{Label="InstallDate";              Expression={"{0}" -f (WMIDateStringToDate(($_.InstallDate)))}}, `
        @{Label="LastBootUpTime";           Expression={"{0}" -f (WMIDateStringToDate(($_.LastBootUpTime)))}}, `
        @{Label="LocalDateTime";            Expression={"{0}" -f (WMIDateStringToDate(($_.LocalDateTime)))}}, `
        @{Label="CurrentTimeZone";          Expression={"{0} (offset in minutes from GMT)" -f ($_.CurrentTimeZone)}}, `
        @{Label="SystemUptime";             Expression={"{0} days {1} hours {2} minutes" -f ($uptime.days,$uptime.hours,$uptime.minutes)}}
    }
 
if (HasVal $Option 2){
    WriteHeader $hostname "Win32_ComputerSystem"  2
    $x = BldQry "gwmi Win32_ComputerSystem -computer `$hostname" | iex
    $x | fl Caption,CSName,Description,Version,DNSHostName,Domain,manufacturer,model,numberofprocessors,systemtype
    }
 
if (HasVal $Option 3){
    WriteHeader $hostname "Win32_NetworkAdapter `& Win32_NetworkAdapterConfiguration"  3
    # two step lookup:
    #   (1) get the active adapter(s)
    #   (2) lookup configuration for each adapter
 
    #if (!$cred){$adapters = gwmi -query "SELECT * FROM Win32_NetworkAdapter WHERE NetConnectionStatus=2" -computer $hostname}
    #else {$adapters = gwmi -query "SELECT * FROM Win32_NetworkAdapter WHERE NetConnectionStatus=2" -computer $hostname -credential $cred}
 
    $adapters = BldQry "gwmi -query `"SELECT * FROM Win32_NetworkAdapter WHERE NetConnectionStatus=2`" -computer $hostname" | iex
 
    Foreach ($adapter in $adapters){
        Write-host "  Active Adapter Found (win32_NetworkAdapter):".PadRight(60," ")  -backgroundcolor cyan -foregroundcolor black
        $adapter | fl DeviceId,AdapterType,Description,NetConnectionId,ProductName,ServiceName
        $qry = [string]::format("SELECT * FROM Win32_NetworkAdapterConfiguration where IPEnabled='True' and index={0}", $adapter.DeviceId)
        $x = BldQry "gwmi -query `$qry -computer `$hostname" | iex
        foreach ($entry in $x){
            Write-host "  Configuration (win32_NetworkAdapterConfiguration):".PadRight(60," ")  -backgroundcolor cyan -foregroundcolor black
            $entry | fl Index,DNSHostName,Caption,Description,IPAddress,DHCPEnabled,DefaultIPGateway,DNSServerSearchOrder,WINSPrimaryServer,WINSSecondaryServer,macaddress | out-default
            "DNSDomainSuffixSearchOrder:" | out-default
            "===========================" | out-default
            $suffix_cnt = 0
            foreach ($suffix in $entry.DNSDomainSuffixSearchOrder){
                $suffix_cnt += 1
                "    $suffix_cnt : $suffix" | out-default
                }
            }
        ""
        }
    }
 
if (HasVal $Option 4){
    WriteHeader $hostname "Win32_LogicalDisk"  4
    $wq = BldQry "gwmi -class win32_logicaldisk -computer $hostname"
    $x = $wq | iex
    $x | format-table -autosize `
        DeviceId, `
                VolumeName, Description, DriveType, `
                @{Label="FreeSpace(GB)";  Alignment="right";  Expression={"{0:N2}" -f ($_.FreeSpace/1GB)}}, `
                @{Label="Size(GB)";       Alignment="right";  Expression={"{0:N2}" -f ($_.size/1GB)}} `
                | out-default
    }
 
if (HasVal $Option 5){
    WriteHeader $hostname "Win32_PhysicalMemory"  5
    $x = BldQry "gwmi -class Win32_PhysicalMemory -computer `$hostname" | iex
    $x | format-table -autosize `
                DeviceLocator, `
                @{Label="Capacity";    Alignment="right"; Expression={"{0:N2} GB" -f ($_.Capacity/1GB)}}, `
                @{Label="DataWidth  "; Alignment="right"; Expression={"{0} Bits"  -f ($_.datawidth)}}, `
                @{Label="Speed";       Alignment="right"; Expression={"  {0} MHz" -f ($_.speed)}} `
                | out-default
    }
 
if (HasVal $Option 6){
    WriteHeader $hostname "Win32_Processor"  6
    $x = BldQry "gwmi -class Win32_Processor -computer `$hostname" | iex
    $x | format-table `
        @{Label="`nDevice`nId";          Alignment="left";  width=6;  Expression={"{0}"     -f ($_.DeviceId)}}, `
        @{Label="`nSocket`nDesignation"; Alignment="left";  width=15; Expression={"{0}"     -f ($_.SocketDesignation)}}, `
        @{Label="`n`nCaption";           Alignment="left";  width=32; Expression={"{0}"     -f ($_.Caption)}}, `
        @{Label="Max`nClock`nSpeed";     Alignment="right"; width=9;  Expression={"{0} MHz" -f ($_.MaxClockSpeed)}}, `
        @{Label="`nExt`nClock";          Alignment="right"; width=6;  Expression={"{0}"     -f ($_.ExtClock)}}, `
        @{Label="`n`nFamily";            Alignment="right"; width=7;  Expression={"{0}"     -f ($_.Family)}}, `
        @{Label="L2`nCache`nSize";       Alignment="right"; width=6;  Expression={"{0}"     -f ($_.L2CacheSize)}}, `
        @{Label="`nAddress`nWidth";      Alignment="right"; width=8;  Expression={"{0} bit" -f ($_.AddressWidth)}}, `
        @{Label="`n`nName";              Alignment="left";  width=36; Expression={"{0}"     -f ([regex]::replace($_.Name,"\s+"," "))}}, `
        @{Label="`n`nManufacturer";      Alignment="left";  width=18; Expression={"{0}"     -f ($_.Manufacturer)}} `
        | out-default
    }
 
if (HasVal $Option 7){
    WriteHeader $hostname "Win32_PageFileSetting"  7
    $x = BldQry "gwmi Win32_PageFileSetting -computer `$hostname" | iex
    $x | ft name,InitialSize,MaximumSize -auto | out-default
    }
 
if (HasVal $Option 99){
    WriteHeader $hostname "Local Administrators Group"  99
    $computer = [ADSI]("WinNT://" + $hostname + ",computer")
    $Group = $computer.psbase.children.find("Administrators")
    $members= $Group.psbase.invoke("Members") | %{$_.GetType().InvokeMember("Name", 'GetProperty', $null, $_, $null)}
    ForEach($user in $members){
        $user | out-default
        }
    }