Get-WMIInfo.ps1

# =====================================================================================
# 
# Microsoft PowerShell Source File -- Created with SAPIEN Technologies PrimalScript 2009
# 
# NAME: Get-WMIInfo.ps1
# 
# AUTHOR: Jeffery Hicks , SAPIEN Technologies
# DATE  : 6/11/2009
# 
# COMMENT: Discover information about a given WMI class such as
# a help description, its methods and properties.
#
# The script will write a custom object with WMI information
# to the pipeline, or you can use -report to display an expanded 
# view of the class' methods and properties.

# This script cannot use alternate credentials to connect to remote
# computers. You must run it under an account that has admin
# privileges on the remote computer.

# DISCLAIMER AND WARNING:
# 	THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
# 	KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
# 	IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
#   TEST THOROUGHLY IN A NON-PRODUCTION ENVIRONMENT. IF YOU DON'T KNOW WHAT THIS
#   SCRIPT WILL DO...DO NOT RUN IT!
# 
# ====================================================================================

Param([string]$Class="Win32_OperatingSystem",
      [string]$computername=$env:computername,
      [string]$namespace="ROOT\CIMV2",
      [switch]$report
     )

#turn off the error pipeline
$errorActionPreference="SilentlyContinue"     

Trap [System.Management.Automation.PSInvalidCastException] {
#this traps errors attempting to retrieve the WMI class
    Write-Warning ("There was an error trying to get the {0}`
         class from the {1} namespace on {2}.` 
         {3}" -f $Class.ToUpper(),$namespace.ToUpper(),`
         $computername.ToUpper(),$($_.exception.message))
    Return
}

Trap {
#this will trap all other errors and let the script continue
  Continue
}

[WMICLASS]$wmi="\\{0}\{1}:{2}" -f $computername,$namespace,$Class

#set object to use amended qualifiers
$wmi.psbase.options.UseAmendedQualifiers=$true
 
#define an array for property names
$properties=@()
$wmi.psbase.properties | foreach {
    #add each property name to $properties
    $properties+=$_.name
  }

#define an array for method names
$methods=@()
$wmi.psbase.methods | foreach {
    #add each method name to $methods
    $methods+=$_.name
  }
#if no methods found set a new value
if ($methods.count -eq 0) {
    $methods="None"
}
  
#get class description
$description=$wmi.psbase.GetQualifierValue("description")

#if no description then define a new value
if (!$description) {
  $description= "No Description Found"
}

#create an empty custom object
$obj=New-Object PSObject
  
#assign properties
$obj | Add-Member -MemberType Noteproperty -name "Computername"
   -value $computername.ToUpper()
$obj | Add-Member -MemberType Noteproperty -name "Path" -value $wmi.path.path.ToUpper()
$obj | Add-Member -MemberType Noteproperty -name "Namespace" -value $namespace.ToUpper()
$obj | Add-Member -MemberType Noteproperty -name "WMIClass" -value $class.ToUpper()
$obj | Add-Member -MemberType Noteproperty -name "Description" -value $description
$obj | Add-Member -MemberType Noteproperty -name "Properties" -value $properties
$obj | Add-Member -MemberType Noteproperty -name "Methods" -value $methods

#if -report was specified display a formatted report
if ($report) {
    $obj | Format-List Path,WMIClass,Description,`
    @{label="Properties";Expression={$_.properties | Out-String}},`
    @{label="Methods";Expression={$_.Methods | Out-String}} 
} 
else {
    #otherwise, just write the object
    write $obj
}

#end of script

Featured

  • Exploring OCR, a New Way To Get Data into Excel

    Microsoft recently added a new optical character recognition feature to Excel that lets users import data from a photograph taken from a smartphone. Here's how to use it.

  • Microsoft Authenticator App To Get Real-Time Phishing Protections

    Microsoft is working on adding capabilities to its Microsoft Authenticator app to help defeat security breaches enabled by advanced attack techniques, including phishing and man-in-the-middle methods.

  • A Quicker Way To Create Hyper-V Inventory Reports

    If you need to generate Hyper-V inventory reports but don't want the hassle of writing your own custom PowerShell script, here is a shortcut.

  • Microsoft Previews New Azure Active Directory Roles and Bulk Management Capability

    Microsoft this week announced a couple of noteworthy previews of new capabilities for IT pros using the Azure Active Directory identity and access management service.

comments powered by Disqus

Office 365 Watch

Sign up for our newsletter.

Terms and Privacy Policy consent

I agree to this site's Privacy Policy.