Get Remote Host data using WMI

$psScriptName = "get-wmidata.ps1"
$psScriptAuth = "Kahuna at PoshTips.com"
$psScriptDate = "11/24/2009"
##############################################################################
## Get-Wmidata.ps1 - powershell script template
##
## Original Script by Kahuna at PoshTips.com - 11/24/2009
##
## Maintenance (most recent updates at top):
## Date        By   Comments
## ----------  ---  ----------------------------------------------------------
## 11/24/2009  KPS  new script
##
##############################################################################
$scriptUsage = @"
==============================================================================
 SCRIPT  : $psScriptName
 AUTHOR  : $psScriptAuth
 VERSION : $psScriptDate
==============================================================================
 PURPOSE:
    powershell script do WMI query on remote host
 
 USAGE:
 
    Get-Wmidata [hostname(s) | filename(s)] -User=[-?|-H]
 
    - From the PowerShell command-line, invoke the script, passing any combination
      of hostnames and filenames (text file(s) containing a hostname listing
    - Any combinations and number of arguments can be used
    - if an argument is a filename:
         - each line in the file will processed as a hostname
         - any lines starting with `# will be treated as comments and ignored
    - if an argument is not a filename:
         - the argument will processed as a hostname
  FLAGS:
    -USER  = A local user account or fully-qualified (domain) user account
    -? or -H  = Display this help
 
  EXAMPLES:
              ./Get-Wmidata server1 hostlist.txt -USER=administrator
 
              ./Get-Wmidata server1 hostlist.txt -USER=poshtips\kahuna
 
==============================================================================
"@
 
Set-PSDebug -Trace 0
$script:recCount = 0
$script:usr = ""
$script:pwd = ""
$script:DOMACCT = 1
$script:LOCACCT = 2
$script:acctType = 0
$script:credentials = ""
 
function ShowUsage([string]$message=""){
    $message
    $scriptUsage
    exit
    }
 
function CurrentAcctType {
    switch ($script:acctType){
        $script:LOCACCT
            {return "LOCAL"; break;}
        $script:DOMACCT
            {return "DOMAIN"; break;}
        default
            {return "????"; break;}
        }
    }
 
function GetPassword(){
    $prompt = ([string]::format("Enter the password for {0} account ""{1}"" ",(CurrentAcctType),$script:usr))
    $script:pwd = read-host -assecurestring $prompt
    if ($script:acctType -eq $script:DOMACCT) {
        $script:credentials = new-object -typename System.Management.Automation.PSCredential -argumentlist $script:usr, $script:pwd
        }
    }
 
function GetWmiData($hostname) {
    if ($script:acctType -eq $script:LOCACCT) {
        $localusername = [string]::Format("{0}\\{1}",$hostname,$script:usr)
        $script:credentials = new-object -typename System.Management.Automation.PSCredential -argumentlist $localusername, $script:pwd
        }
    $x = gwmi win32_processor -computer $hostname -credential $script:credentials
    if ($x) {
        return([string]::Format("{0},{1},{2},{3},{4}",
          ++$script:recCount,$hostname,$x.count,$x[0].maxclockspeed,$x[0].extclock))
        }
    else {
        return (",,,")
        }
    }
 
######################################################
## MAIN
######################################################
if ($args.count -ge 2)
    {
    # Process command-line flags
    foreach ($item in $args)
        {
        if ($item -like "-USER=*"){
            $script:usr = ($item.split("=")[1])
            if ($script:usr -like "*\*"){$script:acctType = $script:DOMACCT}
            else {$script:acctType = $script:LOCACCT}
            }
        elseif ($item -like "-*")
            {
            switch ($item){
                "-H" {ShowUsage;}
                "-?" {ShowUsage;}
                default {
                    if ($item -like "-USER=*") {
                        ShowUsage "ERROR: $item is invalid!";
                        }
                    }
                }
            }
        }
    if ($script:usr -eq ""){
        ShowUsage "ERROR: -USER flag is required"
        }
 
    GetPassword
 
    # Write the CSV header
    "LN,Host,CPUCnt,CPUSpeed,ClockSpeed"
    # Process non-flag arguments
    foreach ($item in $args) {
        if ($item -notlike "-*") {
 
            # if argument is filename: process file contents
            if (test-path($item)){
                foreach ($hostname in get-content $item){
                    $hostname = $hostname.trim()
                    if ($hostname -notlike "#*") {
                        GetWmiData $hostname
                        }
                    }
                }
 
            # else treat as hostname
            else{
                GetWmiData $item
                }
            }
        }
    }
else {
    ShowUsage "ERROR: This script requires arguments"
    }